Skip to main content
POST
Run evaluators against a Pipecat Cloud deployment (project credentials, v2)

Authorizations

X-CEKURA-API-KEY
string
header
required

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

Body

Schema for the run_scenarios_pipecat_v2 endpoint with automated Pipecat Cloud integration. Uses Pipecat Cloud SDK to automatically create sessions and Daily.co rooms.

scenarios
object[]
required

List of scenarios to run with automated Pipecat Cloud session creation

name
string | null

Optional name for the scenario result

frequency
integer
default:1

Number of times to run each scenario (default: 1)

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

Cekura agent ID to run against. Overrides the scenarios' agent.

personality_ids
integer[] | null

List of personality IDs to override for this run. If not provided, uses the scenario's default personality.

test_profile_ids
integer[] | null

List of test profile IDs to override for this run. If not provided, uses the scenario's default test profile.

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.

personality_id
integer | null

Single personality ID override. Merged into personality_ids; prefer personality_ids for multiple.

test_profile_id
integer | null

Single test profile ID override. Merged into test_profile_ids; prefer test_profile_ids for multiple.

pipecat_data
object

Per-run Pipecat Cloud overrides (pipecat_agent_name, config, room_properties). Credentials are read from the agent/project.

concurrency_limit
integer | null

Optional cap on how many of this run's calls execute concurrently.

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

Response

id
integer

ID of the result

agent
integer

ID of the agent

status
enum<string>

Status of the result. Poll until it is completed, failed, timeout or cancelled. It stays non-terminal until every run has ended, then becomes completed if any run completed — even if runs failed their checks or others errored.

Available options:
running,
completed,
failed,
pending,
in_progress,
evaluating,
in_queue,
timeout,
cancelled,
scaling_up
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"