> ## 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. # Run Evaluator Pipecat Cloud (v2) > Execute evaluators against an agent deployed on Pipecat Cloud using project-level credentials. Cekura creates the sessions — no per-scenario room URLs needed. Requires Pipecat Cloud credentials configured on the agent or project. ## OpenAPI ````yaml post /test_framework/v1/scenarios/run_scenarios_pipecat_v2/ openapi: 3.1.0 info: title: Cekura API version: v1 description: >- Complete API documentation for the Cekura platform. This API provides endpoints for testing, observing, and evaluating AI voice agents — including managing agents, running evaluators, defining metrics, and analyzing call quality. servers: - url: https://api.cekura.ai security: [] paths: /test_framework/v1/scenarios/run_scenarios_pipecat_v2/: post: tags: - Evaluators summary: >- Run evaluators against a Pipecat Cloud deployment (project credentials, v2) description: >- PIPECAT CLOUD VOICE RUN (project credentials, v2): Execute evaluators against an agent deployed on Pipecat Cloud using credentials configured at the project level. Cekura creates the sessions; you don't pass per-scenario room URLs (that's the v1 endpoint). Requires Pipecat Cloud credentials with `pipecat_agent_name` set on the agent or project. **Cost:** voice-simulation rate per run. **Run-count math:** total runs = `len(scenarios) × frequency`. **Per-request `session_config` override** is allowed; merges over agent defaults. **When to use this vs others** (pick the endpoint matching the agent's configured connection — check `aiagents_retrieve`): - `scenarios_run_pipecat_v1` — manual room URLs per scenario - `scenarios_run_voice` — phone / SIP voice run - `scenarios_run_livekit_v2` — LiveKit (project credentials, v2) operationId: scenarios-run-pipecat-v2_2 requestBody: content: application/json: schema: $ref: '#/components/schemas/SchemaPostRunScenariosPipecatV2' examples: PipecatCloudV2Run: value: scenarios: - scenario: 101 - scenario: 102 frequency: 1 summary: Pipecat Cloud v2 run application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/SchemaPostRunScenariosPipecatV2' multipart/form-data: schema: $ref: '#/components/schemas/SchemaPostRunScenariosPipecatV2' required: true responses: '200': content: application/json: schema: type: object properties: id: type: integer description: ID of the result agent: type: integer description: ID of the agent status: type: string enum: - pending - running - completed - failed description: Status of the result run_as_text: type: boolean description: Whether the scenario ran as text or not example: false runs: type: array items: type: object properties: id: type: integer description: ID of the run status: type: string enum: - pending - running - completed - failed description: Status of the run scenario: type: integer description: ID of the scenario number: type: string description: >- For outbound runs (agent.inbound=False). The given number that must be called from the phone number configured in the cekura agent. example: '+11234567890' inbound_number: type: - string - 'null' description: >- For inbound runs (agent.inbound=True). The agent's configured phone number will receive calls from this number. example: '+11234567890' scenario_name: type: string description: Name of the scenario test_profile_data: type: - object - 'null' description: >- Details of the test profile associated with this run scenario 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: type: string format: date-time example: '2025-02-25T21:00:01.990052Z' description: '' '400': content: application/json: schema: type: object properties: field_name: type: array items: type: string description: '' security: - api_key: [] components: schemas: SchemaPostRunScenariosPipecatV2: type: object description: >- 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. properties: name: type: - string - 'null' description: Optional name for the scenario result frequency: type: integer maximum: 100 minimum: 1 default: 1 description: 'Number of times to run each scenario (default: 1)' scenarios: type: array items: $ref: '#/components/schemas/SchemaPipecatV2Scenario' description: >- List of scenarios to run with automated Pipecat Cloud session creation personality_ids: type: - array - 'null' items: type: integer description: >- List of personality IDs to override for this run. If not provided, uses the scenario's default personality. test_profile_ids: type: - array - 'null' items: type: integer description: >- List of test profile IDs to override for this run. If not provided, uses the scenario's default test profile. required: - scenarios SchemaPipecatV2Scenario: type: object description: >- Schema for individual scenario configuration in automated Pipecat Cloud runs. properties: scenario: type: integer description: ID of the scenario to run publish_data_message: oneOf: - {} - type: 'null' description: Optional JSON data message to publish during the session required: - scenario securitySchemes: api_key: type: apiKey name: X-CEKURA-API-KEY in: header description: >- API Key Authentication. It should be included in the header of each request. ````