{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cekura-ai/json-schema/cekura-ai-schema-post-run-scenarios-sip-schema.json",
  "title": "SchemaPostRunScenariosSip",
  "description": "Schema for the run_scenarios_sip endpoint.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cekura-ai-evaluators-api-openapi.yml#/components/schemas/SchemaPostRunScenariosSip",
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "integer",
      "description": "ID of the agent to run evaluators for"
    },
    "assistant_id": {
      "type": "string",
      "writeOnly": true,
      "description": "\nAlternative to agent ID - the assistant ID to use for this scenario\nExample: `\"asst_1234567890\"`\n"
    },
    "scenarios": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "\nList of evaluator IDs to run. Either scenarios, tags, or folder_path must be provided.\nRuns start in the order given.\nExample: `[11, 22, 33]`\n\nTo run evaluators by tag or folder, use the `tags` or `folder_path` fields instead.\n"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "\nList of tags to filter evaluators to run. Either evaluators or tags must be provided.\nExample: `[\"tag1\", \"tag2\", \"tag3\"]`\n"
    },
    "folder_path": {
      "type": "string",
      "description": "\nDot-separated folder path to select evaluators from (e.g. `\"Sales.Inbound\"`).\nMutually exclusive with `scenarios` and `tags`. Requires `project_id`.\n"
    },
    "project_id": {
      "type": "integer",
      "description": "\nProject ID. Required when using `folder_path` (or when passing a folder path string via `scenarios`).\nExample: `1376`\n"
    },
    "frequency": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "\nThe number of times each evaluator will run. Each repeat runs the whole list in order\nbefore the next one starts (A, B, A, B), rather than grouping repeats of one evaluator.\nExample: `1`\n"
    },
    "name": {
      "type": "string",
      "description": "Label text for result"
    },
    "outbound_phone_number": {
      "type": "string",
      "description": "\nOverride the phone number to use for outbound calls.\nExample: \"+1234567890\"\n"
    },
    "personality_ids": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer"
      },
      "description": "\nList of personality IDs to override for this run. If not provided, uses the scenario's default personality.\nExample: `[123, 456, 789]`\n"
    },
    "test_profile_ids": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer"
      },
      "description": "\nList of test profile IDs to override for this run. If not provided, uses the scenario's default test profile.\nExample: `[123, 456, 789]`\n"
    },
    "personality_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Single personality ID override. Merged into personality_ids; prefer personality_ids for multiple."
    },
    "test_profile_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Single test profile ID override. Merged into test_profile_ids; prefer test_profile_ids for multiple."
    },
    "mode": {
      "enum": [
        "same_number",
        "different_numbers"
      ],
      "type": "string",
      "x-spec-enum-id": "9ea0c9743bd9d873",
      "default": "same_number",
      "description": "Using same or different phone numbers for each evaluation\n\n* `same_number` - same_number\n* `different_numbers` - different_numbers"
    },
    "agent_number": {
      "type": "string",
      "description": "\nOverride the phone number from which the agent under test receives the call during outbound runs.\nThis allows overriding the default agent contact number for testing purposes.\nExample: \"+1234567890\"\n"
    },
    "concurrency_limit": {
      "type": "integer",
      "minimum": 1,
      "description": "\nCap on the number of evaluator runs executed in parallel. Default: unbounded (subject to your provider's rate limits).\nUse this to avoid hitting provider rate limits on large frequency or folder runs.\nExample: `5`\n"
    },
    "calls_per_second": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "maximum": 4,
      "minimum": 0.1,
      "description": "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."
    },
    "mock_tool_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "\nNames of mock tools to activate for this run. Cekura swaps those tools' URLs to mock endpoints while the\nrun is active and restores the originals when it finishes. Omit (or send null) to mock every tool\nconfigured on the agent; send an empty list to mock none so every tool keeps its original endpoint.\nExample: `[\"get_appointments\", \"cancel_booking\"]`\n"
    },
    "agent_version_id": {
      "type": "string",
      "description": "\nRun against a stored version of the agent instead of the agent as it is live. Cekura makes a\nprivate copy of the agent in your provider account, puts that version's prompt on it, and\nruns against the copy — voice, model and tools stay as the agent is configured now, and the\nlive agent is never changed. Accepts the version label shown in the agent's version history\n(`v12`, or `p1` for a version an improvement run proposed) or its numeric `history_id`.\nList them with `GET /test_framework/v1/aiagents/{id}/history/`; a version is usable when its\n`is_runnable` is true. Available for VAPI, Retell, ElevenLabs and Bland agents that are\noutbound and have a single prompt.\nExample: `\"v12\"`\n"
    },
    "sip_endpoint": {
      "type": "string",
      "description": "Override the agent's stored SIP endpoint for this run."
    }
  }
}