Cost & ROI Estimation

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

List comparable deployments

Anonymized deployments from across the org. Team names are rounded up
to the business-unit level so no individual deployment can be traced
back.

get

Query Parameters

business_unitstringrequired

Example:Customer Success

categorystringrequired

Allowed values:copilotautonomous-agentworkflow-agentrag-assistantvoice-agent

integration_countnumber(float)

Reference size; matches are searched within a ±20 percent corridor.

Example:6

period_monthsinteger

Default:12

>= 3<= 36

Response

application/json

Comparable deployments

dataarray[object]
Show Child Parameters
statsobject
Show Child Parameters
get/comparables
 
application/json