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
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
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
Authentication
Body
{
"agent_id": "agt_8f2c1a",
"reason": "production_rollout"
}
application/json
Retrieve an estimate
get
Path Parameters
estimateIdstringrequired
Example:est_3e18
Response
application/json
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}
Authentication
Path Parameters
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
Response
application/json
Comparable deployments
dataarray[object]
Show Child Parameters
statsobject
Show Child Parameters
get/comparables
Authentication
Query Parameters
application/json