Skip to main content
POST
Run evaluators against per-scenario websocket URLs (bulk)

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.

mock_tool_names
string[] | null

Names of mock tools to activate for this run. Omit (or send null) to mock every tool configured on the agent; send an empty list to mock none so every tool keeps its original endpoint; send specific names to mock only those.

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:
created_at
string<date-time>
Example:

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