Skip to main content
POST
/
test_framework
/
v1
/
scenarios
/
run_scenarios_with_websockets
Run evaluators against per-scenario websocket URLs (bulk)
curl --request POST \
  --url https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_with_websockets/ \
  --header 'Content-Type: application/json' \
  --header 'X-CEKURA-API-KEY: <api-key>' \
  --data '
{
  "scenarios": [
    {
      "scenario": 123,
      "websocket_url": "<string>"
    }
  ],
  "frequency": 50,
  "agent": 123
}
'
{
  "id": 123,
  "agent": 123,
  "run_as_text": false,
  "runs": [
    {
      "id": 123,
      "scenario": 123,
      "number": "+11234567890",
      "inbound_number": "+11234567890",
      "scenario_name": "<string>",
      "test_profile_data": {}
    }
  ],
  "created_at": "2025-02-25T21:00:01.990052Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cekura.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Body

​
scenarios
object[]
required

List of scenario+websocket pairs. Each element must be an object with two keys: scenario (integer evaluator ID) and websocket_url (string, ws:// or wss:// URL). Example: [{"scenario": 101, "websocket_url": "wss://agent-a.example.com/chat"}, {"scenario": 102, "websocket_url": "wss://agent-b.example.com/chat"}]

​
frequency
integer
required

Frequency to run

Required range: 1 <= x <= 100
​
agent
integer | null

Agent to use. Required if none of the scenarios have an agent.

Response

​
id
integer

ID of the result

​
agent
integer

ID of the agent

​
status
enum<string>

Status of the result

Available options:
pending,
running,
completed,
failed
​
run_as_text
boolean

Whether the scenario ran as text or not

Example:

false

​
runs
object[]
Examples:
{
  "id": 274,
  "status": "pending",
  "scenario": 1,
  "number": null,
  "inbound_number": "+11234567890",
  "scenario_name": "Customer Support Call (Agent Inbound = True)",
  "test_profile_data": null
}

{
  "id": 275,
  "status": "pending",
  "scenario": 2,
  "number": "+11234567890",
  "inbound_number": null,
  "scenario_name": "Outbound Sales Call (Agent Inbound = False)",
  "test_profile_data": null
}
​
created_at
string<date-time>
Example:

"2025-02-25T21:00:01.990052Z"