Skip to main content
POST
AI Simulation needs an active Pro or Business plan. On another plan, every simulation endpoint returns 403 POLICY_DENY.
Start a simulation. AI callers phone your agent and each call is judged. Use mode: "generate" to let the agent’s model write the stories, or mode: "custom" to send your own story.
Simulated calls spend real credits. A request without max_credits and estimated_credits_per_call is refused. One request may queue at most 1,000 calls (stories × repeats). A workspace can have 3 active runs at once.
The run starts at once. Read it with Get simulation. For the full flow, see Reliability and simulation.

Request

Headers

string
required
Bearer token with your API key (scope agents)
string
required
application/json

Path

string
required
The agent id (UUID). The agent must be in your workspace and saved at least once

Body

string
required
generate or custom
integer
default:"12"
generate only. 9 to 50. How many stories the agent’s model writes. This makes one paid model request before the run is queued
integer
default:"8000"
generate only. 8000, 16000 or 24000
object
required
custom only. One story: name, persona, steps, checks, entities and tool_answers. steps and checks are checked by the voice service. Each check item is { "check": { "check": "contains", "arg": "balance" }, "must_pass": true }. The story must answer every tool of the agent in tool_answers, or the start answers 400 with field: "tool_answers". A mistake returns 400 with the field name. See Write a story
number
required
The credit ceiling. The run stops when it reaches this many credits and ends in the state stopped_budget with a partial report. Must be more than 0
number
required
Your estimate of the credits one simulated call uses. Must be more than 0. 60db checks your balance for the lower of max_credits and estimated_credits_per_call × the number of calls before anything is queued
integer
default:"1"
1 to 100. How many times each story runs
string
default:"manual"
manual, or ci. ci is only for API keys. Dashboard sessions that send ci get 400
integer
1 to 20. How many simulated calls run at once
integer
At least 1. Stop after this many calls
integer
At least 1. Stop after this many minutes of calls
string
A run to compare with

Response

201 Created.
run_id is 60db’s ID. Use it in all other simulation routes. scenarios is only in generate mode.

Errors

Example