Run Evaluator Email

Run evaluators against an email agent

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 '
{
  "scenarios": [
    123
  ],
  "frequency": 50,
  "agent_id": 123,
  "agent_email": "jsmith@example.com"
}
'

import requests

url = "https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/"

payload = {
    "scenarios": [123],
    "frequency": 50,
    "agent_id": 123,
    "agent_email": "jsmith@example.com"
}
headers = {
    "X-CEKURA-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-CEKURA-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    scenarios: [123],
    frequency: 50,
    agent_id: 123,
    agent_email: 'jsmith@example.com'
  })
};

fetch('https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'scenarios' => [
        123
    ],
    'frequency' => 50,
    'agent_id' => 123,
    'agent_email' => 'jsmith@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-CEKURA-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/"

	payload := strings.NewReader("{\n  \"scenarios\": [\n    123\n  ],\n  \"frequency\": 50,\n  \"agent_id\": 123,\n  \"agent_email\": \"jsmith@example.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-CEKURA-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/")
  .header("X-CEKURA-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"scenarios\": [\n    123\n  ],\n  \"frequency\": 50,\n  \"agent_id\": 123,\n  \"agent_email\": \"jsmith@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-CEKURA-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"scenarios\": [\n    123\n  ],\n  \"frequency\": 50,\n  \"agent_id\": 123,\n  \"agent_email\": \"jsmith@example.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

POST

test_framework

scenarios

run_scenarios_email

Run evaluators against an email agent

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 '
{
  "scenarios": [
    123
  ],
  "frequency": 50,
  "agent_id": 123,
  "agent_email": "jsmith@example.com"
}
'

import requests

url = "https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/"

payload = {
    "scenarios": [123],
    "frequency": 50,
    "agent_id": 123,
    "agent_email": "jsmith@example.com"
}
headers = {
    "X-CEKURA-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-CEKURA-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    scenarios: [123],
    frequency: 50,
    agent_id: 123,
    agent_email: 'jsmith@example.com'
  })
};

fetch('https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'scenarios' => [
        123
    ],
    'frequency' => 50,
    'agent_id' => 123,
    'agent_email' => 'jsmith@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-CEKURA-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/"

	payload := strings.NewReader("{\n  \"scenarios\": [\n    123\n  ],\n  \"frequency\": 50,\n  \"agent_id\": 123,\n  \"agent_email\": \"jsmith@example.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-CEKURA-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/")
  .header("X-CEKURA-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"scenarios\": [\n    123\n  ],\n  \"frequency\": 50,\n  \"agent_id\": 123,\n  \"agent_email\": \"jsmith@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cekura.ai/test_framework/v1/scenarios/run_scenarios_email/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-CEKURA-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"scenarios\": [\n    123\n  ],\n  \"frequency\": 50,\n  \"agent_id\": 123,\n  \"agent_email\": \"jsmith@example.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "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.

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

Success rate of the test runs as a decimal (0.0 to 1.0)

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

Run Evaluator Text Run Evaluator Websocket

⌘I