Run Evaluator Email

curl --request POST \ --url https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/ \ --header 'Content-Type: application/json' \ --header 'X-CEKURA-API-KEY: <api-key>' \ --data ' { "agent_id": 99, "scenarios": [ 102 ], "frequency": 1 } '

{ "id": 453, "agent": 99, "agent_inbound": true, "status": "running", "run_as_text": true, "runs": [ { "id": 22019, "status": "running", "scenario": 102, "inbound_number": null, "inbound_email": null, "scenario_name": "Customer support scenario" } ], "created_at": "2026-06-22T09:00:00Z" }

Authorizations

X-CEKURA-API-KEY

string

header

required

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

Body

scenarios

integer[]

required

List of evaluator IDs to run.

frequency

integer

required

Number of times to run each scenario.

Required range: 1 <= x <= 100

agent_id

integer | null

ID of the agent to run against. Required if none of the scenarios have an agent.

calls_per_second

number<double> | null

Most calls started per second for this run, a number from 0.1 to 4 (e.g. 0.5 starts one call every 2 seconds). Leave unset for no limit.

Required range: 0.1 <= x <= 4

agent_email

string<email> | null

Override the agent's configured email address for this run.

Response

200 - application/json

name

string

required

Name of the Result Example: "Test Result 1"

Maximum string length: 255

integer

read-only

Unique identifier for the Result Example: 123

agent

integer

read-only

ID of the AI agent that was tested Example: 123

agent_inbound

boolean

read-only

Whether the agent is configured for inbound calls (true) or outbound calls (false) Example: true or false

status

enum<string>

default:pending

Current status of the result

running - Running
completed - Completed
failed - Failed
pending - Pending
in_progress - In Progress
evaluating - Evaluating
in_queue - In Queue
timeout - Timeout
cancelled - Cancelled
scaling_up - Scaling Up

Available options:

running,

completed,

failed,

pending,

in_progress,

evaluating,

in_queue,

timeout,

cancelled,

scaling_up

success_rate

number<double>

default:0

Percentage of runs that passed, 0 to 100

run_as_text

boolean

default:false

Whether this test was run in text mode instead of voice mode Example: true or false

is_cronjob

string

read-only

Whether this result was created by a scheduled cronjob Example: true or false

runs

object

read-only

Run summaries for this result. For full run data including transcripts and metric scores, fetch the result detail endpoint — there runs is a dict keyed by run ID.

Show child attributes

created_at

string<date-time>

read-only

Timestamp when this test result was created Example: 2021-01-01 00:00:00

updated_at

string<date-time>

read-only

Timestamp when this test result was last updated