Skip to main content
POST
/
v1
/
agent-testing
/
tornado
/
start
Start Tornado Session
curl --request POST \
  --url https://api.bland.ai/v1/agent-testing/tornado/start \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "pathway_id": "<string>",
  "persona_id": "<string>",
  "scenario_ids": {},
  "version_number": 123,
  "max_iterations": 123,
  "timeout_ms": 123
}
'
{
  "session_id": "e1f2a3b4-5678-9cde-f012-3456789abcde",
  "status": "RUNNING",
  "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
  "max_iterations": 5,
  "timeout_ms": 900000,
  "created_at": "2026-04-14T10:15:00.000Z"
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
pathway_id
string
required
The pathway to fix.
​
persona_id
string
The persona ID.
​
scenario_ids
array of strings
Specific scenarios to test. If omitted, runs all enabled scenarios for the pathway. Maximum 50 scenarios.
​
version_number
integer
Pathway version to start from.
​
max_iterations
integer
Maximum fix iterations. Default 5.
​
timeout_ms
integer
Timeout in milliseconds. Default 900000 (15 minutes).
Only one tornado session can be active per pathway. Returns 409 Conflict if a session is already running.

​
Response

​
session_id
string
The unique identifier for the tornado session.
​
status
string
The initial status of the session. Will be RUNNING upon creation.
​
pathway_id
string
The pathway being tested and fixed.
​
max_iterations
integer
The maximum number of fix iterations configured.
​
timeout_ms
integer
The timeout configured for this session in milliseconds.
​
created_at
string
ISO 8601 timestamp of when the session was created.
{
  "session_id": "e1f2a3b4-5678-9cde-f012-3456789abcde",
  "status": "RUNNING",
  "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
  "max_iterations": 5,
  "timeout_ms": 900000,
  "created_at": "2026-04-14T10:15:00.000Z"
}