Search
K
Cost & ROI Estimation

Cost & ROI Estimation

1.0.0OAS 3.0

Produces an initial cost indication for an agent deployment - based on
comparable deployments across the org, the internal usage index and the
agent’s own characteristics.

The result is an indication, not a formal cost model prepared under a
certified FinOps methodology. Every response therefore carries a range
and a note on the underlying data basis, so it stays clear in
conversations with budget owners how reliable the figure is.

API Base URL
  • Server 1:https://api.nexora.example/v1

    Production

  • Server 2:https://sandbox.api.nexora.example/v1

    Sandbox

Security
apiKey (apiKey)

Every call carries an API key in the apikey header. You generate the
key in the Nexora AI portal under “My Apps”; it’s shown exactly once.

Each key has the scopes it’s allowed to use attached to it. If one is
missing, the API responds with 403 and code: "scope_missing"; the
missing scope is in details[].field.

Additional Information
Contact API Support - Nexora AI (api-support@nexora.example)

For demonstration purposes only License

Estimates

Request an estimate

Starts a cost/ROI estimate. Either for an existing agent via
agent_id or for freeform input via characteristics - for example
during an initial scoping conversation, before an agent deployment
record exists.

post

Body

application/json

EstimateRequest

Exactly one of agent_id or characteristics must be set.

agent_idstring

Example:agt_8f2c1a

reasonstringrequired

Allowed values:initial_scopingproduction_rolloutbudget_planningrenewaldecommission

Example:production_rollout

characteristicsobject

Freeform agent description, used when no agent deployment record exists.

Show Child Parameters

Response

application/json

Estimate created

CostEstimateResult

idstring

Example:est_3e18

agent_idstring | null

Example:agt_8f2c1a

reasonstring

Allowed values:initial_scopingproduction_rolloutbudget_planningrenewaldecommission

Example:production_rollout

estimated_monthly_cost_usdinteger

Example:6380

range_usdobject
Show Child Parameters
cost_per_1k_requests_usdnumber(float)

Example:25.5

confidencestring

How reliable the indication is.

Allowed values:lowmediumhigh

basisobject

What the indication was derived from.

Show Child Parameters
created_atstring(date-time)

Example:2026-08-20T09:52:00Z

post/estimates

Body

{ "agent_id": "agt_8f2c1a", "reason": "production_rollout" }
 
application/json

Retrieve an estimate

get

Path Parameters

estimateIdstringrequired

Example:est_3e18

Response

application/json

Estimate

CostEstimateResult

idstring

Example:est_3e18

agent_idstring | null

Example:agt_8f2c1a

reasonstring

Allowed values:initial_scopingproduction_rolloutbudget_planningrenewaldecommission

Example:production_rollout

estimated_monthly_cost_usdinteger

Example:6380

range_usdobject
Show Child Parameters
cost_per_1k_requests_usdnumber(float)

Example:25.5

confidencestring

How reliable the indication is.

Allowed values:lowmediumhigh

basisobject

What the indication was derived from.

Show Child Parameters
created_atstring(date-time)

Example:2026-08-20T09:52:00Z

get/estimates/{estimateId}
 
application/json

Comparables