{"x-generated":"DO NOT EDIT. Generated by packages/schemas/scripts/codegen.ts from packages/schemas/src/public-api","openapi":"3.0.3","info":{"title":"Cumulus Talos API","version":"1.0.0","description":"Build, run and evaluate agents over cloud and phone. Every request carries an API key (`Authorization: Bearer <key>`); operations marked for idempotency also carry an `Idempotency-Key`."},"servers":[{"url":"https://api.cumuluslabs.io"}],"security":[{"bearer":[]}],"paths":{"/api/v1/actions":{"get":{"operationId":"actions.list","summary":"List available actions","tags":["actions"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"channel","in":"query","required":false,"schema":{"type":"string","enum":["cloud","phone","web","control"]}},{"name":"invocation","in":"query","required":false,"schema":{"type":"string","enum":["model_tool","flow_node","setting","lifecycle","command"]}}],"responses":{"200":{"description":"List the action descriptors available to publications","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List the action descriptors available to agent publications."}},"/api/v1/agents":{"post":{"operationId":"agents.create","summary":"Create an agent","description":"Create an agent from a template. The response includes its first draft; publish a version before running it.\n\nChoose `phone_outbound` for outgoing calls, `cloud_task` for a task, `cloud_chat` for a chat or `blank` for an empty flow.\n\nRead the agent ID from `ref.id` and the first draft’s ID and revision from `draft`. Edit with `drafts_edit`, then check the result with `drafts_validate`.","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[!-~]{8,255}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsCreateRequest"}}}},"responses":{"200":{"description":"Create an agent from a template (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSummary"}}}},"201":{"description":"Create an agent from a template (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSummary"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"agents.list","summary":"List agents","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4096}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":256,"description":"Case-insensitive substring of the agent's name or id; blank matches every agent"}},{"name":"channel","in":"query","required":false,"schema":{"type":"string","enum":["cloud","phone"],"description":"Only agents whose head publication serves this channel"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["updated_desc","name_asc"],"default":"updated_desc"}}],"responses":{"200":{"description":"List agents with their head publication, open draft and last run; search, filter and order server-side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List agents with their live version, open draft and most recent run. Use the query fields to search, filter and sort."}},"/api/v1/agents/{agent_id}":{"delete":{"operationId":"agents.delete","summary":"Archive an agent","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"responses":{"200":{"description":"Delete (archive) an agent: it leaves the catalog and takes no new drafts, publications or runs; history is kept","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsDeleteResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Archive an agent to prevent new drafts, publications and runs. Its existing history is retained."},"get":{"operationId":"agents.get","summary":"Get an agent","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"responses":{"200":{"description":"Get one agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSummary"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read an agent’s settings, live version and draft status."}},"/api/v1/agents/{agent_id}/clone":{"post":{"operationId":"agents.clone","summary":"Clone an agent","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[!-~]{8,255}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsCloneRequest"}}}},"responses":{"200":{"description":"Clone an agent's head, chosen version or never-published draft into a new agent's first draft (201; replay 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSummary"}}}},"201":{"description":"Clone an agent's head, chosen version or never-published draft into a new agent's first draft (201; replay 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSummary"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Copy an agent’s live version, a selected publication or its never-published draft into a new agent’s first draft."}},"/api/v1/agents/{agent_id}/draft":{"delete":{"operationId":"drafts.discard","summary":"Discard a draft","tags":["drafts"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"draft_id","in":"query","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expected_revision","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647}}],"responses":{"200":{"description":"Discard the draft (revision compare-and-set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsDiscardResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Remove the open draft. Send its current revision; published versions are unaffected."},"patch":{"operationId":"drafts.edit","summary":"Edit a draft","description":"Apply typed edits to a draft in order. Send the revision you last read to prevent overwriting another editor’s changes.\n\nSend `{draft_id, expected_revision, edits}`. Edits are typed and applied in order. Read node IDs from `drafts_get`.\n\nCommon edits include:\n\n- `agent.telephony` with `value: {trunkId, from}`.\n- `flow.prompt` with `text` for the global prompt.\n- `node.instruction` with `component_id`, `node_id` and `instruction: {type: \"prompt\" | \"static_text\", text}`; use `component_id: null` for the main flow.\n- `agent.settings` with `values` and `clear`.\n- `agent.provider` with `role` (`llm`, `stt` or `tts`) and `changes`.\n- `notification.put` with the signed webhook configuration.\n\nFor incoming caller context, define a dedicated phone `POST` action with `action.put`, `effect_key` idempotency and `timeout_ms` at most 10000. Bind it with `phone.inbound_context` and `value: {action_id, variables: [\"customer_name\", \"noCallerIdMatch\"]}`. The action runs before speech, receives `{event: \"call_inbound\", call_inbound: {agent_id, agent_version, from_number, to_number}}` and returns `{call_inbound: {dynamic_variables: string_map, reject?: boolean}}`.\n\nAn existing Retell-verified endpoint can use `auth.scheme: \"retell_signature\"` with a pinned `http_auth` secret. Other HTTP authentication schemes are also supported. Set the context binding’s `value` to null to remove it.\n\nA validation diagnostic’s `fixes[].edits` can be submitted as draft edits against the revision you validated.","tags":["drafts"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsEditRequest"}}}},"responses":{"200":{"description":"Apply domain edits to the draft (revision compare-and-set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsEditResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"drafts.get","summary":"Get the draft","tags":["drafts"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"responses":{"200":{"description":"Read the open draft","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the agent’s open draft and current revision. Use that revision when editing or validating it."},"post":{"operationId":"drafts.open","summary":"Open a draft","tags":["drafts"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsOpenRequest"}}}},"responses":{"201":{"description":"Open a draft from the head or a chosen version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsEditResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Open a working draft from the live publication or a selected version."}},"/api/v1/agents/{agent_id}/draft/rebase":{"post":{"operationId":"drafts.rebase","summary":"Rebase a draft","tags":["drafts"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsRebaseRequest"}}}},"responses":{"200":{"description":"Rebase the draft onto the live version after a head change (keeps its definition; 409 head_moved when live moved again)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsEditResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Update the draft’s base after the live version changes, keeping the draft’s definition. A further live-version change returns head_moved."}},"/api/v1/agents/{agent_id}/draft/validate":{"post":{"operationId":"drafts.validate","summary":"Validate a draft","description":"Compile a draft and read its diagnostics, next version number and digest. Resolve error diagnostics before publishing.\n\nSend `{draft_id, expected_revision}`. The response includes `ok`, `version`, `digest` and `diagnostics`. Use the returned `version` when publishing. Set `include_plan: true` to also receive the compiled public plan for review when validation succeeds.\n\nWhen `ok` is false, resolve the error diagnostics. If a diagnostic supplies `fixes[].edits`, apply them with `drafts_edit` against the validated revision, then validate again. `telephony_*` warnings explain why a phone call would be refused.","tags":["drafts"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsValidateRequest"}}}},"responses":{"200":{"description":"Compile the draft and return diagnostics and the would-be digest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsValidateResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agents/{agent_id}/head":{"post":{"operationId":"publications.promote","summary":"Promote or roll back a version","description":"Make an existing version live or roll back to an earlier one. Send the live version you last read; a named open draft is rebased in the same transaction.\n\nSend the target `version` and `expected_head_version`. Read the latter from `agents_get` at `head.version`; use null when the agent has no live publication.","tags":["publications"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsPromoteRequest"}}}},"responses":{"200":{"description":"Move head to an existing version (manual promote or rollback), rebasing the named open draft in the same transaction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsPromoteResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agents/{agent_id}/publications":{"get":{"operationId":"publications.list","summary":"List published versions","tags":["publications"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List publications of an agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List the agent’s published versions."},"post":{"operationId":"publications.publish","summary":"Publish a version","description":"Compile a draft into an immutable version. Set live: false to create a test version; the default makes it live for new runs.\n\nUse the `version` returned by `drafts_validate`.\n\n- `live: false` creates a test publication and keeps the live head unchanged. Run it with `test_runs_create`, then promote it with `publications_promote`.\n- `live: true` is the default and makes the publication live immediately.\n- `keep_draft: true` keeps the working draft open for further edits.","tags":["publications"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsPublishRequest"}}}},"responses":{"200":{"description":"Publish the draft as the next immutable version; moves head unless live is false (201; replay 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsGetResponse200"}}}},"201":{"description":"Publish the draft as the next immutable version; moves head unless live is false (201; replay 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agents/{agent_id}/publications/{version}":{"get":{"operationId":"publications.get","summary":"Get a published version","tags":["publications"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"version","in":"path","required":true,"schema":{"type":"integer","minimum":0,"maximum":2147483647}}],"responses":{"200":{"description":"Get one publication with its compiled plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a publication and its compiled plan to inspect the behavior a run executes."}},"/api/v1/agents/import":{"post":{"operationId":"agents.import","summary":"Import a Retell agent","description":"Import a Retell conversation-flow export into a draft. Review diagnostics and test the imported behavior before publishing.\n\nInspect the export with `agents_import_inspect` first. Only conversation-flow exports are accepted.\n\n- Set `flow` to the export’s `conversationFlow`. Put the remaining export in `agent`, with `version` equal to `agent_version` and `agent_name` set.\n- Set `reference` to `{tenant_id, kind: \"agent\", id}`. Read the current tenant from `environments_list`; use a new agent ID or the existing draft target.\n- Replacing unpublished draft changes requires `replace_draft: {draft_id, expected_revision}`. Otherwise the import returns `409` with reason `draft_has_changes`. The live publication is unchanged.\n- Set `agent.webhook_url` to null unless `config.webhook` pins the same URL.\n- Select the LLM from `models_list`: `llm: {provider: \"openai\", model: {model_id, provider, tier}}`. Choose speech settings from `voices_list`: `stt: {provider: \"elevenlabs\", model: \"scribe_v2_realtime\"}` and `tts: {provider: \"elevenlabs\", model, voiceId}`.\n- Set `config.recording` to `{required: true, channels: \"dual\"}`. Leave out `config.telephony` until the trunk and number exist.\n- For each `model_binding_required` diagnostic, map its path in `model_bindings` to `{model: {model_id, provider, tier}}`.\n\nUse `allow_blocked: true` to keep a structurally valid draft with publication blockers, including privacy settings. `result.validation` reports those blockers and may be absent on an unchanged replay. Inline credentials and malformed sources are still refused. Validate again before publishing; this option does not bypass publication or admission checks.\n\nRetell voices, languages outside `en`/`es` and knowledge bases do not carry over. A new import returns `201`; importing the same body onto its unedited draft returns `200`.","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsImportRequest"}}}},"responses":{"200":{"description":"Import a Retell conversation-flow export into a draft without changing the live publication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsImportResponse201"}}}},"201":{"description":"Import a Retell conversation-flow export into a draft without changing the live publication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsImportResponse201"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agents/import/inspect":{"post":{"operationId":"agents.import_inspect","summary":"Preview a Retell import","description":"Preview a Retell import without writing changes. The response reports diagnostics, the target agent and any draft changes the import would replace.\n\nSend the same body you would use for `agents_import`, without an idempotency key. This operation writes nothing.\n\nUse the diagnostics to resolve import issues. Each `model_binding_required` diagnostic names a path to supply in `model_bindings`. The response also reports whether the import would create an agent, open or replace a draft, or discard unpublished changes.","tags":["agents"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"none","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsImportRequest"}}}},"responses":{"200":{"description":"Compile a Retell export and say what agents.import would do (new agent, new or replaced draft, unpublished changes it would discard) without importing it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentsImportInspectResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/alert-destinations":{"get":{"operationId":"alert_destinations.get","summary":"Get alert destinations","tags":["alert_destinations"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read which alert destinations are configured (metadata only, never the secret)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertDestinationsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read configured alert destinations without exposing their credentials."},"patch":{"operationId":"alert_destinations.update","summary":"Set alert destinations","tags":["alert_destinations"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertDestinationsUpdateRequest"}}}},"responses":{"200":{"description":"Set or clear the Slack webhook or PagerDuty routing key (revision compare-and-set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertDestinationsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Set or clear the Slack webhook or PagerDuty routing key using the current revision."}},"/api/v1/alerts":{"post":{"operationId":"alerts.create","summary":"Create an alert rule","tags":["alerts"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsCreateRequest"}}}},"responses":{"201":{"description":"Create an alert rule on a metered usage or run metric","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsAcknowledgeResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Create an alert rule for a supported usage or run metric."},"get":{"operationId":"alerts.list","summary":"List alert rules","tags":["alerts"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List alert rules with their latest delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List alert rules and their latest deliveries."}},"/api/v1/alerts/{alert_id}":{"delete":{"operationId":"alerts.delete","summary":"Delete an alert rule","tags":["alerts"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expected_revision","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0}}],"responses":{"200":{"description":"Delete an alert rule (revision compare-and-set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsAcknowledgeResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Delete an alert rule using its current revision."},"patch":{"operationId":"alerts.update","summary":"Update an alert rule","tags":["alerts"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsUpdateRequest"}}}},"responses":{"200":{"description":"Change an alert rule (revision compare-and-set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsAcknowledgeResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Change an alert rule using its current revision."}},"/api/v1/alerts/{alert_id}/acknowledge":{"post":{"operationId":"alerts.acknowledge","summary":"Acknowledge an uncertain alert delivery","tags":["alerts"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsAcknowledgeRequest"}}}},"responses":{"200":{"description":"Acknowledge an uncertain alert delivery so the rule can fire again","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsAcknowledgeResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Acknowledge an uncertain delivery so the alert rule can fire again. Check the delivery before acknowledging it."}},"/api/v1/audit":{"get":{"operationId":"audit.list","summary":"Read the audit log","tags":["audit"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"none","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"after","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"List the tenant audit log","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read workspace activity from the audit log."}},"/api/v1/comparisons":{"post":{"operationId":"comparisons.create","summary":"Compare agent versions","tags":["comparisons"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonsCreateRequest"}}}},"responses":{"202":{"description":"Compare a candidate publication against a baseline on existing runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comparison"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Compare a candidate publication with a baseline using existing runs."},"get":{"operationId":"comparisons.list","summary":"List version comparisons","tags":["comparisons"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List comparisons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List publication comparisons."}},"/api/v1/comparisons/{comparison_id}":{"get":{"operationId":"comparisons.get","summary":"Get a version comparison","tags":["comparisons"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"comparison_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Get one comparison with its per-case verdicts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a comparison and its per-case verdicts."}},"/api/v1/documents":{"get":{"operationId":"documents.list","summary":"List knowledge documents","tags":["documents"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List knowledge documents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List the environment’s knowledge documents and their states."},"post":{"operationId":"documents.upload","summary":"Upload a knowledge document","tags":["documents"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentsUploadRequest"}}}},"responses":{"201":{"description":"Upload a knowledge document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Upload a source document for knowledge retrieval. Check indexing readiness before using it in an agent."}},"/api/v1/documents/{document_id}":{"delete":{"operationId":"documents.delete","summary":"Delete a knowledge document","tags":["documents"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Delete a document and return storage/provider deletion receipts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentsDeleteResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Delete a knowledge document and inspect the storage and provider deletion receipts."},"get":{"operationId":"documents.get","summary":"Get a knowledge document","tags":["documents"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Get one knowledge document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a knowledge document’s metadata and state."}},"/api/v1/environments":{"get":{"operationId":"environments.list","summary":"List environments","description":"List the organization’s production and sandbox environments. current identifies the environment selected by your key.\n\nUse `current` to identify the key’s environment. For an import, copy the selected environment’s `tenant_id` into `reference.tenant_id`.\n\nSupply the environment slug and tenant ID when asking Cumulus to configure capacity or run admission.","tags":["environments"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List this organization's production and sandbox environments","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvironmentsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/environments/sandbox":{"post":{"operationId":"environments.ensure_sandbox","summary":"Create a sandbox","tags":["environments"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","responses":{"200":{"description":"Create this organization's sandbox environment on first use (same members)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvironmentsEnsureSandboxResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Create the organization’s sandbox on first use. It shares membership with production and has separate resources."}},"/api/v1/evaluations":{"post":{"operationId":"evaluations.create","summary":"Evaluate a run","tags":["evaluations"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationsCreateRequest"}}}},"responses":{"201":{"description":"Score a run against a rubric","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evaluation"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Score a run against a rubric."},"get":{"operationId":"evaluations.list","summary":"List evaluations","tags":["evaluations"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"run_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List evaluations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List recorded run evaluations."}},"/api/v1/keys":{"post":{"operationId":"keys.create","summary":"Create an API key","tags":["keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeysCreateRequest"}}}},"responses":{"201":{"description":"Create an API key with an explicit role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Create an API key with an explicit role. Store the secret from the creation response; it is shown once."},"get":{"operationId":"keys.list","summary":"List API keys","tags":["keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"none","responses":{"200":{"description":"List API keys (never secrets)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeysListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List API key metadata. Key secrets are never returned."}},"/api/v1/keys/{key_id}":{"delete":{"operationId":"keys.revoke","summary":"Revoke an API key","tags":["keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Revoke an API key; queued effects of its runs are denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKey"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Revoke an API key. Future access is refused, including queued effects authorized by that key."}},"/api/v1/keys/{key_id}/rotate":{"post":{"operationId":"keys.rotate","summary":"Rotate an API key","tags":["keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeysRotateRequest"}}}},"responses":{"201":{"description":"Replace an API key's secret","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Replace an API key’s secret. Store the returned secret and update the systems using it."}},"/api/v1/knowledge":{"put":{"operationId":"knowledge.configure","summary":"Configure knowledge embeddings","tags":["knowledge"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeConfigureRequest"}}}},"responses":{"200":{"description":"Choose the embedding model for knowledge","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeStatus"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Choose the embedding model used for knowledge documents."},"get":{"operationId":"knowledge.status","summary":"Get knowledge status","tags":["knowledge"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read knowledge configuration and the ready generation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeStatus"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read embedding configuration and the ready searchable generation."}},"/api/v1/knowledge/reembed":{"post":{"operationId":"knowledge.reembed","summary":"Rebuild knowledge embeddings","tags":["knowledge"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeReembedRequest"}}}},"responses":{"202":{"description":"Build a new knowledge generation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeStatus"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Build a new searchable generation. Read knowledge status to follow readiness."}},"/api/v1/models":{"get":{"operationId":"models.list","summary":"List available models","tags":["models"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"task","in":"query","required":false,"schema":{"type":"string","enum":["chat","embedding","voice","stt","tts"]}}],"responses":{"200":{"description":"List the tenant's model catalog, optionally for one task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List models available to the environment, optionally filtered by task."}},"/api/v1/provider-keys":{"get":{"operationId":"provider_keys.list","summary":"List provider credentials","tags":["provider_keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List the model-provider keys runs dial with (metadata only, never the key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderKeysListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List metadata for your model-provider credentials. The response does not expose keys."}},"/api/v1/provider-keys/{provider}":{"delete":{"operationId":"provider_keys.delete","summary":"Remove a provider credential","tags":["provider_keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","enum":["elevenlabs","openai","cerebras"]}}],"responses":{"200":{"description":"Remove the tenant's key for a model provider; new runs use the platform key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderKeysDeleteResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Remove your credential for a model provider. New runs use the platform credential."},"put":{"operationId":"provider_keys.put","summary":"Set a provider credential","tags":["provider_keys"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","enum":["elevenlabs","openai","cerebras"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderKeysPutRequest"}}}},"responses":{"200":{"description":"Set or rotate the tenant's own key for a model provider; the provider checks it before it is stored","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderKeysDeleteResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Set or rotate a model-provider credential. The provider validates it before storage."}},"/api/v1/runs":{"post":{"operationId":"runs.create","summary":"Start a run","description":"Start a cloud task, chat or phone call from a published agent. The response confirms admission; follow the run to determine its outcome.\n\nFor a phone call, send `{channel: \"phone\", agent_id, to, from, dynamic_variables}` and optionally `version`. The request dials a real number, including with `test: true`; confirm the destination before calling. Test runs are excluded from billing, customer webhooks and event triggers.\n\nUse an imported number for `from`, or omit it to use the publication’s `telephony.from`. Supply the flow’s required variables in `dynamic_variables`; missing inputs return `missing_dynamic_variables`.\n\nCheck these refusal reasons:\n\n- `tenant_not_configured` or `tenant_disabled`: ask Cumulus to configure capacity and open admission.\n- `trunk_not_authorized`: check that the caller ID and trunk are authorized.\n- `capacity_exhausted`: wait for concurrent-run capacity.\n\nFor cloud execution, send `{channel: \"cloud\", agent_id, mode: \"task\" | \"chat\", input}`. To chat with a phone agent without dialing, use cloud chat with `test: true`.","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsCreateRequest"}}}},"responses":{"200":{"description":"Admit a cloud or phone run of a publication (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"201":{"description":"Admit a cloud or phone run of a publication (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"runs.list","summary":"List runs","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"channel","in":"query","required":false,"schema":{"type":"string","enum":["cloud","phone","web"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["admitted","running","ending","completed","failed","cancelled","rejected","expired"]}},{"name":"after","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"disposition","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,127}(,[a-z][a-z0-9_-]{0,127}){0,31}$","description":"Comma-separated disposition words, e.g. voicemail_left,no_answer"}},{"name":"contact","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:human|voicemail|ivr|unknown|not_applicable)(,(?:human|voicemail|ivr|unknown|not_applicable)){0,4}$","description":"Comma-separated contact verdicts: human, voicemail, ivr, unknown, not_applicable"}},{"name":"successful","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"description":"Measured success; unmeasured runs match neither value"}},{"name":"version","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Publication version (use with agent_id)"}},{"name":"test","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"description":"Test runs only (true) or non-test runs only (false); both when omitted"}},{"name":"test_run_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Only the trials of this agent-test run (trigger test)"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List runs using agent, channel, state, time and outcome filters."}},"/api/v1/runs/{run_id}":{"get":{"operationId":"runs.get","summary":"Get a run","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Get one run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a run’s current state, pinned publication and recorded context."},"patch":{"operationId":"runs.update","summary":"Update a live phone run","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsUpdateRequest"}}}},"responses":{"200":{"description":"Update a live phone run's dynamic variables or metadata; returns a durable receipt (202 while pending, 200 once settled)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsUpdateResponse200"}}}},"202":{"description":"Update a live phone run's dynamic variables or metadata; returns a durable receipt (202 while pending, 200 once settled)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsUpdateResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Change variables or metadata during an active phone call. Read the returned receipt to confirm when the change is applied."}},"/api/v1/runs/{run_id}/analysis":{"get":{"operationId":"runs.analysis","summary":"Get post-run analysis","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read post-run analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsAnalysisResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read post-run disposition, success assessment and extracted fields. Check the analysis state for readiness."}},"/api/v1/runs/{run_id}/cancel":{"post":{"operationId":"runs.cancel","summary":"Cancel a run","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsCancelRequest"}}}},"responses":{"202":{"description":"Cancel an active run (accepted: a live call settles cancelled when its media session ends)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Cancel an active run. A phone call settles as cancelled after its media session ends."}},"/api/v1/runs/{run_id}/effects":{"get":{"operationId":"runs.effects","summary":"Get action receipts","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read the run's governed effects and receipts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsEffectsResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the run’s action decisions, send attempts and receipts. Check these records when an external action fails or its outcome is uncertain."}},"/api/v1/runs/{run_id}/events":{"get":{"operationId":"runs.events","summary":"Read or stream run events","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after_sequence","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"progress","in":"query","required":false,"schema":{"type":"string","enum":["live"]}}],"responses":{"200":{"description":"Read the run's semantic events (JSON page or text/event-stream)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsEventsResponse200"}},"text/event-stream":{"schema":{"type":"string","description":"SSE: id = sequence, event = type, data = SemanticEvent; with progress=live also event = transcript.progress | effect.progress (no id), data = RunProgress"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a page of run events or subscribe to server-sent events. Resume after the last sequence you processed."}},"/api/v1/runs/{run_id}/messages":{"post":{"operationId":"runs.send_message","summary":"Send a chat message","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsSendMessageRequest"}}}},"responses":{"202":{"description":"Send a user message to a cloud chat run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsSendMessageResponse202"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Send a user turn to a cloud chat run. Read the reply through run events or the transcript."}},"/api/v1/runs/{run_id}/recording":{"get":{"operationId":"runs.recording","summary":"Get a recording URL","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Get a short-lived recording URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsRecordingResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Check recording availability and obtain a short-lived playback URL when it is ready."}},"/api/v1/runs/{run_id}/result":{"get":{"operationId":"runs.result","summary":"Get a task result","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read what a cloud task run produced: its output object, validated against the publication's output schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsResultResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a cloud task’s structured output. Check the result state before consuming the output."}},"/api/v1/runs/{run_id}/transcript":{"get":{"operationId":"runs.transcript","summary":"Get a transcript","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read the run transcript","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsTranscriptResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the run’s conversation turns, including available timing and interruption information."}},"/api/v1/runs/{run_id}/updates/{update_id}":{"get":{"operationId":"runs.update_get","summary":"Get an update receipt","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"update_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read a live update's receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsUpdateGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the status and outcome of a live phone-run update."}},"/api/v1/runs/{run_id}/usage":{"get":{"operationId":"runs.usage","summary":"Get run usage and cost","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read metered usage and cost of one run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsUsageResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read measured usage, pricing and completeness for one run."}},"/api/v1/runs/capacity":{"get":{"operationId":"runs.capacity","summary":"Check run capacity","description":"Read each channel’s admission status, concurrent-run limit and active count.\n\nIf `admission_enabled` is false or the phone channel is absent, ask Cumulus to configure capacity and open admission for this environment.","tags":["runs"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read admission capacity per channel: configured limit and runs holding it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsCapacityResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/secrets":{"get":{"operationId":"secrets.list","summary":"List secret metadata","tags":["secrets"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List secret metadata (never values)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List secret names, kinds and versions. Secret values are never returned."}},"/api/v1/secrets/{secret_id}":{"delete":{"operationId":"secrets.delete","summary":"Delete a secret","tags":["secrets"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"secret_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"}}],"responses":{"200":{"description":"Delete a secret and all its versions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Delete a secret and all its versions."},"put":{"operationId":"secrets.put","summary":"Create or version a secret","description":"Create a secret or add a version. Keep the returned version for references in agents and trunks; the response does not return the value.\n\nUse an admin key. Choose `sip_auth` for a trunk password, `webhook_signing` for a webhook secret or `http_auth` for an HTTP credential. The response returns metadata, never the value. Reference the saved secret as `{id, version: current_version}`.\n\nFor a Basis Theory proxy credential, use `http_auth` and an `action.put` edit with `auth: {scheme: \"header\", header_name: \"BT-PROXY-KEY\", secret_ref: {id, version}}`. Remove the key query parameter from the action URL and keep the value out of prompts. Proxy access does not grant tokenization permissions.","tags":["secrets"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"secret_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretsPutRequest"}}}},"responses":{"200":{"description":"Create a secret or add a new version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretMetadata"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/team":{"get":{"operationId":"team.list","summary":"List members and invitations","tags":["team"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List members and pending invitations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List workspace members and pending invitations."}},"/api/v1/team/invitations":{"post":{"operationId":"team.invite","summary":"Invite a member","tags":["team"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInviteRequest"}}}},"responses":{"201":{"description":"Invite a member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInviteResponse201"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Invite a person to join the workspace with a selected role."}},"/api/v1/team/invitations/{invitation_id}":{"delete":{"operationId":"team.invite_revoke","summary":"Revoke an invitation","tags":["team"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"invitation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Revoke a pending invitation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Revoke a pending invitation."}},"/api/v1/team/invitations/{invitation_id}/resend":{"post":{"operationId":"team.invite_resend","summary":"Resend an invitation","tags":["team"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"invitation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Send a pending invitation again with a new link and expiry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInviteResponse201"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Resend a pending invitation with a new link and expiry."}},"/api/v1/team/members/{user_id}":{"delete":{"operationId":"team.remove","summary":"Remove a member","tags":["team"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Remove a member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Remove a member’s workspace access."},"patch":{"operationId":"team.set_role","summary":"Change a member’s role","tags":["team"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamSetRoleRequest"}}}},"responses":{"200":{"description":"Change a member's role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamSetRoleResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Change a workspace member’s role."}},"/api/v1/telephony/call-limit":{"get":{"operationId":"call_limits.get","summary":"Get your outbound call limit","tags":["call_limits"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read the tenant's own daily outbound call limit and the outbound calls placed in the last 24 hours","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallLimitsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the daily outbound call limit and the calls placed in the last 24 hours."},"put":{"operationId":"call_limits.update","summary":"Set your outbound call limit","tags":["call_limits"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallLimitsUpdateRequest"}}}},"responses":{"200":{"description":"Set or clear the tenant's daily outbound call limit (null: no limit)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallLimitsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Set the daily outbound call limit, or use null to remove it. Concurrent-run capacity is configured separately."}},"/api/v1/telephony/numbers":{"post":{"operationId":"numbers.import","summary":"Import a phone number","description":"Import a number from a connected carrier trunk. Wait for the number to become ready before using it as caller ID.\n\nUse an admin key and a connected trunk. For Twilio, `e164` must be a number on that trunk.\n\nWait for `state: \"ready\"` before using the number as `from` in a run or in `agent.telephony`. If provisioning is pending, repeat the import with the same body and idempotency key.\n\nAn `inbound_agent_id` assignment requires an inbound-enabled trunk and a published phone agent.","tags":["numbers"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersImportRequest"}}}},"responses":{"201":{"description":"Import a phone number from a connected trunk","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ByocNumber"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"numbers.list","summary":"List phone numbers","tags":["numbers"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List BYOC phone numbers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List imported phone numbers and their agent assignments."}},"/api/v1/telephony/numbers/{number_id}":{"delete":{"operationId":"numbers.release","summary":"Release a phone number","tags":["numbers"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"number_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Release a phone number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Release an imported number from Talos."},"patch":{"operationId":"numbers.update","summary":"Update a phone number","description":"Rename a number or change its agent assignments. An incoming-call assignment pins the current publication; reassign after changing the live version.\n\nEnable inbound on the Twilio trunk and configure its returned `inbound_sip_uri` in Twilio Origination first.\n\nSetting `inbound_agent_id` pins the agent’s current publication and the assigning admin’s live authority to the number. Each signed SIP arrival admits an inbound run. Set the field to null to remove the assignment; reassign after publishing or promoting a new version.","tags":["numbers"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"number_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumbersUpdateRequest"}}}},"responses":{"200":{"description":"Assign agents or rename a phone number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ByocNumber"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/telephony/trunks":{"post":{"operationId":"trunks.create","summary":"Connect a SIP trunk","description":"Connect your carrier’s SIP trunk using a versioned credential secret. Enable inbound routing if the trunk will receive calls.\n\nUse an admin key and configure call capacity with Cumulus first. `tenant_not_configured` means that setup is missing.\n\n1. Store the SIP password with `secrets_put`, using `kind: \"sip_auth\"`.\n2. Pass `auth_secret: {id, version: current_version}` to connect the trunk.\n3. For Twilio, set `termination_uri` to the Termination host (`<name>.pstn.twilio.com`) and enable Secure Trunking. Calls use TLS and SRTP.\n4. For incoming calls, set `inbound: true` and configure the returned `inbound_sip_uri` as Twilio’s Origination URI with secure trunking enabled.\n5. Import the numbers and assign a published phone agent.","tags":["trunks"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrunksCreateRequest"}}}},"responses":{"201":{"description":"Connect a BYOC SIP trunk","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ByocTrunk"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"trunks.list","summary":"List SIP trunks","tags":["trunks"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"List BYOC SIP trunks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrunksListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List the SIP trunks connected to the current environment."}},"/api/v1/telephony/trunks/{trunk_id}":{"delete":{"operationId":"trunks.delete","summary":"Disconnect a SIP trunk","tags":["trunks"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"trunk_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"Disconnect a BYOC SIP trunk","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Disconnect a SIP trunk from the environment."},"patch":{"operationId":"trunks.update","summary":"Update a SIP trunk","tags":["trunks"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","parameters":[{"name":"trunk_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrunksUpdateRequest"}}}},"responses":{"200":{"description":"Update a BYOC SIP trunk","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ByocTrunk"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Change a connected SIP trunk’s settings."}},"/api/v1/tenant/settings":{"get":{"operationId":"tenant_settings.get","summary":"Get workspace settings","tags":["tenant_settings"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read the organization's display name and retention settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantSettingsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the organization’s display name and retention policy."},"put":{"operationId":"tenant_settings.update","summary":"Update workspace settings","tags":["tenant_settings"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantSettingsUpdateRequest"}}}},"responses":{"200":{"description":"Rename the organization and/or change retention (retention is a version compare-and-set)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantSettingsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Change the display name or retention policy. Retention updates check the policy version you last read."}},"/api/v1/test-runs":{"post":{"operationId":"test_runs.create","summary":"Start a test run","description":"Run suites against one publication version. Follow progress, then inspect case verdicts and trial evidence.\n\nSend `agent_id`, a published `version` and `suite_ids`. Use `case_ids` or `trials` to select cases or override the trial count. Call `test_runs_estimate` first to review trial count, cost and duration.\n\nFollow `test_runs_get` until completion or cancellation. Read `test_runs_results` for case and assertion verdicts, then `test_runs_trial` for the transcript and evidence behind a verdict.","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunCreateRequest"}}}},"responses":{"200":{"description":"Run test suites against one publication version (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRun"}}}},"201":{"description":"Run test suites against one publication version (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRun"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"test_runs.list","summary":"List test runs","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"version","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":2147483647}},{"name":"suite_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"purpose","in":"query","required":false,"schema":{"type":"string","enum":["manual","publish_gate","schedule","release"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["queued","running","completed","cancelled"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List test runs, newest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunsListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List test runs, newest first."}},"/api/v1/test-runs/{test_run_id}":{"get":{"operationId":"test_runs.get","summary":"Get a test run","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"test_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Get a test run: state, verdict, progress, summary and cost","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRun"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a test run’s state, progress, verdict, summary and cost."}},"/api/v1/test-runs/{test_run_id}/cancel":{"post":{"operationId":"test_runs.cancel","summary":"Cancel a test run","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"test_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunsCancelRequest"}}}},"responses":{"202":{"description":"Cancel a test run: no new trials start and running trials are cancelled; settled results stay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRun"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Cancel a test run. No new trials start, running trials are cancelled and settled results remain available."}},"/api/v1/test-runs/{test_run_id}/cases/{case_id}/trials/{trial}":{"get":{"operationId":"test_runs.trial","summary":"Get a trial transcript","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"test_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"case_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"}},{"name":"trial","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":30}},{"name":"suite_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Get one trial: its assertion trace and, while retained, the transcript it was judged on","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunsTrialResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read one trial’s assertion trace and, while retained, the transcript used for its verdict."}},"/api/v1/test-runs/{test_run_id}/events":{"get":{"operationId":"test_runs.events","summary":"Read or stream test events","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"test_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after_sequence","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"progress","in":"query","required":false,"schema":{"type":"string","enum":["live"]}}],"responses":{"200":{"description":"Read a test run's journal events (JSON page or text/event-stream)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsEventsResponse200"}},"text/event-stream":{"schema":{"type":"string","description":"SSE: id = sequence, event = type, data = SemanticEvent; with progress=live also event = transcript.progress | effect.progress (no id), data = RunProgress"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a page of test-run events or follow them through server-sent events."}},"/api/v1/test-runs/{test_run_id}/results":{"get":{"operationId":"test_runs.results","summary":"Get case results","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"test_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["passed","flaky_passed","failed","errored","invalid"]}},{"name":"suite_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List a test run's case results with each trial's assertion verdicts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunsResultsResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read case results and each trial’s assertion verdicts."}},"/api/v1/test-runs/estimate":{"post":{"operationId":"test_runs.estimate","summary":"Estimate a test run","tags":["test_runs"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunCreateRequest"}}}},"responses":{"200":{"description":"Estimate a test run's trials, cost and duration before starting it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunsEstimateResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Estimate trial count, cost and duration before starting a test run."}},"/api/v1/test-sessions":{"post":{"operationId":"test_sessions.create","summary":"Start a browser voice test","description":"Start a browser voice test of a published phone agent. The response includes a web run and a short-lived room token; replaying the key rejoins the live test with a fresh token.\n\nSend `{agent_id, version}`. Join the returned LiveKit URL with the participant token within five minutes. No carrier trunk or number is needed; run admission must be open.","tags":["test_sessions"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSessionsCreateRequest"}}}},"responses":{"200":{"description":"Start a browser voice test of one agent version: admits a web run and returns a short-lived LiveKit room token (the same Idempotency-Key rejoins the live run with a fresh token)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSessionsCreateResponse201"}}}},"201":{"description":"Start a browser voice test of one agent version: admits a web run and returns a short-lived LiveKit room token (the same Idempotency-Key rejoins the live run with a fresh token)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSessionsCreateResponse201"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/test-suites":{"post":{"operationId":"test_suites.create","summary":"Create a test suite","description":"Create simulation cases with caller behavior, assertions and action mocks for an agent.\n\nSet `spec.kind` to `simulation` and define `cases`. Each case needs a lowercase-slug `case_id`, name, caller and assertions. Add dynamic variables, HTTP action mocks and an optional trial count.\n\nChoose a caller with either `{kind: \"persona\", goal, brief}` or `{kind: \"script\", steps: [{says}]}`. Assertion IDs are your labels; node IDs come from `drafts_get` or `publications_get`.\n\nDeterministic assertions include `node_visited`, `node_not_visited`, `final_node`, `path`, `agent_says`, `tool_called`, `variable`, `ended`, `transfer` and `disposition`. For `agent_says`, use `expect: \"never\" | \"at_least_once\"` and `match: {patterns}`. A `rubric` assertion uses a model judge.\n\nMocks answer customer HTTP actions by `action_id`. An unmocked customer HTTP action fails with `unmocked_action` before sending; built-in actions have simulated defaults. Run the suite with `test_runs_create`.","tags":["test_suites"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuitesCreateRequest"}}}},"responses":{"200":{"description":"Create a test suite on an agent (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuiteView"}}}},"201":{"description":"Create a test suite on an agent (201; an idempotent replay returns 200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuiteView"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"test_suites.list","summary":"List test suites","tags":["test_suites"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"include_archived","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"List test suites (optionally one agent's) with their last run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuitesListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List test suites, optionally for one agent, with their most recent run."}},"/api/v1/test-suites/{suite_id}":{"delete":{"operationId":"test_suites.delete","summary":"Archive a test suite","tags":["test_suites"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expected_revision","in":"query","required":false,"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647}}],"responses":{"200":{"description":"Archive a test suite; its runs and results are kept","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Archive a test suite. Existing runs and results are retained."},"patch":{"operationId":"test_suites.edit","summary":"Edit a test suite","tags":["test_suites"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"natural","parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuitesEditRequest"}}}},"responses":{"200":{"description":"Edit a test suite (rename, upsert, remove or reorder cases) as a compare-and-set on its revision","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuiteView"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Rename a suite or add, remove and reorder cases. Send the revision you last read."},"get":{"operationId":"test_suites.get","summary":"Get a test suite","tags":["test_suites"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revision","in":"query","required":false,"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647}}],"responses":{"200":{"description":"Get a test suite (its current revision, or ?revision) with its last run and flaky cases","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuiteView"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read a suite’s current or selected revision, last run and flaky cases."}},"/api/v1/test-suites/{suite_id}/validate":{"post":{"operationId":"test_suites.validate","summary":"Validate a test suite","tags":["test_suites"],"x-cumulus-owner":"control-plane","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"none","parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuitesValidateRequest"}}}},"responses":{"200":{"description":"Check a suite's node, action and variable references against a published version or the open draft","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSuitesValidateResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Check a suite’s node, action and variable references against a publication or the open draft."}},"/api/v1/usage":{"get":{"operationId":"usage.summary","summary":"Summarize usage","tags":["usage"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"group_by","in":"query","required":true,"schema":{"type":"string","enum":["agent","run","day"]}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},{"name":"purpose","in":"query","required":false,"schema":{"type":"string","enum":["billable","test"],"default":"billable","description":"billable: non-test runs (the billable report); test: test runs, metered and not billed"}}],"responses":{"200":{"description":"Summarize metered usage by agent, run or day: the billable runs, or (purpose=test) the test runs, metered and not billed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageSummaryResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read metered usage by agent, run or day. Use purpose=test for usage that is measured but not billed, and check completeness."}},"/api/v1/usage/budget":{"get":{"operationId":"budgets.get","summary":"Get your budget","tags":["budgets"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read the tenant budget: period, cap and metered spend (configured: false until metered pricing is installed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read the spending cap and metered spend. configured: false means metered pricing has not been installed."},"put":{"operationId":"budgets.update","summary":"Set your budget","tags":["budgets"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:admin","x-cumulus-idempotency":"natural","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetsUpdateRequest"}}}},"responses":{"200":{"description":"Set the tenant budget cap (compare-and-set on the active policy; refused until metered pricing is installed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetsGetResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Set the spending cap using the current policy revision. Metered pricing must be configured first."}},"/api/v1/usage/rate-card":{"get":{"operationId":"usage.rate_card","summary":"Get your rate card","tags":["usage"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","responses":{"200":{"description":"Read the customer rates of the tenant's active pricing (configured: false until metered pricing is installed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageRateCardResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"Read your environment’s active rates. configured: false means metered pricing has not been installed."}},"/api/v1/voices":{"get":{"operationId":"voices.list","summary":"List speech models and voices","tags":["voices"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:read","x-cumulus-idempotency":"none","parameters":[{"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["en","es"]}},{"name":"include_preview","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"List the speech models and platform TTS voices an agent can use","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoicesListResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"List available speech models and text-to-speech voices for agent configuration."}},"/api/v1/voices/preview":{"post":{"operationId":"voices.preview","summary":"Preview configured speech","description":"Preview a fixed English or Spanish line with configured voice, model, speed and expressiveness; does not run an agent\n\nAudio is returned once. A retry with the same Idempotency-Key never synthesizes again and returns 409 if the preview request was already consumed. Use a new key only for an intentional new preview.","tags":["voices"],"x-cumulus-owner":"talos","x-cumulus-permission":"tenant:write","x-cumulus-idempotency":"required_header","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoicesPreviewRequest"}}}},"responses":{"200":{"description":"Preview a fixed English or Spanish line with configured voice, model, speed and expressiveness; does not run an agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoicesPreviewResponse200"}}}},"4XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"5XX":{"description":"Typed error (ApiError)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"ActionDescriptor":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"kind":{"type":"string","enum":["builtin","customer_http","command"]},"title":{"type":"string","minLength":1,"maxLength":120},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone","web","control"]},"minItems":1},"invocation":{"type":"string","enum":["model_tool","flow_node","setting","lifecycle","command"]},"permission":{"type":"string","enum":["tenant:read","tenant:write","tenant:admin","platform:admin","tenant:act-as","tenant:dial"]},"grant_action":{"type":"string","enum":["rag.index","benchmark.run","comparison.run","gpu.manage","run.execute","trigger.execute","test.run"],"nullable":true},"risk":{"type":"string","enum":["low","medium","high"]},"human_required":{"type":"boolean"},"effect":{"type":"object","properties":{"kind":{"type":"string","enum":["none","transaction","gateway_inference","http","livekit","sip_dial","sip_transfer","sip_hangup","run_admission","gpu"]},"idempotency":{"type":"string","enum":["owner_key","receiver_key","observe_then_act","none"]},"unknown_outcome":{"type":"string","enum":["surface_uncertain","retry_same_key","reconcile_by_observation"]},"max_send_attempts":{"type":"integer","minimum":1,"maximum":12},"timeout_ms":{"type":"integer","minimum":100,"maximum":120000}},"required":["kind","idempotency","unknown_outcome","max_send_attempts","timeout_ms"],"additionalProperties":false},"input_schema":{"type":"object","additionalProperties":{}},"output_schema":{"type":"object","additionalProperties":{}},"config_schema":{"type":"object","additionalProperties":{}}},"required":["id","version","kind","title","channels","invocation","permission","grant_action","risk","human_required","effect","input_schema","output_schema","config_schema"],"additionalProperties":false},"ActionsListResponse200":{"type":"array","items":{"$ref":"#/components/schemas/ActionDescriptor"}},"AgentLayout":{"type":"object","properties":{"flow":{"type":"object","properties":{"nodes":{"type":"object","additionalProperties":{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000}},"required":["x","y"],"additionalProperties":false}},"start":{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000}},"required":["x","y"],"additionalProperties":false},"viewport":{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000},"zoom":{"type":"number","minimum":0.01,"maximum":100}},"required":["x","y","zoom"],"additionalProperties":false}},"required":["nodes"],"additionalProperties":false},"components":{"type":"object","additionalProperties":{"type":"object","properties":{"nodes":{"type":"object","additionalProperties":{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000}},"required":["x","y"],"additionalProperties":false}},"start":{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000}},"required":["x","y"],"additionalProperties":false},"viewport":{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000},"zoom":{"type":"number","minimum":0.01,"maximum":100}},"required":["x","y","zoom"],"additionalProperties":false}},"required":["nodes"],"additionalProperties":false}}},"required":["flow","components"],"additionalProperties":false},"AgentsCloneRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256},"version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true}},"required":["name"],"additionalProperties":false},"AgentsCreateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256},"template":{"type":"string","enum":["blank","cloud_task","cloud_chat","phone_outbound"]},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1,"default":["en"]}},"required":["name","template","channels"],"additionalProperties":false},"AgentsDeleteResponse200":{"type":"object","properties":{"agent":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"deleted":{"type":"boolean","enum":[true]},"archived_at":{"type":"string","format":"date-time"}},"required":["agent","deleted","archived_at"],"additionalProperties":false},"AgentsImportInspectResponse200":{"type":"object","properties":{"ok":{"type":"boolean"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"digest":{"allOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}],"nullable":true},"diagnostics":{"type":"array","items":{"$ref":"#/components/schemas/Diagnostic"}},"plan":{"$ref":"#/components/schemas/PublicationPlan"},"target":{"type":"object","properties":{"outcome":{"type":"string","enum":["create_agent","open_draft","replace_draft","unchanged"]},"agent":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"name":{"type":"string","nullable":true},"head_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"draft":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"base_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"published_revision":{"allOf":[{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647}],"nullable":true},"unpublished_changes":{"type":"boolean"},"updated_at":{"type":"string","format":"date-time"}},"required":["draft_id","revision","base_version","published_revision","unpublished_changes","updated_at"],"additionalProperties":false,"nullable":true}},"required":["outcome","agent","name","head_version","draft"],"additionalProperties":false}},"required":["ok","version","digest","diagnostics","target"],"additionalProperties":false},"AgentsImportRequest":{"type":"object","properties":{"reference":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":512}},"required":["tenant_id","kind","id"],"additionalProperties":false},"agent_version":{"type":"integer","minimum":0,"maximum":2147483647},"flow":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonValue"}},"agent":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonValue"}},"config":{"type":"object","properties":{"providers":{"type":"object","properties":{"stt":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":256},"model":{"type":"string","minLength":1,"maxLength":256},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version"],"additionalProperties":false},"endpoint":{"type":"string","format":"uri"},"voiceId":{"type":"string","minLength":1,"maxLength":256}},"required":["provider","model"],"additionalProperties":false},"llm":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"provider":{"type":"string","enum":["openai","simulated_openai","self_hosted","simulated_self_hosted"]},"endpoint":{"type":"string","format":"uri"}},"required":["model","provider"],"additionalProperties":false},"tts":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":256},"model":{"type":"string","minLength":1,"maxLength":256},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version"],"additionalProperties":false},"endpoint":{"type":"string","format":"uri"},"voiceId":{"type":"string","minLength":1,"maxLength":256}},"required":["provider","model"],"additionalProperties":false}},"required":["stt","llm","tts"],"additionalProperties":false},"telephony":{"type":"object","properties":{"trunkId":{"type":"string","minLength":1,"maxLength":256},"from":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"}},"required":["trunkId"],"additionalProperties":false},"recording":{"type":"object","properties":{"required":{"type":"boolean"},"channels":{"type":"string","enum":["dual"]}},"required":["required","channels"],"additionalProperties":false},"webhook":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"secretRef":{"type":"string","minLength":1,"maxLength":256}},"required":["url","secretRef"],"additionalProperties":false}},"required":["providers","recording"],"additionalProperties":false},"model_bindings":{"type":"object","additionalProperties":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false}},"required":["model"],"additionalProperties":false}},"replace_draft":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647}},"required":["draft_id","expected_revision"],"additionalProperties":false},"allow_blocked":{"type":"boolean"}},"required":["reference","agent_version","flow","agent","config","model_bindings"],"additionalProperties":false},"AgentsImportResponse201":{"type":"object","properties":{"outcome":{"type":"string","enum":["create_agent","open_draft","replace_draft","unchanged"]},"draft":{"$ref":"#/components/schemas/DraftsEditResponse200"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/Diagnostic"}},"validation":{"$ref":"#/components/schemas/DraftsValidateResponse200"}},"required":["outcome","draft","warnings"],"additionalProperties":false},"AgentsListResponse200":{"type":"object","properties":{"agents":{"type":"array","items":{"$ref":"#/components/schemas/AgentSummary"}},"issues":{"type":"array","items":{"type":"object","properties":{"target":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid","nullable":true}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"message":{"type":"string"}},"required":["target","message"],"additionalProperties":false}},"next_cursor":{"type":"string","maxLength":4096,"nullable":true}},"required":["agents","issues","next_cursor"],"additionalProperties":false},"AgentSummary":{"type":"object","properties":{"ref":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"name":{"type":"string","minLength":1,"maxLength":256},"head":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1},"published_at":{"type":"string","format":"date-time"}},"required":["version","digest","channels","languages","published_at"],"additionalProperties":false,"nullable":true},"draft":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"base_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"published_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"nullable":true}},"required":["draft_id","revision","base_version","published_revision"],"additionalProperties":false,"nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time","description":"The head's publish time, else created_at: the key of the updated_desc agents.list order"},"last_run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"state":{"type":"string","enum":["admitted","running","ending","completed","failed","cancelled","rejected","expired"]},"disposition":{"type":"string","nullable":true}},"required":["run_id","created_at","state","disposition"],"additionalProperties":false,"nullable":true,"description":"The most recent non-test run of any version; null when the agent never ran outside Studio tests"}},"required":["ref","name","head","draft","created_at","updated_at","last_run"],"additionalProperties":false},"AlertDestinationsGetResponse200":{"type":"object","properties":{"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"destinations":{"type":"object","properties":{"slack":{"type":"object","properties":{"revision":{"type":"string","format":"uuid","nullable":true},"configured":{"type":"boolean"}},"required":["revision","configured"],"additionalProperties":false},"pagerduty":{"type":"object","properties":{"revision":{"type":"string","format":"uuid","nullable":true},"configured":{"type":"boolean"}},"required":["revision","configured"],"additionalProperties":false}},"required":["slack","pagerduty"],"additionalProperties":false}},"required":["scope","destinations"],"additionalProperties":false},"AlertDestinationsUpdateRequest":{"type":"object","properties":{"changes":{"type":"array","items":{"type":"object","properties":{"destination":{"type":"string","enum":["slack","pagerduty"]},"expected_revision":{"type":"string","format":"uuid","nullable":true},"change":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["replace"]},"value":{"type":"string","minLength":1,"maxLength":4096}},"required":["kind","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["clear"]}},"required":["kind"],"additionalProperties":false}]}},"required":["destination","expected_revision","change"],"additionalProperties":false},"minItems":1,"maxItems":2}},"required":["changes"],"additionalProperties":false},"AlertsAcknowledgeRequest":{"type":"object","properties":{"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"delivery_id":{"type":"string","format":"uuid"}},"required":["expected_revision","delivery_id"],"additionalProperties":false},"AlertsAcknowledgeResponse200":{"type":"object","properties":{"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"rule":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"metric":{"type":"string","minLength":1},"threshold":{"type":"string","minLength":1},"destination":{"type":"object","properties":{"kind":{"type":"string","enum":["slack","pagerduty","webhook","unsupported"]}},"required":["kind"],"additionalProperties":false},"enabled":{"type":"boolean"},"deleted_at":{"type":"string","format":"date-time","nullable":true},"evaluation":{"type":"object","properties":{"status":{"type":"string","enum":["pending","available","unavailable"]},"reason":{"type":"string","enum":["no_observations","incomplete_usage","incomplete_coverage","metric_unavailable","unsupported_metric","destination_unavailable","unsupported_destination","invalid_rule"],"nullable":true},"evaluated_at":{"type":"string","format":"date-time","nullable":true},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false,"nullable":true},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$","nullable":true},"evidence":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["usage_view"]},"view":{"type":"object","properties":{"schema_version":{"type":"string","enum":["1"]},"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"as_of":{"type":"string","format":"date-time"},"snapshot":{"type":"string","maxLength":4096,"pattern":"^[0-9]+:[0-9]+:(?:[0-9]+(?:,[0-9]+)*)?$"},"cohort":{"type":"object","properties":{"observation_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["observation_count","sha256"],"additionalProperties":false}},"required":["schema_version","scope","window","as_of","snapshot","cohort"],"additionalProperties":false},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","view","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["usage_statement"]},"statement_id":{"type":"string","format":"uuid"},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","statement_id","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gateway_attempt_latency"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["talos_metric"]},"metric":{"type":"string","enum":["call_error_rate_24h","recording_failure_rate_24h"]},"definition_version":{"type":"number","enum":[1]},"observation_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"unknown_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["kind","metric","definition_version","observation_count","failed_count","unknown_count"],"additionalProperties":false}],"nullable":true}},"required":["status","reason","evaluated_at","window","value","evidence"],"additionalProperties":false},"last_fired_at":{"type":"string","format":"date-time","nullable":true},"blocked_by_delivery_id":{"type":"string","format":"uuid","nullable":true},"latest_delivery":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rule_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"status":{"type":"string","enum":["pending","sending","delivered","cancelled","uncertain"]},"destination_kind":{"type":"string","enum":["slack","pagerduty","webhook"]},"destination_revision":{"type":"string","minLength":1},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"threshold":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"evidence":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["usage_view"]},"view":{"type":"object","properties":{"schema_version":{"type":"string","enum":["1"]},"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"as_of":{"type":"string","format":"date-time"},"snapshot":{"type":"string","maxLength":4096,"pattern":"^[0-9]+:[0-9]+:(?:[0-9]+(?:,[0-9]+)*)?$"},"cohort":{"type":"object","properties":{"observation_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["observation_count","sha256"],"additionalProperties":false}},"required":["schema_version","scope","window","as_of","snapshot","cohort"],"additionalProperties":false},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","view","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["usage_statement"]},"statement_id":{"type":"string","format":"uuid"},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","statement_id","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gateway_attempt_latency"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["talos_metric"]},"metric":{"type":"string","enum":["call_error_rate_24h","recording_failure_rate_24h"]},"definition_version":{"type":"number","enum":[1]},"observation_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"unknown_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["kind","metric","definition_version","observation_count","failed_count","unknown_count"],"additionalProperties":false}],"nullable":true},"created_at":{"type":"string","format":"date-time"},"send_intent_at":{"type":"string","format":"date-time","nullable":true},"finished_at":{"type":"string","format":"date-time","nullable":true},"error_code":{"type":"string","minLength":1,"nullable":true},"acknowledged_at":{"type":"string","format":"date-time","nullable":true}},"required":["id","rule_revision","status","destination_kind","destination_revision","value","threshold","window","evidence","created_at","send_intent_at","finished_at","error_code","acknowledged_at"],"additionalProperties":false,"nullable":true}},"required":["id","revision","metric","threshold","destination","enabled","deleted_at","evaluation","last_fired_at","blocked_by_delivery_id","latest_delivery"],"additionalProperties":false}},"required":["scope","rule"],"additionalProperties":false},"AlertsCreateRequest":{"type":"object","properties":{"metric":{"type":"string","enum":["spend_usd_per_hour","p95_latency_ms_1h","call_error_rate_24h","recording_failure_rate_24h"]},"threshold":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"enabled":{"type":"boolean"},"destination":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["slack"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["pagerduty"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["webhook"]},"url":{"type":"string","format":"uri","maxLength":4096}},"required":["kind","url"],"additionalProperties":false}]}},"required":["metric","threshold","enabled","destination"],"additionalProperties":false},"AlertsListResponse200":{"type":"object","properties":{"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"metric":{"type":"string","minLength":1},"threshold":{"type":"string","minLength":1},"destination":{"type":"object","properties":{"kind":{"type":"string","enum":["slack","pagerduty","webhook","unsupported"]}},"required":["kind"],"additionalProperties":false},"enabled":{"type":"boolean"},"deleted_at":{"type":"string","format":"date-time","nullable":true},"evaluation":{"type":"object","properties":{"status":{"type":"string","enum":["pending","available","unavailable"]},"reason":{"type":"string","enum":["no_observations","incomplete_usage","incomplete_coverage","metric_unavailable","unsupported_metric","destination_unavailable","unsupported_destination","invalid_rule"],"nullable":true},"evaluated_at":{"type":"string","format":"date-time","nullable":true},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false,"nullable":true},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$","nullable":true},"evidence":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["usage_view"]},"view":{"type":"object","properties":{"schema_version":{"type":"string","enum":["1"]},"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"as_of":{"type":"string","format":"date-time"},"snapshot":{"type":"string","maxLength":4096,"pattern":"^[0-9]+:[0-9]+:(?:[0-9]+(?:,[0-9]+)*)?$"},"cohort":{"type":"object","properties":{"observation_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["observation_count","sha256"],"additionalProperties":false}},"required":["schema_version","scope","window","as_of","snapshot","cohort"],"additionalProperties":false},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","view","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["usage_statement"]},"statement_id":{"type":"string","format":"uuid"},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","statement_id","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gateway_attempt_latency"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["talos_metric"]},"metric":{"type":"string","enum":["call_error_rate_24h","recording_failure_rate_24h"]},"definition_version":{"type":"number","enum":[1]},"observation_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"unknown_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["kind","metric","definition_version","observation_count","failed_count","unknown_count"],"additionalProperties":false}],"nullable":true}},"required":["status","reason","evaluated_at","window","value","evidence"],"additionalProperties":false},"last_fired_at":{"type":"string","format":"date-time","nullable":true},"blocked_by_delivery_id":{"type":"string","format":"uuid","nullable":true},"latest_delivery":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rule_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"status":{"type":"string","enum":["pending","sending","delivered","cancelled","uncertain"]},"destination_kind":{"type":"string","enum":["slack","pagerduty","webhook"]},"destination_revision":{"type":"string","minLength":1},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"threshold":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"evidence":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["usage_view"]},"view":{"type":"object","properties":{"schema_version":{"type":"string","enum":["1"]},"scope":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","tenant_id"],"additionalProperties":false},"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"as_of":{"type":"string","format":"date-time"},"snapshot":{"type":"string","maxLength":4096,"pattern":"^[0-9]+:[0-9]+:(?:[0-9]+(?:,[0-9]+)*)?$"},"cohort":{"type":"object","properties":{"observation_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["observation_count","sha256"],"additionalProperties":false}},"required":["schema_version","scope","window","as_of","snapshot","cohort"],"additionalProperties":false},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","view","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["usage_statement"]},"statement_id":{"type":"string","format":"uuid"},"basis":{"type":"string","enum":["declared_estimate"]},"currency":{"type":"string","enum":["USD"]},"coverage":{"type":"string","enum":["recorded_measurements_only"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","statement_id","basis","currency","coverage","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gateway_attempt_latency"]},"observation_count":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","observation_count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["talos_metric"]},"metric":{"type":"string","enum":["call_error_rate_24h","recording_failure_rate_24h"]},"definition_version":{"type":"number","enum":[1]},"observation_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"unknown_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["kind","metric","definition_version","observation_count","failed_count","unknown_count"],"additionalProperties":false}],"nullable":true},"created_at":{"type":"string","format":"date-time"},"send_intent_at":{"type":"string","format":"date-time","nullable":true},"finished_at":{"type":"string","format":"date-time","nullable":true},"error_code":{"type":"string","minLength":1,"nullable":true},"acknowledged_at":{"type":"string","format":"date-time","nullable":true}},"required":["id","rule_revision","status","destination_kind","destination_revision","value","threshold","window","evidence","created_at","send_intent_at","finished_at","error_code","acknowledged_at"],"additionalProperties":false,"nullable":true}},"required":["id","revision","metric","threshold","destination","enabled","deleted_at","evaluation","last_fired_at","blocked_by_delivery_id","latest_delivery"],"additionalProperties":false},"maxItems":1000}},"required":["scope","rows"],"additionalProperties":false},"AlertsUpdateRequest":{"type":"object","properties":{"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"rule":{"type":"object","properties":{"metric":{"type":"string","enum":["spend_usd_per_hour","p95_latency_ms_1h","call_error_rate_24h","recording_failure_rate_24h"]},"threshold":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"enabled":{"type":"boolean"},"destination":{"anyOf":[{"type":"object","properties":{"action":{"type":"string","enum":["keep"]}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["replace"]},"value":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["slack"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["pagerduty"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["webhook"]},"url":{"type":"string","format":"uri","maxLength":4096}},"required":["kind","url"],"additionalProperties":false}]}},"required":["action","value"],"additionalProperties":false}]}},"required":["metric","threshold","enabled","destination"],"additionalProperties":false}},"required":["expected_revision","rule"],"additionalProperties":false},"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthenticated","forbidden","not_found","conflict","invalid_request","idempotency_conflict","policy_denied","capability_unavailable","provider_unavailable","knowledge_unavailable","publication_invalid","run_not_active","rate_limited","outcome_unknown","internal"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"outcome":{"type":"string","enum":["none","unknown"]},"details":{"type":"object","additionalProperties":{}}},"required":["code","message","retryable","outcome"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"ApiKey":{"type":"object","properties":{"key_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":128},"role":{"type":"string","enum":["admin","member","viewer"]},"can_dial":{"type":"boolean"},"prefix":{"type":"string","minLength":4,"maxLength":32},"created_at":{"type":"string","format":"date-time"},"last_used_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"expires_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"revoked_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["key_id","name","role","can_dial","prefix","created_at","last_used_at","expires_at","revoked_at"],"additionalProperties":false},"ApiKeyCreated":{"type":"object","properties":{"key_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":128},"role":{"type":"string","enum":["admin","member","viewer"]},"can_dial":{"type":"boolean"},"prefix":{"type":"string","minLength":4,"maxLength":32},"created_at":{"type":"string","format":"date-time"},"last_used_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"expires_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"revoked_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"secret":{"type":"string","minLength":16,"maxLength":256}},"required":["key_id","name","role","can_dial","prefix","created_at","last_used_at","expires_at","revoked_at","secret"],"additionalProperties":false},"Assertion":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["node_visited"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"node_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"minItems":1,"maxItems":20},"match":{"type":"string","enum":["any","all"],"default":"any"},"by_turn":{"type":"integer","minimum":0}},"required":["type","id","node_ids"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node_not_visited"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"node_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"minItems":1,"maxItems":20}},"required":["type","id","node_ids"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["path"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"node_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"minItems":1,"maxItems":50},"order":{"type":"string","enum":["exact","subsequence"]}},"required":["type","id","node_ids","order"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["turn_lands"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"step":{"type":"integer","minimum":1,"maximum":30},"node_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20}},"required":["type","id","step","node_ids"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["final_node"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"node_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"minItems":1,"maxItems":20}},"required":["type","id","node_ids"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["ended"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"reasons":{"type":"array","items":{"type":"string","enum":["completed","transferred","caller_hangup","max_turns","timeout","failed","cancelled","inactivity"]},"minItems":1,"maxItems":8}},"required":["type","id","reasons"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["transfer"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"expected":{"type":"boolean"},"node_id":{"type":"string","minLength":1,"maxLength":128}},"required":["type","id","expected"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["disposition"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"in":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"minItems":1,"maxItems":32}},"required":["type","id","in"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["tool_called"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"action_id":{"type":"string","minLength":1,"maxLength":128},"args":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","maxLength":256,"pattern":"^(\\/[^/]*)*$"},"op":{"type":"string","enum":["equals","one_of","contains","regex","exists","absent","number_range"]},"value":{}},"required":["path","op"],"additionalProperties":false},"maxItems":10,"default":[]},"before_node":{"type":"string","minLength":1,"maxLength":128},"times":{"type":"object","properties":{"min":{"type":"integer","minimum":0},"max":{"type":"integer","minimum":0}},"required":["min"],"additionalProperties":false,"default":{"min":1}}},"required":["type","id","action_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["tool_not_called"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"action_id":{"type":"string","minLength":1,"maxLength":128}},"required":["type","id","action_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["variable"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"matcher":{"type":"object","properties":{"op":{"type":"string","enum":["equals","one_of","contains","regex","exists","absent","number_range"]},"value":{}},"required":["op"],"additionalProperties":false}},"required":["type","id","name","matcher"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent_says"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"expect":{"type":"string","enum":["never","at_least_once"]},"match":{"anyOf":[{"type":"object","properties":{"patterns":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256},"minItems":1,"maxItems":20}},"required":["patterns"],"additionalProperties":false},{"type":"object","properties":{"lexicon":{"type":"string","enum":["debt_disclosure"]}},"required":["lexicon"],"additionalProperties":false}]},"scope":{"type":"object","properties":{"until_node":{"type":"string","minLength":1,"maxLength":128},"from_turn":{"type":"integer","minimum":0},"until_step":{"type":"integer","minimum":1,"maximum":30}},"additionalProperties":false,"default":{}}},"required":["type","id","expect","match"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent_language"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"language":{"type":"string","enum":["en","es"]},"min_share":{"type":"number","minimum":0,"maximum":1},"after":{"type":"string","enum":["start","caller_switch"]}},"required":["type","id","language","min_share","after"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rubric"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z][a-z0-9_]*$"},"question":{"type":"string","minLength":1,"maxLength":500},"scale":{"type":"string","enum":["binary","1-5"],"default":"binary"},"weight":{"type":"integer","minimum":1,"maximum":10,"default":1},"required":{"type":"boolean","default":false},"allow_na":{"type":"boolean","default":false}},"required":["id","question"],"additionalProperties":false},"minItems":1,"maxItems":12},"threshold":{"type":"number","minimum":0,"maximum":1}},"required":["type","id","criteria","threshold"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["response_latency"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"p50_ms":{"type":"integer","exclusiveMinimum":true,"minimum":0},"p95_ms":{"type":"integer","exclusiveMinimum":true,"minimum":0},"max_ms":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["type","id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["greeting_latency"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"max_ms":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["type","id","max_ms"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["no_cut_off"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"max":{"type":"integer","minimum":0}},"required":["type","id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["barge_in"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"max_stop_ms":{"type":"integer","minimum":100,"maximum":5000,"default":1000}},"required":["type","id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["no_false_yield"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"}},"required":["type","id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["answer_verdict"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"contact":{"type":"array","items":{"type":"string","enum":["human","voicemail","ivr","unknown"]},"minItems":1,"maxItems":4},"reasons":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"minItems":1,"maxItems":10}},"required":["type","id","contact"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["talk_over"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"max_ms":{"type":"integer","minimum":0,"maximum":30000}},"required":["type","id","max_ms"],"additionalProperties":false}]},"AuditListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"audit_id":{"type":"string","format":"uuid"},"occurred_at":{"type":"string","format":"date-time"},"principal":{"$ref":"#/components/schemas/PrincipalRef"},"action":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"resource":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent","publication","run","document","knowledge_generation","evaluation","comparison","trunk","phone_number","secret","operation","model","gpu_host","gpu_deployment"]},"id":{"type":"string","minLength":1,"maxLength":512}},"required":["tenant_id","kind","id"],"additionalProperties":false,"nullable":true},"outcome":{"type":"string","enum":["allowed","denied","failed"]},"request_id":{"type":"string","maxLength":256,"nullable":true}},"required":["audit_id","occurred_at","principal","action","resource","outcome","request_id"],"additionalProperties":false}},"next_cursor":{"type":"string","maxLength":1024,"nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"BudgetsGetResponse200":{"type":"object","properties":{"configured":{"type":"boolean"},"budget_id":{"type":"string","pattern":"^[a-zA-Z0-9_.:/-]{1,160}$","nullable":true},"policy_id":{"type":"string","pattern":"^[a-zA-Z0-9_.:/-]{1,160}$","nullable":true},"period":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false,"nullable":true},"cap_usd":{"allOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"}],"nullable":true},"spent_usd":{"allOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"}],"nullable":true},"remaining_usd":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$","nullable":true},"exceeded":{"type":"boolean"},"unresolved_runs":{"type":"integer","minimum":0},"as_of":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["configured","budget_id","policy_id","period","cap_usd","spent_usd","remaining_usd","exceeded","unresolved_runs","as_of"],"additionalProperties":false},"BudgetsUpdateRequest":{"type":"object","properties":{"cap_usd":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"},"expected_policy_id":{"type":"string","pattern":"^[a-zA-Z0-9_.:/-]{1,160}$"}},"required":["cap_usd","expected_policy_id"],"additionalProperties":false},"ByocNumber":{"type":"object","properties":{"number_id":{"type":"string","format":"uuid"},"e164":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"},"trunk_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"nickname":{"type":"string","maxLength":256,"nullable":true},"inbound_agent_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}],"nullable":true},"outbound_agent_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}],"nullable":true},"inbound_agent_version":{"type":"integer","minimum":0,"nullable":true,"description":"Stored inbound publication pin, including legacy version 0; null when unassigned. Publishing a newer head does not change it."},"outbound_agent_version":{"type":"integer","minimum":0,"nullable":true,"description":"Stored outbound publication version; null when unassigned."},"state":{"type":"string","enum":["pending","ready"]},"created_at":{"type":"string","format":"date-time"}},"required":["number_id","e164","trunk_id","nickname","inbound_agent_id","outbound_agent_id","inbound_agent_version","outbound_agent_version","state","created_at"],"additionalProperties":false},"ByocTrunk":{"type":"object","properties":{"trunk_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"name":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","enum":["twilio_elastic_sip","generic_sip"]},"termination_uri":{"type":"string","minLength":1,"maxLength":253,"pattern":"^[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?$"},"auth_username":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"auth_secret":{"allOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}],"nullable":true},"inbound":{"type":"boolean"},"inbound_sip_uri":{"type":"string","maxLength":1024,"nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["trunk_id","name","provider","termination_uri","auth_username","auth_secret","inbound","created_at","updated_at"],"additionalProperties":false},"CallLimitsGetResponse200":{"type":"object","properties":{"configured":{"type":"boolean"},"daily_outbound_limit":{"type":"integer","minimum":1,"maximum":10000000,"nullable":true},"outbound_last_24h":{"type":"integer","minimum":0}},"required":["configured","daily_outbound_limit","outbound_last_24h"],"additionalProperties":false},"CallLimitsUpdateRequest":{"type":"object","properties":{"daily_outbound_limit":{"type":"integer","minimum":1,"maximum":10000000,"nullable":true}},"required":["daily_outbound_limit"],"additionalProperties":false},"Comparison":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"comparison_id":{"type":"string","format":"uuid"},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"baseline":{"$ref":"#/components/schemas/PublicationRef"},"candidate":{"$ref":"#/components/schemas/PublicationRef"},"case_run_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200},"state":{"type":"string","enum":["queued","running","completed","failed","uncertain"]},"summary":{"allOf":[{"type":"object","properties":{"cases":{"type":"integer"},"candidate_wins":{"type":"integer"},"baseline_wins":{"type":"integer"},"ties":{"type":"integer"},"unscored":{"type":"integer"}},"required":["cases","candidate_wins","baseline_wins","ties","unscored"],"additionalProperties":false}],"nullable":true},"rubric":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","version"],"additionalProperties":false},"judge_model":{"$ref":"#/components/schemas/ModelIdentity"},"error_code":{"type":"string","maxLength":128,"nullable":true},"finished_at":{"type":"string","format":"date-time","nullable":true},"created_by":{"$ref":"#/components/schemas/PrincipalRef"},"created_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","comparison_id","agent_id","baseline","candidate","case_run_ids","state","summary","rubric","judge_model","error_code","finished_at","created_by","created_at"],"additionalProperties":false},"ComparisonsCreateRequest":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"baseline_version":{"type":"integer","minimum":0,"maximum":2147483647},"candidate_version":{"type":"integer","minimum":0,"maximum":2147483647},"case_run_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200},"rubric":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","version"],"additionalProperties":false}},"required":["agent_id","baseline_version","candidate_version","case_run_ids","rubric"],"additionalProperties":false},"ComparisonsGetResponse200":{"type":"object","properties":{"comparison":{"$ref":"#/components/schemas/Comparison"},"cases":{"type":"array","items":{"type":"object","properties":{"ordinal":{"type":"integer","minimum":0,"maximum":199},"source_run_id":{"type":"string","format":"uuid"},"baseline_run_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"candidate_run_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"state":{"type":"string","enum":["pending","running","judging","settled","failed","uncertain"]},"verdict":{"type":"string","enum":["candidate","baseline","tie"],"nullable":true},"baseline_score":{"type":"number","minimum":0,"maximum":1,"nullable":true},"candidate_score":{"type":"number","minimum":0,"maximum":1,"nullable":true},"judge_measurement_id":{"type":"string","format":"uuid","nullable":true},"error_code":{"type":"string","maxLength":128,"nullable":true},"content_state":{"type":"string","enum":["retained","expired"]}},"required":["ordinal","source_run_id","baseline_run_id","candidate_run_id","state","verdict","baseline_score","candidate_score","judge_measurement_id","error_code","content_state"],"additionalProperties":false},"maxItems":200}},"required":["comparison","cases"],"additionalProperties":false},"ComparisonsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comparison"}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"ContentRef":{"type":"object","properties":{"artifact_id":{"type":"string","format":"uuid"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"byte_size":{"type":"integer","minimum":0},"media_type":{"type":"string","minLength":1,"maxLength":128},"expires_at":{"type":"string","format":"date-time","nullable":true}},"required":["artifact_id","sha256","byte_size","media_type","expires_at"],"additionalProperties":false},"Deleted":{"type":"object","properties":{"deleted":{"type":"boolean","enum":[true]}},"required":["deleted"],"additionalProperties":false},"DeletionReceipt":{"type":"object","properties":{"receipt_id":{"type":"string","format":"uuid"},"artifact_id":{"type":"string","format":"uuid"},"store":{"type":"string","enum":["s3","postgres"]},"locator":{"type":"object","properties":{"bucket":{"type":"string","nullable":true},"key":{"type":"string","nullable":true},"version_ids":{"type":"array","items":{"type":"string"},"default":[]}},"required":["bucket","key"],"additionalProperties":false},"request_id":{"type":"string","nullable":true},"deleted_sha256":{"allOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"}],"nullable":true},"provider_copies":{"type":"string","enum":["none","declared_provider_retention"]},"purged_at":{"type":"string","format":"date-time"}},"required":["receipt_id","artifact_id","store","locator","request_id","deleted_sha256","provider_copies","purged_at"],"additionalProperties":false},"Diagnostic":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":128},"path":{"type":"string","maxLength":1024},"message":{"type":"string","maxLength":4096},"severity":{"type":"string","enum":["warning","error"]},"fixes":{"type":"array","items":{"$ref":"#/components/schemas/DiagnosticFix"},"maxItems":8}},"required":["code","path","message","severity"],"additionalProperties":false},"DiagnosticFix":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":256},"edits":{"type":"array","items":{"$ref":"#/components/schemas/DraftEdit"},"minItems":1,"maxItems":100}},"required":["id","label","edits"],"additionalProperties":false},"Document":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1,"maxLength":512},"source_name":{"type":"string","minLength":1,"maxLength":512},"media_type":{"type":"string","enum":["text/plain","text/markdown","text/html","application/pdf"]},"byte_size":{"type":"integer","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"state":{"type":"string","enum":["uploaded","indexing","ready","failed","deleting"]},"created_at":{"type":"string","format":"date-time"},"expires_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["document_id","title","source_name","media_type","byte_size","sha256","state","created_at","expires_at"],"additionalProperties":false},"DocumentsDeleteResponse200":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"receipts":{"type":"array","items":{"$ref":"#/components/schemas/DeletionReceipt"}}},"required":["document_id","receipts"],"additionalProperties":false},"DocumentsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Document"}},"next_cursor":{"type":"string","maxLength":1024,"nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"DocumentsUploadRequest":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":512},"source_name":{"type":"string","minLength":1,"maxLength":512},"media_type":{"type":"string","enum":["text/plain","text/markdown","text/html","application/pdf"]},"content":{"anyOf":[{"type":"object","properties":{"encoding":{"type":"string","enum":["utf8"]},"text":{"type":"string","minLength":1,"maxLength":2000000}},"required":["encoding","text"],"additionalProperties":false},{"type":"object","properties":{"encoding":{"type":"string","enum":["base64"]},"data":{"type":"string","minLength":4,"maxLength":14000000,"pattern":"^[A-Za-z0-9+/]+={0,2}$"}},"required":["encoding","data"],"additionalProperties":false}]}},"required":["title","source_name","media_type","content"],"additionalProperties":false},"DraftEdit":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["agent.name"]},"name":{"type":"string","minLength":1,"maxLength":256}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent.settings"]},"values":{"type":"object","properties":{"voiceId":{"type":"string","minLength":1,"maxLength":256},"voiceModel":{"type":"string","minLength":1,"maxLength":256},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2},"voiceTemperature":{"type":"number","minimum":0,"maximum":2},"volume":{"type":"number","minimum":0,"maximum":2},"language":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"array","items":{"type":"string","minLength":1,"maxLength":256},"minItems":1}]},"responsiveness":{"type":"number","minimum":0,"maximum":1},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1},"enableBackchannel":{"type":"boolean"},"backchannelFrequency":{"type":"number","minimum":0,"maximum":1},"backchannelWords":{"type":"array","items":{"type":"string"}},"reminderTriggerMs":{"type":"integer","minimum":0,"maximum":3600000},"reminderMaxCount":{"type":"integer","minimum":0,"maximum":100},"maxCallDurationMs":{"type":"integer","minimum":1000,"maximum":86400000},"endCallAfterSilenceMs":{"type":"integer","minimum":1000,"maximum":3600000},"ringDurationMs":{"type":"integer","minimum":1000,"maximum":300000},"beginMessageDelayMs":{"type":"integer","minimum":0,"maximum":60000},"normalizeForSpeech":{"type":"boolean"},"openerWaitsForCallee":{"type":"boolean"},"voicemail":{"type":"object","properties":{"enabled":{"type":"boolean"},"detectionTimeoutMs":{"type":"integer","exclusiveMinimum":true,"minimum":0},"action":{"type":"string","enum":["hangup","leave_message"]},"message":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false}},"required":["enabled"],"additionalProperties":false},"ambientSound":{"type":"string"},"ambientSoundVolume":{"type":"number","minimum":0,"maximum":2},"boostedKeywords":{"type":"array","items":{"type":"string"}},"pronunciationDictionary":{"type":"array","items":{"type":"object","properties":{"word":{"type":"string","minLength":1,"maxLength":256},"alphabet":{"type":"string","enum":["ipa","cmu"]},"phoneme":{"type":"string","minLength":1,"maxLength":256}},"required":["word","alphabet","phoneme"],"additionalProperties":false}},"denoisingMode":{"type":"string"},"sttMode":{"type":"string"},"allowUserDtmf":{"type":"boolean"},"allowDtmfInterruption":{"type":"boolean"},"userDtmfOptions":{"type":"object","properties":{"digitLimit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"nullable":true},"terminationKey":{"type":"string","enum":["0","1","2","3","4","5","6","7","8","9","*","#"],"nullable":true},"timeoutMs":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"additionalProperties":false,"nullable":true},"dataStorageSetting":{"type":"string","enum":["everything","everything_except_pii","basic_attributes_only"]},"optInSignedUrl":{"type":"boolean"},"piiConfig":{"type":"object","properties":{"mode":{"type":"string","enum":["post_call"]},"categories":{"type":"array","items":{"type":"string","enum":["person_name","address","email","phone_number","ssn","passport","driver_license","credit_card","bank_account","password","pin","medical_id","date_of_birth","customer_account_number"]}}},"required":["mode","categories"],"additionalProperties":false},"handbookConfig":{"type":"object","properties":{"defaultPersonality":{"type":"boolean"},"conversationalPersonality":{"type":"boolean"},"naturalFillerWords":{"type":"boolean"},"highEmpathy":{"type":"boolean"},"echoVerification":{"type":"boolean"},"natoPhoneticAlphabet":{"type":"boolean"},"speechNormalization":{"type":"boolean"},"smartMatching":{"type":"boolean"},"aiDisclosure":{"type":"boolean"},"scopeBoundaries":{"type":"boolean"}},"additionalProperties":false},"ivr":{"anyOf":[{"type":"object","properties":{"enabled":{"type":"boolean","enum":[false]}},"required":["enabled"],"additionalProperties":false},{"type":"object","properties":{"enabled":{"type":"boolean","enum":[true]},"action":{"type":"string","enum":["hangup"]},"detectionWindowMs":{"type":"number","enum":[180000]},"detectionPrompt":{"type":"string","nullable":true}},"required":["enabled","action","detectionWindowMs"],"additionalProperties":false}]},"screener":{"anyOf":[{"type":"object","properties":{"action":{"type":"string","enum":["hangup"]}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["wait"]},"waitMs":{"type":"integer","minimum":5000,"maximum":120000}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["play_line"]},"waitMs":{"type":"integer","minimum":5000,"maximum":120000},"line":{"type":"object","properties":{"en":{"type":"string","minLength":1,"maxLength":500},"es":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false}},"required":["action","line"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["treat_as_human"]}},"required":["action"],"additionalProperties":false}]},"postCallAnalysisModel":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false}},"required":["model"],"additionalProperties":false},"compliance":{"type":"object","properties":{"profile":{"type":"string","enum":["fdcpa"]}},"additionalProperties":false}},"additionalProperties":false},"clear":{"type":"array","items":{"type":"string","enum":["voiceId","voiceModel","voiceSpeed","voiceTemperature","volume","language","responsiveness","interruptionSensitivity","enableBackchannel","backchannelFrequency","backchannelWords","reminderTriggerMs","reminderMaxCount","maxCallDurationMs","endCallAfterSilenceMs","ringDurationMs","beginMessageDelayMs","normalizeForSpeech","openerWaitsForCallee","voicemail","ambientSound","ambientSoundVolume","boostedKeywords","pronunciationDictionary","denoisingMode","sttMode","allowUserDtmf","allowDtmfInterruption","userDtmfOptions","dataStorageSetting","optInSignedUrl","piiConfig","handbookConfig","ivr","screener","postCallAnalysisModel","compliance"]}}},"required":["type","values","clear"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent.analysis"]},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}},"examples":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}}},"required":["type","fields"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent.provider"]},"role":{"type":"string","enum":["stt","llm","tts"]},"changes":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":256},"model":{"type":"string","minLength":1,"maxLength":256},"voiceId":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"endpoint":{"type":"string","format":"uri","nullable":true},"credential":{"allOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}],"nullable":true}},"additionalProperties":false},{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"allOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false}],"nullable":true},"provider":{"type":"string","enum":["openai","simulated_openai","self_hosted","simulated_self_hosted"]},"endpoint":{"type":"string","format":"uri","nullable":true}},"additionalProperties":false}]}},"required":["type","role","changes"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent.telephony"]},"value":{"type":"object","properties":{"trunkId":{"type":"string","minLength":1,"maxLength":256},"from":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"}},"required":["trunkId"],"additionalProperties":false}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent.recording"]},"value":{"type":"object","properties":{"required":{"type":"boolean"},"channels":{"type":"string","enum":["dual"]}},"required":["required","channels"],"additionalProperties":false}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["phone.inbound_context"]},"value":{"allOf":[{"type":"object","properties":{"action_id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,62}$"},"variables":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_.-]{0,127}$"},"minItems":1,"maxItems":256}},"required":["action_id","variables"],"additionalProperties":false}],"nullable":true}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["flow.prompt"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node.name"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node_id":{"type":"string","minLength":1,"maxLength":256},"name":{"type":"string","nullable":true}},"required":["type","component_id","node_id","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node.instruction"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node_id":{"type":"string","minLength":1,"maxLength":256},"instruction":{"allOf":[{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false}],"nullable":true}},"required":["type","component_id","node_id","instruction"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node.transitions"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node_id":{"type":"string","minLength":1,"maxLength":256},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"destinationNodeId":{"type":"string","minLength":1,"maxLength":256},"slot":{"type":"string","enum":["edges","else_edge","skip_response_edge","always_edge","edge","success_edge"]},"condition":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["always"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["prompt"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"operator":{"type":"string","enum":["&&","||"]},"equations":{"type":"array","items":{"type":"object","properties":{"left":{"type":"string"},"operator":{"type":"string","enum":["==","!=",">","<",">=","<=","contains","is_set","is_not_set"]},"right":{"type":"string"}},"required":["left","operator","right"],"additionalProperties":false},"minItems":1}},"required":["type","operator","equations"],"additionalProperties":false}]},"compliance":{"type":"object","properties":{"sets":{"type":"array","items":{"type":"string","enum":["rpc_confirmed"]},"minItems":1}},"required":["sets"],"additionalProperties":false}},"required":["slot","condition"],"additionalProperties":false}}},"required":["type","component_id","node_id","edges"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node.configure"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node_id":{"type":"string","minLength":1,"maxLength":256},"changes":{"type":"object","properties":{"name":{"type":"string","nullable":true},"instruction":{"allOf":[{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false}],"nullable":true},"startSpeaker":{"type":"string","enum":["agent","user"],"nullable":true},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1,"nullable":true},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2,"nullable":true},"languageLocked":{"type":"boolean","nullable":true},"globalNodeSetting":{"type":"object","properties":{"condition":{"type":"string"},"coolDown":{"type":"number","minimum":0}},"required":["condition"],"additionalProperties":false,"nullable":true},"toolId":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"waitForResult":{"type":"boolean","nullable":true},"speakDuringExecution":{"type":"boolean","nullable":true},"executionMessage":{"allOf":[{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false}],"nullable":true},"transfer":{"type":"object","properties":{"destination":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["predefined"]},"number":{"type":"string","maxLength":256}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["inferred"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false}]},"option":{"type":"object","properties":{"type":{"type":"string","enum":["cold_transfer","warm_transfer"]},"showTransfereeAsCaller":{"type":"boolean"},"optOutHumanDetection":{"type":"boolean"},"enableBridgeAudioCue":{"type":"boolean"},"onHoldMusic":{"type":"string"},"agentDetectionTimeoutMs":{"type":"integer","minimum":0},"agentDetectionPrompt":{"type":"string"},"transferMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"privateHandoffMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"coldTransferMode":{"type":"string"}},"required":["type"],"additionalProperties":false},"ignoreE164Validation":{"type":"boolean"}},"required":["destination","option","ignoreE164Validation"],"additionalProperties":false,"nullable":true},"variables":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false},"nullable":true},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false,"nullable":true},"componentId":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"verification":{"allOf":[{"type":"object","properties":{"subjectVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"expectedVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"privateAliases":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"maxItems":16},"enabledVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"format":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["digits"]},"length":{"type":"integer","minimum":1,"maximum":32}},"required":["kind","length"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["date_yyyymmdd"]}},"required":["kind"],"additionalProperties":false}]},"prompt":{"type":"object","properties":{"en":{"type":"string"},"es":{"type":"string"}},"required":["en"],"additionalProperties":false}},"required":["id","expectedVariable","enabledVariable","format","prompt"],"additionalProperties":false},"maxItems":8},"required":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["fixed"]},"count":{"type":"integer","minimum":1,"maximum":8}},"required":["kind","count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false}]},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"lookup":{"type":"object","properties":{"toolId":{"type":"string","minLength":1},"fieldId":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"variable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["parameter","variable"],"additionalProperties":false},"maxItems":64}},"required":["toolId","fieldId","parameter","arguments"],"additionalProperties":false}},"required":["subjectVariable","fields","required","timeoutMs"],"additionalProperties":false}],"nullable":true},"tokenization":{"allOf":[{"type":"object","properties":{"toolId":{"type":"string","maxLength":256},"subjectVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"consentPrompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"minDigits":{"type":"integer","minimum":1,"maximum":32},"maxDigits":{"type":"integer","minimum":1,"maximum":32},"encoding":{"type":"string","enum":["string","integer"]},"minimum":{"type":"integer","minimum":0,"maximum":999999999},"maximum":{"type":"integer","minimum":0,"maximum":999999999},"prompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false}},"required":["id","parameter","minDigits","maxDigits","encoding","prompt"],"additionalProperties":false},"maxItems":7},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["constant"]},"value":{"anyOf":[{"type":"string","maxLength":512},{"type":"number"},{"type":"boolean"}],"nullable":true}},"required":["kind","value"],"additionalProperties":false}]}},"required":["parameter","source"],"additionalProperties":false},"maxItems":64},"tokenIdPath":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"tokenVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Variable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Field":{"type":"string","maxLength":64}},"required":["toolId","subjectVariable","consentPrompt","timeoutMs","fields","arguments","tokenIdPath","tokenVariable","last4Variable","last4Field"],"additionalProperties":false}],"nullable":true}},"additionalProperties":false}},"required":["type","component_id","node_id","changes"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node.create"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["conversation","end","branch","transfer_call","function","extract_dynamic_variables","verify_identity","tokenize_private","component"]},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"destinationNodeId":{"type":"string","minLength":1,"maxLength":256},"slot":{"type":"string","enum":["edges","else_edge","skip_response_edge","always_edge","edge","success_edge"]},"condition":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["always"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["prompt"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"operator":{"type":"string","enum":["&&","||"]},"equations":{"type":"array","items":{"type":"object","properties":{"left":{"type":"string"},"operator":{"type":"string","enum":["==","!=",">","<",">=","<=","contains","is_set","is_not_set"]},"right":{"type":"string"}},"required":["left","operator","right"],"additionalProperties":false},"minItems":1}},"required":["type","operator","equations"],"additionalProperties":false}]},"compliance":{"type":"object","properties":{"sets":{"type":"array","items":{"type":"string","enum":["rpc_confirmed"]},"minItems":1}},"required":["sets"],"additionalProperties":false}},"required":["slot","condition"],"additionalProperties":false}},"name":{"type":"string"},"instruction":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"startSpeaker":{"type":"string","enum":["agent","user"]},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2},"languageLocked":{"type":"boolean"},"globalNodeSetting":{"type":"object","properties":{"condition":{"type":"string"},"coolDown":{"type":"number","minimum":0}},"required":["condition"],"additionalProperties":false},"toolId":{"type":"string","minLength":1,"maxLength":256},"waitForResult":{"type":"boolean"},"speakDuringExecution":{"type":"boolean"},"executionMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"transfer":{"type":"object","properties":{"destination":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["predefined"]},"number":{"type":"string","maxLength":256}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["inferred"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false}]},"option":{"type":"object","properties":{"type":{"type":"string","enum":["cold_transfer","warm_transfer"]},"showTransfereeAsCaller":{"type":"boolean"},"optOutHumanDetection":{"type":"boolean"},"enableBridgeAudioCue":{"type":"boolean"},"onHoldMusic":{"type":"string"},"agentDetectionTimeoutMs":{"type":"integer","minimum":0},"agentDetectionPrompt":{"type":"string"},"transferMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"privateHandoffMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"coldTransferMode":{"type":"string"}},"required":["type"],"additionalProperties":false},"ignoreE164Validation":{"type":"boolean"}},"required":["destination","option","ignoreE164Validation"],"additionalProperties":false},"variables":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"componentId":{"type":"string","minLength":1,"maxLength":256},"verification":{"type":"object","properties":{"subjectVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"expectedVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"privateAliases":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"maxItems":16},"enabledVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"format":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["digits"]},"length":{"type":"integer","minimum":1,"maximum":32}},"required":["kind","length"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["date_yyyymmdd"]}},"required":["kind"],"additionalProperties":false}]},"prompt":{"type":"object","properties":{"en":{"type":"string"},"es":{"type":"string"}},"required":["en"],"additionalProperties":false}},"required":["id","expectedVariable","enabledVariable","format","prompt"],"additionalProperties":false},"maxItems":8},"required":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["fixed"]},"count":{"type":"integer","minimum":1,"maximum":8}},"required":["kind","count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false}]},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"lookup":{"type":"object","properties":{"toolId":{"type":"string","minLength":1},"fieldId":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"variable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["parameter","variable"],"additionalProperties":false},"maxItems":64}},"required":["toolId","fieldId","parameter","arguments"],"additionalProperties":false}},"required":["subjectVariable","fields","required","timeoutMs"],"additionalProperties":false},"tokenization":{"type":"object","properties":{"toolId":{"type":"string","maxLength":256},"subjectVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"consentPrompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"minDigits":{"type":"integer","minimum":1,"maximum":32},"maxDigits":{"type":"integer","minimum":1,"maximum":32},"encoding":{"type":"string","enum":["string","integer"]},"minimum":{"type":"integer","minimum":0,"maximum":999999999},"maximum":{"type":"integer","minimum":0,"maximum":999999999},"prompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false}},"required":["id","parameter","minDigits","maxDigits","encoding","prompt"],"additionalProperties":false},"maxItems":7},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["constant"]},"value":{"anyOf":[{"type":"string","maxLength":512},{"type":"number"},{"type":"boolean"}],"nullable":true}},"required":["kind","value"],"additionalProperties":false}]}},"required":["parameter","source"],"additionalProperties":false},"maxItems":64},"tokenIdPath":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"tokenVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Variable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Field":{"type":"string","maxLength":64}},"required":["toolId","subjectVariable","consentPrompt","timeoutMs","fields","arguments","tokenIdPath","tokenVariable","last4Variable","last4Field"],"additionalProperties":false}},"required":["id","kind","edges"],"additionalProperties":false}},"required":["type","component_id","node"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["node.remove"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node_id":{"type":"string","minLength":1,"maxLength":256}},"required":["type","component_id","node_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["flow.configure"]},"changes":{"type":"object","properties":{"startNodeId":{"type":"string","minLength":1,"maxLength":256},"startSpeaker":{"type":"string","enum":["agent","user"]},"globalPrompt":{"type":"string"},"defaultDynamicVariables":{"type":"object","additionalProperties":{"type":"string"}},"callContextVariables":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"modelChoice":{"allOf":[{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false}],"nullable":true},"toolCallStrictMode":{"type":"boolean"}},"additionalProperties":false}},"required":["type","changes"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["component.create"]},"component":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"startNodeId":{"type":"string","minLength":1,"maxLength":256},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["conversation","end","branch","transfer_call","function","extract_dynamic_variables","verify_identity","tokenize_private","component"]},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"destinationNodeId":{"type":"string","minLength":1,"maxLength":256},"slot":{"type":"string","enum":["edges","else_edge","skip_response_edge","always_edge","edge","success_edge"]},"condition":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["always"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["prompt"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"operator":{"type":"string","enum":["&&","||"]},"equations":{"type":"array","items":{"type":"object","properties":{"left":{"type":"string"},"operator":{"type":"string","enum":["==","!=",">","<",">=","<=","contains","is_set","is_not_set"]},"right":{"type":"string"}},"required":["left","operator","right"],"additionalProperties":false},"minItems":1}},"required":["type","operator","equations"],"additionalProperties":false}]},"compliance":{"type":"object","properties":{"sets":{"type":"array","items":{"type":"string","enum":["rpc_confirmed"]},"minItems":1}},"required":["sets"],"additionalProperties":false}},"required":["slot","condition"],"additionalProperties":false}},"name":{"type":"string"},"instruction":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"startSpeaker":{"type":"string","enum":["agent","user"]},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2},"languageLocked":{"type":"boolean"},"globalNodeSetting":{"type":"object","properties":{"condition":{"type":"string"},"coolDown":{"type":"number","minimum":0}},"required":["condition"],"additionalProperties":false},"toolId":{"type":"string","minLength":1,"maxLength":256},"waitForResult":{"type":"boolean"},"speakDuringExecution":{"type":"boolean"},"executionMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"transfer":{"type":"object","properties":{"destination":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["predefined"]},"number":{"type":"string","maxLength":256}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["inferred"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false}]},"option":{"type":"object","properties":{"type":{"type":"string","enum":["cold_transfer","warm_transfer"]},"showTransfereeAsCaller":{"type":"boolean"},"optOutHumanDetection":{"type":"boolean"},"enableBridgeAudioCue":{"type":"boolean"},"onHoldMusic":{"type":"string"},"agentDetectionTimeoutMs":{"type":"integer","minimum":0},"agentDetectionPrompt":{"type":"string"},"transferMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"privateHandoffMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"coldTransferMode":{"type":"string"}},"required":["type"],"additionalProperties":false},"ignoreE164Validation":{"type":"boolean"}},"required":["destination","option","ignoreE164Validation"],"additionalProperties":false},"variables":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"componentId":{"type":"string","minLength":1,"maxLength":256},"verification":{"type":"object","properties":{"subjectVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"expectedVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"privateAliases":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"maxItems":16},"enabledVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"format":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["digits"]},"length":{"type":"integer","minimum":1,"maximum":32}},"required":["kind","length"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["date_yyyymmdd"]}},"required":["kind"],"additionalProperties":false}]},"prompt":{"type":"object","properties":{"en":{"type":"string"},"es":{"type":"string"}},"required":["en"],"additionalProperties":false}},"required":["id","expectedVariable","enabledVariable","format","prompt"],"additionalProperties":false},"maxItems":8},"required":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["fixed"]},"count":{"type":"integer","minimum":1,"maximum":8}},"required":["kind","count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false}]},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"lookup":{"type":"object","properties":{"toolId":{"type":"string","minLength":1},"fieldId":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"variable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["parameter","variable"],"additionalProperties":false},"maxItems":64}},"required":["toolId","fieldId","parameter","arguments"],"additionalProperties":false}},"required":["subjectVariable","fields","required","timeoutMs"],"additionalProperties":false},"tokenization":{"type":"object","properties":{"toolId":{"type":"string","maxLength":256},"subjectVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"consentPrompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"minDigits":{"type":"integer","minimum":1,"maximum":32},"maxDigits":{"type":"integer","minimum":1,"maximum":32},"encoding":{"type":"string","enum":["string","integer"]},"minimum":{"type":"integer","minimum":0,"maximum":999999999},"maximum":{"type":"integer","minimum":0,"maximum":999999999},"prompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false}},"required":["id","parameter","minDigits","maxDigits","encoding","prompt"],"additionalProperties":false},"maxItems":7},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["constant"]},"value":{"anyOf":[{"type":"string","maxLength":512},{"type":"number"},{"type":"boolean"}],"nullable":true}},"required":["kind","value"],"additionalProperties":false}]}},"required":["parameter","source"],"additionalProperties":false},"maxItems":64},"tokenIdPath":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"tokenVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Variable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Field":{"type":"string","maxLength":64}},"required":["toolId","subjectVariable","consentPrompt","timeoutMs","fields","arguments","tokenIdPath","tokenVariable","last4Variable","last4Field"],"additionalProperties":false}},"required":["id","kind","edges"],"additionalProperties":false},"minItems":1},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"parameters":{"type":"object","additionalProperties":{}},"responseVariables":{"type":"object","additionalProperties":{"type":"string"}},"timeoutMs":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responseVariablePolicy":{"type":"string","enum":["required","replace_available"]},"argsAtRoot":{"type":"boolean"},"parameterType":{"type":"string","enum":["json"]},"speakAfterExecution":{"type":"boolean"},"id":{"type":"string","minLength":1,"maxLength":256},"credential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","version"],"additionalProperties":false}},"required":["name","description","url","method","parameters","responseVariables","timeoutMs","argsAtRoot","parameterType","id"],"additionalProperties":false}},"flexMode":{"type":"boolean"}},"required":["id","startNodeId","nodes","tools"],"additionalProperties":false}},"required":["type","component"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["component.start"]},"component_id":{"type":"string","minLength":1,"maxLength":256},"start_node_id":{"type":"string","minLength":1,"maxLength":256}},"required":["type","component_id","start_node_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["component.remove"]},"component_id":{"type":"string","minLength":1,"maxLength":256}},"required":["type","component_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["transfer.credential"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"node_id":{"type":"string","minLength":1,"maxLength":256},"credential":{"anyOf":[{"type":"object","properties":{"action":{"type":"string","enum":["keep"]}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["replace"]},"reference":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["action","reference"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["remove"]}},"required":["action"],"additionalProperties":false}]},"clear_inline":{"type":"boolean"}},"required":["type","component_id","node_id","credential","clear_inline"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["channels.set"]},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1,"maxItems":2}},"required":["type","channels"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["languages.set"]},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1,"maxItems":2}},"required":["type","languages"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["trigger.put"]},"trigger":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["schedule"]},"id":{"type":"string","minLength":1,"maxLength":128},"cron":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string","minLength":1,"maxLength":64},"input":{"type":"object","additionalProperties":{}}},"required":["kind","id","cron","timezone","input"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["event"]},"id":{"type":"string","minLength":1,"maxLength":128},"event_type":{"type":"string","enum":["run.ended","analysis.updated"]},"source":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"channel":{"type":"string","enum":["cloud","phone","web"]},"dispositions":{"type":"array","items":{"type":"string","minLength":1},"maxItems":32}},"additionalProperties":false},"input_mapping":{"type":"object","additionalProperties":{"type":"string","pattern":"^\\/[A-Za-z0-9_/-]*$"}}},"required":["kind","id","event_type","source","input_mapping"],"additionalProperties":false}]}},"required":["type","trigger"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["trigger.remove"]},"trigger_id":{"type":"string","minLength":1,"maxLength":128}},"required":["type","trigger_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["action.put"]},"action":{"type":"object","properties":{"purpose":{"type":"string","enum":["tokenization"]},"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,62}$"},"description":{"type":"string","minLength":1,"maxLength":1024},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":1024},"default":{}},"auth":{"anyOf":[{"type":"object","properties":{"scheme":{"type":"string","enum":["none"]}},"required":["scheme"],"additionalProperties":false},{"type":"object","properties":{"scheme":{"type":"string","enum":["bearer","basic"]},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["scheme","secret_ref"],"additionalProperties":false},{"type":"object","properties":{"scheme":{"type":"string","enum":["retell_signature"]},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["scheme","secret_ref"],"additionalProperties":false},{"type":"object","properties":{"scheme":{"type":"string","enum":["header"]},"header_name":{"type":"string","minLength":1,"maxLength":128},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["scheme","header_name","secret_ref"],"additionalProperties":false}]},"input_schema":{"type":"object","additionalProperties":{}},"output_schema":{"type":"object","additionalProperties":{}},"idempotency":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["effect_key"]}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","enum":["template"]},"header":{"type":"string","default":"Idempotency-Key"},"template":{"type":"string","minLength":1,"maxLength":512}},"required":["mode","template"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","enum":["none_read_only"]}},"required":["mode"],"additionalProperties":false}]},"timeout_ms":{"type":"integer","minimum":500,"maximum":120000},"on_uncertain":{"type":"string","enum":["failure_edge","uncertain_edge"],"default":"failure_edge"}},"required":["name","description","channels","method","url","auth","input_schema","output_schema","idempotency","timeout_ms"],"additionalProperties":false},"response_variables":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":512},"description":"Flow variables set from the action's 2xx JSON response, name to path ($.account.balance). Omitted keeps the current ones; {} removes them."},"response_variable_policy":{"type":"string","enum":["required","replace_available"]},"speak_after_execution":{"type":"boolean","description":"Generate a spoken response after the action result. False continues routing without an extra reply; omitted preserves the current setting."}},"required":["type","action"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["action.remove"]},"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,62}$"}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["notification.put"]},"notification":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"url":{"type":"string","format":"uri"},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false},"format":{"type":"string","enum":["semantic.v1"]},"events":{"type":"array","items":{"type":"string","enum":["run.admitted","run.ended","recording.updated","analysis.updated"]},"minItems":1}},"required":["id","url","secret_ref","format","events"],"additionalProperties":false}},"required":["type","notification"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["notification.remove"]},"notification_id":{"type":"string","minLength":1,"maxLength":128}},"required":["type","notification_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["knowledge.set"]},"document_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200,"nullable":true}},"required":["type","document_ids"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloud.io.set"]},"cloud":{"type":"object","properties":{"modes":{"type":"array","items":{"type":"string","enum":["task","chat","background"]},"minItems":1},"input_schema":{"type":"object","additionalProperties":{}},"output_schema":{"type":"object","additionalProperties":{}},"max_turns":{"type":"integer","minimum":1,"maximum":200},"idle_timeout_ms":{"type":"integer","minimum":10000,"maximum":86400000},"deadline_ms":{"type":"integer","minimum":1000,"maximum":3600000}},"required":["modes","input_schema","output_schema","max_turns","idle_timeout_ms","deadline_ms"],"additionalProperties":false,"nullable":true}},"required":["type","cloud"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["layout.set"]},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256}],"nullable":true},"nodes":{"type":"object","additionalProperties":{"allOf":[{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000}},"required":["x","y"],"additionalProperties":false}],"nullable":true}},"start":{"allOf":[{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000}},"required":["x","y"],"additionalProperties":false}],"nullable":true},"viewport":{"allOf":[{"type":"object","properties":{"x":{"type":"number","minimum":-10000000,"maximum":10000000},"y":{"type":"number","minimum":-10000000,"maximum":10000000},"zoom":{"type":"number","minimum":0.01,"maximum":100}},"required":["x","y","zoom"],"additionalProperties":false}],"nullable":true}},"required":["type","component_id"],"additionalProperties":false}]},"DraftsDiscardResponse200":{"type":"object","properties":{"agent":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"draft_id":{"type":"string","format":"uuid"},"discarded":{"type":"boolean","enum":[true]}},"required":["agent","draft_id","discarded"],"additionalProperties":false},"DraftsEditRequest":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"edits":{"type":"array","items":{"$ref":"#/components/schemas/DraftEdit"},"minItems":1,"maxItems":100}},"required":["draft_id","expected_revision","edits"],"additionalProperties":false},"DraftsEditResponse200":{"type":"object","properties":{"agent":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"draft_id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"base_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"published_revision":{"allOf":[{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647}],"nullable":true},"updated_at":{"type":"string","format":"date-time"}},"required":["agent","draft_id","revision","base_version","published_revision","updated_at"],"additionalProperties":false},"DraftsGetResponse200":{"type":"object","properties":{"state":{"$ref":"#/components/schemas/DraftsEditResponse200"},"name":{"type":"string","minLength":1,"maxLength":256},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1},"flow":{"type":"object","properties":{"schemaVersion":{"type":"number","enum":[2]},"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"integer","minimum":0,"maximum":2147483647},"startNodeId":{"type":"string","minLength":1,"maxLength":256},"startSpeaker":{"type":"string","enum":["agent","user"]},"globalPrompt":{"type":"string"},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["conversation","end","branch","transfer_call","function","extract_dynamic_variables","verify_identity","tokenize_private","component"]},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"destinationNodeId":{"type":"string","minLength":1,"maxLength":256},"slot":{"type":"string","enum":["edges","else_edge","skip_response_edge","always_edge","edge","success_edge"]},"condition":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["always"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["prompt"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"operator":{"type":"string","enum":["&&","||"]},"equations":{"type":"array","items":{"type":"object","properties":{"left":{"type":"string"},"operator":{"type":"string","enum":["==","!=",">","<",">=","<=","contains","is_set","is_not_set"]},"right":{"type":"string"}},"required":["left","operator","right"],"additionalProperties":false},"minItems":1}},"required":["type","operator","equations"],"additionalProperties":false}]},"compliance":{"type":"object","properties":{"sets":{"type":"array","items":{"type":"string","enum":["rpc_confirmed"]},"minItems":1}},"required":["sets"],"additionalProperties":false}},"required":["slot","condition"],"additionalProperties":false}},"name":{"type":"string"},"instruction":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"startSpeaker":{"type":"string","enum":["agent","user"]},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2},"languageLocked":{"type":"boolean"},"globalNodeSetting":{"type":"object","properties":{"condition":{"type":"string"},"coolDown":{"type":"number","minimum":0}},"required":["condition"],"additionalProperties":false},"toolId":{"type":"string","minLength":1,"maxLength":256},"waitForResult":{"type":"boolean"},"speakDuringExecution":{"type":"boolean"},"executionMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"transfer":{"type":"object","properties":{"destination":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["predefined"]},"number":{"type":"string"}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["inferred"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false}]},"option":{"type":"object","properties":{"type":{"type":"string","enum":["cold_transfer","warm_transfer"]},"showTransfereeAsCaller":{"type":"boolean"},"optOutHumanDetection":{"type":"boolean"},"enableBridgeAudioCue":{"type":"boolean"},"onHoldMusic":{"type":"string"},"agentDetectionTimeoutMs":{"type":"integer","minimum":0},"agentDetectionPrompt":{"type":"string"},"transferMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"privateHandoffMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"coldTransferMode":{"type":"string"}},"required":["type"],"additionalProperties":false},"ignoreE164Validation":{"type":"boolean"}},"required":["destination","option","ignoreE164Validation"],"additionalProperties":false},"variables":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"componentId":{"type":"string","minLength":1,"maxLength":256},"verification":{"type":"object","properties":{"subjectVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"expectedVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"privateAliases":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"maxItems":16},"enabledVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"format":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["digits"]},"length":{"type":"integer","minimum":1,"maximum":32}},"required":["kind","length"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["date_yyyymmdd"]}},"required":["kind"],"additionalProperties":false}]},"prompt":{"type":"object","properties":{"en":{"type":"string"},"es":{"type":"string"}},"required":["en"],"additionalProperties":false}},"required":["id","expectedVariable","enabledVariable","format","prompt"],"additionalProperties":false},"maxItems":8},"required":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["fixed"]},"count":{"type":"integer","minimum":1,"maximum":8}},"required":["kind","count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false}]},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"lookup":{"type":"object","properties":{"toolId":{"type":"string","minLength":1},"fieldId":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"variable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["parameter","variable"],"additionalProperties":false},"maxItems":64}},"required":["toolId","fieldId","parameter","arguments"],"additionalProperties":false}},"required":["subjectVariable","fields","required","timeoutMs"],"additionalProperties":false},"tokenization":{"type":"object","properties":{"toolId":{"type":"string","maxLength":256},"subjectVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"consentPrompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"minDigits":{"type":"integer","minimum":1,"maximum":32},"maxDigits":{"type":"integer","minimum":1,"maximum":32},"encoding":{"type":"string","enum":["string","integer"]},"minimum":{"type":"integer","minimum":0,"maximum":999999999},"maximum":{"type":"integer","minimum":0,"maximum":999999999},"prompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false}},"required":["id","parameter","minDigits","maxDigits","encoding","prompt"],"additionalProperties":false},"maxItems":7},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["constant"]},"value":{"anyOf":[{"type":"string","maxLength":512},{"type":"number"},{"type":"boolean"}],"nullable":true}},"required":["kind","value"],"additionalProperties":false}]}},"required":["parameter","source"],"additionalProperties":false},"maxItems":64},"tokenIdPath":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"tokenVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Variable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Field":{"type":"string","maxLength":64}},"required":["toolId","subjectVariable","consentPrompt","timeoutMs","fields","arguments","tokenIdPath","tokenVariable","last4Variable","last4Field"],"additionalProperties":false}},"required":["id","kind","edges"],"additionalProperties":false}},"tools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"type":{"type":"string","enum":["custom"]},"name":{"type":"string","minLength":1,"maxLength":256},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"responseVariables":{"type":"object","additionalProperties":{"type":"string"}},"responseVariablePolicy":{"type":"string","enum":["required","replace_available"]},"speakAfterExecution":{"type":"boolean"}},"required":["id","type","name","description","method","responseVariables"],"additionalProperties":false}},"components":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"startNodeId":{"type":"string","minLength":1,"maxLength":256},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["conversation","end","branch","transfer_call","function","extract_dynamic_variables","verify_identity","tokenize_private","component"]},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"destinationNodeId":{"type":"string","minLength":1,"maxLength":256},"slot":{"type":"string","enum":["edges","else_edge","skip_response_edge","always_edge","edge","success_edge"]},"condition":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["always"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["prompt"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"operator":{"type":"string","enum":["&&","||"]},"equations":{"type":"array","items":{"type":"object","properties":{"left":{"type":"string"},"operator":{"type":"string","enum":["==","!=",">","<",">=","<=","contains","is_set","is_not_set"]},"right":{"type":"string"}},"required":["left","operator","right"],"additionalProperties":false},"minItems":1}},"required":["type","operator","equations"],"additionalProperties":false}]},"compliance":{"type":"object","properties":{"sets":{"type":"array","items":{"type":"string","enum":["rpc_confirmed"]},"minItems":1}},"required":["sets"],"additionalProperties":false}},"required":["slot","condition"],"additionalProperties":false}},"name":{"type":"string"},"instruction":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"startSpeaker":{"type":"string","enum":["agent","user"]},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2},"languageLocked":{"type":"boolean"},"globalNodeSetting":{"type":"object","properties":{"condition":{"type":"string"},"coolDown":{"type":"number","minimum":0}},"required":["condition"],"additionalProperties":false},"toolId":{"type":"string","minLength":1,"maxLength":256},"waitForResult":{"type":"boolean"},"speakDuringExecution":{"type":"boolean"},"executionMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"transfer":{"type":"object","properties":{"destination":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["predefined"]},"number":{"type":"string"}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["inferred"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false}]},"option":{"type":"object","properties":{"type":{"type":"string","enum":["cold_transfer","warm_transfer"]},"showTransfereeAsCaller":{"type":"boolean"},"optOutHumanDetection":{"type":"boolean"},"enableBridgeAudioCue":{"type":"boolean"},"onHoldMusic":{"type":"string"},"agentDetectionTimeoutMs":{"type":"integer","minimum":0},"agentDetectionPrompt":{"type":"string"},"transferMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"privateHandoffMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"coldTransferMode":{"type":"string"}},"required":["type"],"additionalProperties":false},"ignoreE164Validation":{"type":"boolean"}},"required":["destination","option","ignoreE164Validation"],"additionalProperties":false},"variables":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"componentId":{"type":"string","minLength":1,"maxLength":256},"verification":{"type":"object","properties":{"subjectVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"expectedVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"privateAliases":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"maxItems":16},"enabledVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"format":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["digits"]},"length":{"type":"integer","minimum":1,"maximum":32}},"required":["kind","length"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["date_yyyymmdd"]}},"required":["kind"],"additionalProperties":false}]},"prompt":{"type":"object","properties":{"en":{"type":"string"},"es":{"type":"string"}},"required":["en"],"additionalProperties":false}},"required":["id","expectedVariable","enabledVariable","format","prompt"],"additionalProperties":false},"maxItems":8},"required":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["fixed"]},"count":{"type":"integer","minimum":1,"maximum":8}},"required":["kind","count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false}]},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"lookup":{"type":"object","properties":{"toolId":{"type":"string","minLength":1},"fieldId":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"variable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["parameter","variable"],"additionalProperties":false},"maxItems":64}},"required":["toolId","fieldId","parameter","arguments"],"additionalProperties":false}},"required":["subjectVariable","fields","required","timeoutMs"],"additionalProperties":false},"tokenization":{"type":"object","properties":{"toolId":{"type":"string","maxLength":256},"subjectVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"consentPrompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"minDigits":{"type":"integer","minimum":1,"maximum":32},"maxDigits":{"type":"integer","minimum":1,"maximum":32},"encoding":{"type":"string","enum":["string","integer"]},"minimum":{"type":"integer","minimum":0,"maximum":999999999},"maximum":{"type":"integer","minimum":0,"maximum":999999999},"prompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false}},"required":["id","parameter","minDigits","maxDigits","encoding","prompt"],"additionalProperties":false},"maxItems":7},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["constant"]},"value":{"anyOf":[{"type":"string","maxLength":512},{"type":"number"},{"type":"boolean"}],"nullable":true}},"required":["kind","value"],"additionalProperties":false}]}},"required":["parameter","source"],"additionalProperties":false},"maxItems":64},"tokenIdPath":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"tokenVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Variable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Field":{"type":"string","maxLength":64}},"required":["toolId","subjectVariable","consentPrompt","timeoutMs","fields","arguments","tokenIdPath","tokenVariable","last4Variable","last4Field"],"additionalProperties":false}},"required":["id","kind","edges"],"additionalProperties":false}},"tools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"type":{"type":"string","enum":["custom"]},"name":{"type":"string","minLength":1,"maxLength":256},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"responseVariables":{"type":"object","additionalProperties":{"type":"string"}},"responseVariablePolicy":{"type":"string","enum":["required","replace_available"]},"speakAfterExecution":{"type":"boolean"}},"required":["id","type","name","description","method","responseVariables"],"additionalProperties":false}},"flexMode":{"type":"boolean"}},"required":["id","startNodeId","nodes","tools"],"additionalProperties":false}},"defaultDynamicVariables":{"type":"object","additionalProperties":{"type":"string"}},"callContextVariables":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"toolCallStrictMode":{"type":"boolean"}},"required":["schemaVersion","id","version","startNodeId","startSpeaker","globalPrompt","nodes","tools","components","defaultDynamicVariables","toolCallStrictMode"],"additionalProperties":false},"settings":{"type":"object","properties":{"voiceId":{"type":"string","minLength":1,"maxLength":256},"voiceModel":{"type":"string","minLength":1,"maxLength":256},"voiceSpeed":{"type":"number","minimum":0.5,"maximum":2},"voiceTemperature":{"type":"number","minimum":0,"maximum":2},"volume":{"type":"number","minimum":0,"maximum":2},"language":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"array","items":{"type":"string","minLength":1,"maxLength":256},"minItems":1}]},"responsiveness":{"type":"number","minimum":0,"maximum":1},"interruptionSensitivity":{"type":"number","minimum":0,"maximum":1},"enableBackchannel":{"type":"boolean"},"backchannelFrequency":{"type":"number","minimum":0,"maximum":1},"backchannelWords":{"type":"array","items":{"type":"string"}},"reminderTriggerMs":{"type":"integer","minimum":0,"maximum":3600000},"reminderMaxCount":{"type":"integer","minimum":0,"maximum":100},"maxCallDurationMs":{"type":"integer","minimum":1000,"maximum":86400000},"endCallAfterSilenceMs":{"type":"integer","minimum":1000,"maximum":3600000},"ringDurationMs":{"type":"integer","minimum":1000,"maximum":300000},"beginMessageDelayMs":{"type":"integer","minimum":0,"maximum":60000},"normalizeForSpeech":{"type":"boolean"},"openerWaitsForCallee":{"type":"boolean"},"voicemail":{"type":"object","properties":{"enabled":{"type":"boolean"},"detectionTimeoutMs":{"type":"integer","exclusiveMinimum":true,"minimum":0},"action":{"type":"string","enum":["hangup","leave_message"]},"message":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false}},"required":["enabled"],"additionalProperties":false},"ambientSound":{"type":"string"},"ambientSoundVolume":{"type":"number","minimum":0,"maximum":2},"boostedKeywords":{"type":"array","items":{"type":"string"}},"pronunciationDictionary":{"type":"array","items":{"type":"object","properties":{"word":{"type":"string","minLength":1,"maxLength":256},"alphabet":{"type":"string","enum":["ipa","cmu"]},"phoneme":{"type":"string","minLength":1,"maxLength":256}},"required":["word","alphabet","phoneme"],"additionalProperties":false}},"denoisingMode":{"type":"string"},"sttMode":{"type":"string"},"allowUserDtmf":{"type":"boolean"},"allowDtmfInterruption":{"type":"boolean"},"userDtmfOptions":{"type":"object","properties":{"digitLimit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"nullable":true},"terminationKey":{"type":"string","enum":["0","1","2","3","4","5","6","7","8","9","*","#"],"nullable":true},"timeoutMs":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"additionalProperties":false,"nullable":true},"dataStorageSetting":{"type":"string","enum":["everything","everything_except_pii","basic_attributes_only"]},"optInSignedUrl":{"type":"boolean"},"piiConfig":{"type":"object","properties":{"mode":{"type":"string","enum":["post_call"]},"categories":{"type":"array","items":{"type":"string","enum":["person_name","address","email","phone_number","ssn","passport","driver_license","credit_card","bank_account","password","pin","medical_id","date_of_birth","customer_account_number"]}}},"required":["mode","categories"],"additionalProperties":false},"handbookConfig":{"type":"object","properties":{"defaultPersonality":{"type":"boolean"},"conversationalPersonality":{"type":"boolean"},"naturalFillerWords":{"type":"boolean"},"highEmpathy":{"type":"boolean"},"echoVerification":{"type":"boolean"},"natoPhoneticAlphabet":{"type":"boolean"},"speechNormalization":{"type":"boolean"},"smartMatching":{"type":"boolean"},"aiDisclosure":{"type":"boolean"},"scopeBoundaries":{"type":"boolean"}},"additionalProperties":false},"ivr":{"anyOf":[{"type":"object","properties":{"enabled":{"type":"boolean","enum":[false]}},"required":["enabled"],"additionalProperties":false},{"type":"object","properties":{"enabled":{"type":"boolean","enum":[true]},"action":{"type":"string","enum":["hangup"]},"detectionWindowMs":{"type":"number","enum":[180000]},"detectionPrompt":{"type":"string","nullable":true}},"required":["enabled","action","detectionWindowMs"],"additionalProperties":false}]},"screener":{"anyOf":[{"type":"object","properties":{"action":{"type":"string","enum":["hangup"]}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["wait"]},"waitMs":{"type":"integer","minimum":5000,"maximum":120000}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["play_line"]},"waitMs":{"type":"integer","minimum":5000,"maximum":120000},"line":{"type":"object","properties":{"en":{"type":"string","minLength":1,"maxLength":500},"es":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false}},"required":["action","line"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","enum":["treat_as_human"]}},"required":["action"],"additionalProperties":false}]},"postCallAnalysisModel":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false}},"required":["model"],"additionalProperties":false},"compliance":{"type":"object","properties":{"profile":{"type":"string","enum":["fdcpa"]}},"additionalProperties":false}},"additionalProperties":false},"analysis":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}},"examples":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}},"providers":{"type":"object","properties":{"llm":{"type":"object","properties":{"provider":{"type":"string","enum":["openai","simulated_openai","self_hosted","simulated_self_hosted"]},"model":{"$ref":"#/components/schemas/ModelIdentity"}},"required":["provider","model"],"additionalProperties":false},"stt":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"voiceId":{"type":"string"}},"required":["provider","model"],"additionalProperties":false,"nullable":true},"tts":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"voiceId":{"type":"string"}},"required":["provider","model"],"additionalProperties":false,"nullable":true}},"required":["llm","stt","tts"],"additionalProperties":false},"telephony":{"allOf":[{"type":"object","properties":{"trunkId":{"type":"string","minLength":1,"maxLength":256},"from":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"}},"required":["trunkId"],"additionalProperties":false}],"nullable":true},"inbound_context":{"type":"object","properties":{"action_id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,62}$"},"variables":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_.-]{0,127}$"},"minItems":1,"maxItems":256}},"required":["action_id","variables"],"additionalProperties":false},"recording":{"type":"object","properties":{"required":{"type":"boolean"},"channels":{"type":"string","enum":["dual"]}},"required":["required","channels"],"additionalProperties":false,"nullable":true},"cloud":{"type":"object","properties":{"modes":{"type":"array","items":{"type":"string","enum":["task","chat","background"]},"minItems":1},"input_schema":{"type":"object","additionalProperties":{}},"output_schema":{"type":"object","additionalProperties":{}},"max_turns":{"type":"integer","minimum":1,"maximum":200},"idle_timeout_ms":{"type":"integer","minimum":10000,"maximum":86400000},"deadline_ms":{"type":"integer","minimum":1000,"maximum":3600000}},"required":["modes","input_schema","output_schema","max_turns","idle_timeout_ms","deadline_ms"],"additionalProperties":false,"nullable":true},"actions":{"type":"array","items":{"type":"object","properties":{"purpose":{"type":"string","enum":["tokenization"]},"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,62}$"},"description":{"type":"string","minLength":1,"maxLength":1024},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":1024},"default":{}},"auth":{"anyOf":[{"type":"object","properties":{"scheme":{"type":"string","enum":["none"]}},"required":["scheme"],"additionalProperties":false},{"type":"object","properties":{"scheme":{"type":"string","enum":["bearer","basic"]},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["scheme","secret_ref"],"additionalProperties":false},{"type":"object","properties":{"scheme":{"type":"string","enum":["retell_signature"]},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["scheme","secret_ref"],"additionalProperties":false},{"type":"object","properties":{"scheme":{"type":"string","enum":["header"]},"header_name":{"type":"string","minLength":1,"maxLength":128},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"required":["scheme","header_name","secret_ref"],"additionalProperties":false}]},"input_schema":{"type":"object","additionalProperties":{}},"output_schema":{"type":"object","additionalProperties":{}},"idempotency":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["effect_key"]}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","enum":["template"]},"header":{"type":"string","default":"Idempotency-Key"},"template":{"type":"string","minLength":1,"maxLength":512}},"required":["mode","template"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","enum":["none_read_only"]}},"required":["mode"],"additionalProperties":false}]},"timeout_ms":{"type":"integer","minimum":500,"maximum":120000},"on_uncertain":{"type":"string","enum":["failure_edge","uncertain_edge"],"default":"failure_edge"}},"required":["name","description","channels","method","url","auth","input_schema","output_schema","idempotency","timeout_ms"],"additionalProperties":false}},"notifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"url":{"type":"string","format":"uri"},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false},"format":{"type":"string","enum":["semantic.v1"]},"events":{"type":"array","items":{"type":"string","enum":["run.admitted","run.ended","recording.updated","analysis.updated"]},"minItems":1}},"required":["id","url","secret_ref","format","events"],"additionalProperties":false}},"knowledge":{"type":"object","properties":{"document_ids":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["document_ids"],"additionalProperties":false,"nullable":true},"triggers":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["schedule"]},"id":{"type":"string","minLength":1,"maxLength":128},"cron":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string","minLength":1,"maxLength":64},"input":{"type":"object","additionalProperties":{}}},"required":["kind","id","cron","timezone","input"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["event"]},"id":{"type":"string","minLength":1,"maxLength":128},"event_type":{"type":"string","enum":["run.ended","analysis.updated"]},"source":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"channel":{"type":"string","enum":["cloud","phone","web"]},"dispositions":{"type":"array","items":{"type":"string","minLength":1},"maxItems":32}},"additionalProperties":false},"input_mapping":{"type":"object","additionalProperties":{"type":"string","pattern":"^\\/[A-Za-z0-9_/-]*$"}}},"required":["kind","id","event_type","source","input_mapping"],"additionalProperties":false}]}},"layout":{"$ref":"#/components/schemas/AgentLayout"}},"required":["state","name","channels","languages","flow","settings","analysis","providers","telephony","recording","cloud","actions","notifications","knowledge","triggers","layout"],"additionalProperties":false},"DraftsOpenRequest":{"type":"object","properties":{"base_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true}},"required":["base_version"],"additionalProperties":false},"DraftsRebaseRequest":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"head_version":{"type":"integer","minimum":0,"maximum":2147483647}},"required":["draft_id","head_version"],"additionalProperties":false},"DraftsValidateRequest":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"include_plan":{"type":"boolean"}},"required":["draft_id","expected_revision"],"additionalProperties":false},"DraftsValidateResponse200":{"type":"object","properties":{"ok":{"type":"boolean"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"digest":{"allOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}],"nullable":true},"diagnostics":{"type":"array","items":{"$ref":"#/components/schemas/Diagnostic"}},"plan":{"$ref":"#/components/schemas/PublicationPlan"}},"required":["ok","version","digest","diagnostics"],"additionalProperties":false},"EffectRecord":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"},"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"effect_key":{"type":"string","minLength":1,"maxLength":256},"action":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","version"],"additionalProperties":false},"effect_kind":{"type":"string","enum":["none","transaction","gateway_inference","http","livekit","sip_dial","sip_transfer","sip_hangup","run_admission","gpu"]},"node_id":{"type":"string","minLength":1,"maxLength":128,"nullable":true},"ordinal":{"type":"integer","minimum":0,"nullable":true},"state":{"type":"string","enum":["intended","sending","succeeded","failed","uncertain"]},"decision":{"type":"object","properties":{"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","nullable":true},"policy_version":{"type":"string"}},"required":["decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"send_attempts":{"type":"integer","minimum":0},"receipts":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["http"]},"status":{"type":"integer"},"response_sha256":{"allOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"}],"nullable":true},"response_bytes":{"type":"integer","minimum":0},"duration_ms":{"type":"integer"},"send_attempt":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","status","response_sha256","response_bytes","duration_ms","send_attempt"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["sip_transfer"]},"refer_status":{"type":"integer","nullable":true},"final_sip_status":{"type":"integer","nullable":true},"disconnect_reason":{"type":"string","nullable":true}},"required":["kind","refer_status","final_sip_status","disconnect_reason"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["sip_dial"]},"participant_id":{"type":"string"},"sip_call_id":{"type":"string","nullable":true}},"required":["kind","participant_id","sip_call_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["livekit"]},"resource_id":{"type":"string"}},"required":["kind","resource_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gateway_inference"]},"attempt_id":{"type":"string","format":"uuid"},"measurement_id":{"type":"string","format":"uuid","nullable":true}},"required":["kind","attempt_id","measurement_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["transaction"]},"table":{"type":"string"},"row_id":{"type":"string"}},"required":["kind","table","row_id"],"additionalProperties":false}]}},"error_code":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"settled_at":{"type":"string","format":"date-time","nullable":true}},"required":["effect_id","run_id","attempt_id","effect_key","action","effect_kind","node_id","ordinal","state","decision","send_attempts","receipts","error_code","created_at","settled_at"],"additionalProperties":false},"EnvironmentsEnsureSandboxResponse200":{"type":"object","properties":{"current":{"type":"string","enum":["production","sandbox"]},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["production","sandbox"]},"tenant_id":{"type":"string","format":"uuid"},"slug":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"display_name":{"type":"string","nullable":true}},"required":["kind","tenant_id","slug","name","display_name"],"additionalProperties":false}},"created":{"type":"boolean"},"sandbox_provisioning":{"type":"string","enum":["configured","pending","unavailable"]}},"required":["current","items","created","sandbox_provisioning"],"additionalProperties":false},"EnvironmentsListResponse200":{"type":"object","properties":{"current":{"type":"string","enum":["production","sandbox"]},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["production","sandbox"]},"tenant_id":{"type":"string","format":"uuid"},"slug":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"display_name":{"type":"string","nullable":true}},"required":["kind","tenant_id","slug","name","display_name"],"additionalProperties":false}}},"required":["current","items"],"additionalProperties":false},"Evaluation":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"evaluation_id":{"type":"string","format":"uuid"},"subject":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["run"]},"id":{"type":"string","format":"uuid"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"publication":{"$ref":"#/components/schemas/PublicationRef"},"kind":{"type":"string","enum":["manual","judge","analysis"]},"rubric":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","version"],"additionalProperties":false},"score":{"type":"number","minimum":0,"maximum":1,"nullable":true},"labels":{"type":"object","additionalProperties":{"type":"string","maxLength":256}},"judge_model":{"allOf":[{"$ref":"#/components/schemas/ModelIdentity"}],"nullable":true},"created_by":{"$ref":"#/components/schemas/PrincipalRef"},"created_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","evaluation_id","subject","publication","kind","rubric","score","labels","judge_model","created_by","created_at"],"additionalProperties":false},"EvaluationsCreateRequest":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"rubric":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","version"],"additionalProperties":false},"score":{"type":"number","minimum":0,"maximum":1,"nullable":true},"labels":{"type":"object","additionalProperties":{"type":"string","maxLength":256},"default":{}}},"required":["run_id","rubric","score"],"additionalProperties":false},"EvaluationsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Evaluation"}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"JsonValue":{"nullable":true,"description":"Any JSON value: null, boolean, number, string, array or object."},"KeysCreateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":128},"role":{"type":"string","enum":["admin","member","viewer"]},"can_dial":{"type":"boolean","default":false},"expires_at":{"type":"string","format":"date-time"}},"required":["name"],"additionalProperties":false},"KeysListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ApiKey"}}},"required":["items"],"additionalProperties":false},"KeysRotateRequest":{"type":"object","properties":{},"additionalProperties":false},"KnowledgeConfigureRequest":{"type":"object","properties":{"model_identity":{"$ref":"#/components/schemas/ModelIdentity"}},"required":["model_identity"],"additionalProperties":false},"KnowledgeReembedRequest":{"type":"object","properties":{},"additionalProperties":false},"KnowledgeStatus":{"type":"object","properties":{"configured":{"type":"boolean"},"model_identity":{"allOf":[{"$ref":"#/components/schemas/ModelIdentity"}],"nullable":true},"dimension":{"type":"integer","exclusiveMinimum":true,"minimum":0,"nullable":true},"generation":{"type":"object","properties":{"generation_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["building","ready","failed"]},"document_count":{"type":"integer","minimum":0},"created_at":{"type":"string","format":"date-time"}},"required":["generation_id","state","document_count","created_at"],"additionalProperties":false,"nullable":true},"pending_documents":{"type":"integer","minimum":0}},"required":["configured","model_identity","dimension","generation","pending_documents"],"additionalProperties":false},"ModelIdentity":{"type":"object","properties":{"model_id":{"type":"string","minLength":1,"pattern":"\\S"},"provider":{"type":"string","minLength":1,"pattern":"\\S"},"tier":{"type":"string","enum":["frontier","cumulus-served","customer-gpu"]}},"required":["model_id","provider","tier"],"additionalProperties":false},"ModelPolicyValue":{"nullable":true,"description":"A model data-policy value: any JSON value."},"ModelsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"model_id":{"type":"string","minLength":1,"pattern":"\\S"},"provider":{"type":"string","minLength":1,"pattern":"\\S"},"tier":{"type":"string","enum":["frontier","cumulus-served","customer-gpu"]},"route_kind":{"type":"string","enum":["frontier","flam","oss"]},"context_window":{"type":"integer","minimum":0},"input_cost_per_1k":{"type":"number","minimum":0,"nullable":true},"output_cost_per_1k":{"type":"number","minimum":0,"nullable":true},"availability":{"type":"string","enum":["ready","not-configured","unavailable"]},"capabilities":{"type":"array","items":{"type":"string","enum":["text","vision","tool_calling","structured_output","embedding","audio","reasoning","voice","stt","tts","transcription","speech_synthesis","streaming"]}},"tool_calling":{"type":"boolean"},"task":{"type":"string","enum":["chat","embedding","voice","stt","tts"]},"embedding_dim":{"type":"integer","exclusiveMinimum":true,"minimum":0,"nullable":true},"deployment_backend":{"type":"string","minLength":1},"health_state":{"type":"string","minLength":1,"nullable":true},"supports_streaming":{"type":"boolean","nullable":true},"supports_parallel_tool_calls":{"type":"boolean","nullable":true},"data_policy":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ModelPolicyValue"}},"regions":{"type":"array","items":{"type":"string","minLength":1}},"eval_scores":{"type":"object","additionalProperties":{"type":"number"}},"latency_ms_p50":{"type":"number","minimum":0,"nullable":true},"latency_ms_p95":{"type":"number","minimum":0,"nullable":true}},"required":["model_id","provider","tier","route_kind","context_window","input_cost_per_1k","output_cost_per_1k","availability","capabilities","tool_calling","task","embedding_dim","deployment_backend","health_state","supports_streaming","supports_parallel_tool_calls","data_policy","regions","eval_scores","latency_ms_p50","latency_ms_p95"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"NumbersImportRequest":{"type":"object","properties":{"e164":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"},"trunk_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"nickname":{"type":"string","maxLength":256},"inbound_agent_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}],"nullable":true},"outbound_agent_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}],"nullable":true}},"required":["e164","trunk_id"],"additionalProperties":false},"NumbersListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ByocNumber"}}},"required":["items"],"additionalProperties":false},"NumbersUpdateRequest":{"type":"object","properties":{"trunk_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"nickname":{"type":"string","maxLength":256,"nullable":true},"inbound_agent_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}],"nullable":true},"outbound_agent_id":{"allOf":[{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}],"nullable":true}},"additionalProperties":false},"PlanFlow":{"type":"object","properties":{"schemaVersion":{"type":"number","enum":[2]},"compilerVersion":{"type":"string","minLength":1},"sourceHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"id":{"type":"string","minLength":1},"version":{"type":"integer","minimum":0},"startNodeId":{"type":"string","minLength":1},"startSpeaker":{"type":"string","enum":["agent","user"]},"globalPrompt":{"type":"string"},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/PlanFlowNode"}},"components":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"startNodeId":{"type":"string","minLength":1},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/PlanFlowNode"}},"tools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["custom"]},"name":{"type":"string","minLength":1},"description":{"type":"string"},"url":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}},"credential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","version"],"additionalProperties":false},"parameters":{"type":"object","additionalProperties":{}},"responseVariables":{"type":"object","additionalProperties":{"type":"string"}},"timeoutMs":{"type":"integer"},"responseVariablePolicy":{"type":"string","enum":["required","replace_available"]},"argsAtRoot":{"type":"boolean"},"parameterType":{"type":"string","enum":["json"]},"speakAfterExecution":{"type":"boolean"}},"required":["id","type","name","description","url","method","headers","queryParams","parameters","responseVariables","timeoutMs","argsAtRoot","parameterType"],"additionalProperties":false}},"flexMode":{"type":"boolean"}},"required":["id","startNodeId","nodes","tools"],"additionalProperties":false}},"tools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["custom"]},"name":{"type":"string","minLength":1},"description":{"type":"string"},"url":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}},"credential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","version"],"additionalProperties":false},"parameters":{"type":"object","additionalProperties":{}},"responseVariables":{"type":"object","additionalProperties":{"type":"string"}},"timeoutMs":{"type":"integer"},"responseVariablePolicy":{"type":"string","enum":["required","replace_available"]},"argsAtRoot":{"type":"boolean"},"parameterType":{"type":"string","enum":["json"]},"speakAfterExecution":{"type":"boolean"}},"required":["id","type","name","description","url","method","headers","queryParams","parameters","responseVariables","timeoutMs","argsAtRoot","parameterType"],"additionalProperties":false}},"defaultDynamicVariables":{"type":"object","additionalProperties":{"type":"string"}},"callContextVariables":{"type":"array","items":{"type":"string","minLength":1}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"toolCallStrictMode":{"type":"boolean"}},"required":["schemaVersion","compilerVersion","sourceHash","id","version","startNodeId","startSpeaker","globalPrompt","nodes","components","tools","defaultDynamicVariables","toolCallStrictMode"],"additionalProperties":false},"PlanFlowNode":{"type":"object","properties":{"id":{"type":"string","minLength":1},"kind":{"type":"string","enum":["conversation","end","branch","transfer_call","function","extract_dynamic_variables","verify_identity","tokenize_private","component"]},"name":{"type":"string"},"instruction":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"destinationNodeId":{"type":"string","minLength":1},"slot":{"type":"string","enum":["edges","else_edge","skip_response_edge","always_edge","edge","success_edge"]},"condition":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["always"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["prompt"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["equation"]},"operator":{"type":"string","enum":["&&","||"]},"equations":{"type":"array","items":{"type":"object","properties":{"left":{"type":"string"},"operator":{"type":"string","enum":["==","!=",">","<",">=","<=","contains","is_set","is_not_set"]},"right":{"type":"string"}},"required":["left","operator","right"],"additionalProperties":false},"minItems":1}},"required":["type","operator","equations"],"additionalProperties":false}]},"label":{"type":"string"},"compliance":{"type":"object","properties":{"sets":{"type":"array","items":{"type":"string","enum":["rpc_confirmed"]},"minItems":1}},"required":["sets"],"additionalProperties":false}},"required":["slot","condition"],"additionalProperties":false}},"startSpeaker":{"type":"string","enum":["agent","user"]},"interruptionSensitivity":{"type":"number"},"voiceSpeed":{"type":"number"},"languageLocked":{"type":"boolean"},"globalNodeSetting":{"type":"object","properties":{"condition":{"type":"string"},"coolDown":{"type":"number"}},"required":["condition"],"additionalProperties":false},"speakDuringExecution":{"type":"boolean"},"executionMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"toolId":{"type":"string","minLength":1},"waitForResult":{"type":"boolean"},"transfer":{"type":"object","properties":{"destination":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["predefined"]},"number":{"type":"string"}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["inferred"]},"prompt":{"type":"string"}},"required":["type","prompt"],"additionalProperties":false}]},"option":{"type":"object","properties":{"type":{"type":"string","enum":["cold_transfer","warm_transfer"]},"showTransfereeAsCaller":{"type":"boolean"},"optOutHumanDetection":{"type":"boolean"},"enableBridgeAudioCue":{"type":"boolean"},"onHoldMusic":{"type":"string"},"agentDetectionTimeoutMs":{"type":"integer"},"agentDetectionPrompt":{"type":"string"},"transferMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"privateHandoffMessage":{"type":"object","properties":{"type":{"type":"string","enum":["prompt","static_text"]},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"coldTransferMode":{"type":"string"}},"required":["type"],"additionalProperties":false},"customSipHeaders":{"type":"object","additionalProperties":{"type":"string"}},"headerCredential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","version"],"additionalProperties":false},"ignoreE164Validation":{"type":"boolean"}},"required":["destination","option","customSipHeaders","ignoreE164Validation"],"additionalProperties":false},"variables":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"type":{"type":"string","enum":["string","number","boolean","enum"]},"description":{"type":"string"},"choices":{"type":"array","items":{"type":"string"}}},"required":["name","type","description"],"additionalProperties":false}},"modelChoice":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","minLength":1,"maxLength":256}},"required":["id","version","provider"],"additionalProperties":false},"type":{"type":"string","enum":["cascading"]},"highPriority":{"type":"boolean"},"reasoningEffort":{"type":"string","enum":["low","medium","high"]}},"required":["model","type","highPriority"],"additionalProperties":false},"verification":{"type":"object","properties":{"subjectVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"expectedVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"privateAliases":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"maxItems":16},"enabledVariable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"format":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["digits"]},"length":{"type":"integer","minimum":1,"maximum":32}},"required":["kind","length"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["date_yyyymmdd"]}},"required":["kind"],"additionalProperties":false}]},"prompt":{"type":"object","properties":{"en":{"type":"string"},"es":{"type":"string"}},"required":["en"],"additionalProperties":false}},"required":["id","expectedVariable","enabledVariable","format","prompt"],"additionalProperties":false},"maxItems":8},"required":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["fixed"]},"count":{"type":"integer","minimum":1,"maximum":8}},"required":["kind","count"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false}]},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"lookup":{"type":"object","properties":{"toolId":{"type":"string","minLength":1},"fieldId":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"},"variable":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["parameter","variable"],"additionalProperties":false},"maxItems":64}},"required":["toolId","fieldId","parameter","arguments"],"additionalProperties":false}},"required":["subjectVariable","fields","required","timeoutMs"],"additionalProperties":false},"tokenization":{"type":"object","properties":{"toolId":{"type":"string","maxLength":256},"subjectVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"consentPrompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":1000,"maximum":180000},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]{0,63}$"},"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"minDigits":{"type":"integer","minimum":1,"maximum":32},"maxDigits":{"type":"integer","minimum":1,"maximum":32},"encoding":{"type":"string","enum":["string","integer"]},"minimum":{"type":"integer","minimum":0,"maximum":999999999},"maximum":{"type":"integer","minimum":0,"maximum":999999999},"prompt":{"type":"object","properties":{"en":{"type":"string","maxLength":4096},"es":{"type":"string","maxLength":4096}},"required":["en"],"additionalProperties":false}},"required":["id","parameter","minDigits","maxDigits","encoding","prompt"],"additionalProperties":false},"maxItems":7},"arguments":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["variable"]},"name":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"}},"required":["kind","name"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["constant"]},"value":{"anyOf":[{"type":"string","maxLength":512},{"type":"number"},{"type":"boolean"}],"nullable":true}},"required":["kind","value"],"additionalProperties":false}]}},"required":["parameter","source"],"additionalProperties":false},"maxItems":64},"tokenIdPath":{"type":"string","maxLength":256,"pattern":"^(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*(?:\\.(?!(?:__proto__|constructor|prototype)(?:\\.|$))[A-Za-z_][A-Za-z0-9_]*){0,7}$"},"tokenVariable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Variable":{"type":"string","pattern":"^(?!(?:__proto__|constructor|prototype)$)[A-Za-z_][A-Za-z0-9_]{0,255}$"},"last4Field":{"type":"string","maxLength":64}},"required":["toolId","subjectVariable","consentPrompt","timeoutMs","fields","arguments","tokenIdPath","tokenVariable","last4Variable","last4Field"],"additionalProperties":false},"componentId":{"type":"string","minLength":1}},"required":["id","kind","edges"],"additionalProperties":false},"PrincipalRef":{"anyOf":[{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"kind":{"type":"string","enum":["user"]},"id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","kind","id"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"kind":{"type":"string","enum":["api_key"]},"id":{"type":"string","format":"uuid"}},"required":["owner_id","environment","kind","id"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"kind":{"type":"string","enum":["system"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["owner_id","environment","kind","id"],"additionalProperties":false}]},"ProviderKeysDeleteResponse200":{"type":"object","properties":{"provider":{"type":"string","enum":["elevenlabs","openai","cerebras"]},"source":{"type":"string","enum":["platform","tenant"]},"last4":{"allOf":[{"type":"string","minLength":1,"maxLength":4}],"nullable":true},"fingerprint":{"allOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{12}$"}],"nullable":true},"validated_at":{"type":"string","format":"date-time","nullable":true},"updated_at":{"type":"string","format":"date-time","nullable":true},"last_rejection":{"type":"object","properties":{"reason":{"type":"string","minLength":1,"maxLength":64},"last4":{"type":"string","minLength":1,"maxLength":4},"fingerprint":{"type":"string","pattern":"^sha256:[a-f0-9]{12}$"},"at":{"type":"string","format":"date-time"}},"required":["reason","last4","fingerprint","at"],"additionalProperties":false,"nullable":true}},"required":["provider","source","last4","fingerprint","validated_at","updated_at","last_rejection"],"additionalProperties":false},"ProviderKeysListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ProviderKeysDeleteResponse200"}}},"required":["items"],"additionalProperties":false},"ProviderKeysPutRequest":{"type":"object","properties":{"api_key":{"type":"string","minLength":8,"maxLength":512}},"required":["api_key"],"additionalProperties":false},"PublicationPlan":{"type":"object","properties":{"plan_schema_version":{"type":"number","enum":[2]},"compiler":{"type":"object","properties":{"name":{"type":"string","enum":["talos-compiler"]},"version":{"type":"string","minLength":1}},"required":["name","version"],"additionalProperties":false},"agent":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":256}},"required":["agent_id","version","name"],"additionalProperties":false},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["studio","retell_import","api"]},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["kind","sha256"],"additionalProperties":false},"channels":{"type":"object","properties":{"cloud":{"type":"object","properties":{"modes":{"type":"array","items":{"type":"string","enum":["task","chat","background"]},"minItems":1},"input_schema":{"type":"object","additionalProperties":{}},"output_schema":{"type":"object","additionalProperties":{}},"max_turns":{"type":"integer","minimum":1,"maximum":200},"idle_timeout_ms":{"type":"integer","minimum":10000,"maximum":86400000},"deadline_ms":{"type":"integer","minimum":1000,"maximum":3600000}},"required":["modes","input_schema","output_schema","max_turns","idle_timeout_ms","deadline_ms"],"additionalProperties":false,"nullable":true},"phone":{"type":"object","properties":{"telephony":{"type":"object","properties":{"trunk_id":{"type":"string","minLength":1,"maxLength":128},"from":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$","nullable":true}},"required":["trunk_id","from"],"additionalProperties":false,"nullable":true},"inbound_context":{"type":"object","properties":{"action_id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,62}$"},"variables":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_.-]{0,127}$"},"minItems":1,"maxItems":256}},"required":["action_id","variables"],"additionalProperties":false},"settings":{"type":"object","additionalProperties":{}},"recording":{"type":"object","properties":{"required":{"type":"boolean"},"channels":{"type":"string","enum":["dual"]}},"required":["required","channels"],"additionalProperties":false}},"required":["telephony","settings","recording"],"additionalProperties":false,"nullable":true}},"required":["cloud","phone"],"additionalProperties":false},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1},"flow":{"$ref":"#/components/schemas/PlanFlow"},"actions":{"type":"array","items":{"type":"object","properties":{"binding_id":{"type":"string","minLength":1,"maxLength":128},"action":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","version"],"additionalProperties":false},"config":{"type":"object","additionalProperties":{}},"secret_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false}},"node_ids":{"type":"array","items":{"type":"string","minLength":1}}},"required":["binding_id","action","config","secret_refs","node_ids"],"additionalProperties":false}},"notifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"url":{"type":"string","format":"uri"},"secret_ref":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false},"format":{"type":"string","enum":["semantic.v1"]},"events":{"type":"array","items":{"type":"string","enum":["run.admitted","run.ended","recording.updated","analysis.updated"]},"minItems":1}},"required":["id","url","secret_ref","format","events"],"additionalProperties":false}},"knowledge":{"type":"array","items":{"type":"object","properties":{"pin_id":{"type":"string","format":"uuid"},"generation_id":{"type":"string","format":"uuid"},"model_identity":{"$ref":"#/components/schemas/ModelIdentity"},"dimension":{"type":"integer","exclusiveMinimum":true,"minimum":0},"document_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1},"documents_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["pin_id","generation_id","model_identity","dimension","document_ids","documents_sha256"],"additionalProperties":false}},"triggers":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["schedule"]},"id":{"type":"string","minLength":1,"maxLength":128},"cron":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string","minLength":1,"maxLength":64},"input":{"type":"object","additionalProperties":{}}},"required":["kind","id","cron","timezone","input"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["event"]},"id":{"type":"string","minLength":1,"maxLength":128},"event_type":{"type":"string","enum":["run.ended","analysis.updated"]},"source":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"channel":{"type":"string","enum":["cloud","phone","web"]},"dispositions":{"type":"array","items":{"type":"string","minLength":1},"maxItems":32}},"additionalProperties":false},"input_mapping":{"type":"object","additionalProperties":{"type":"string","pattern":"^\\/[A-Za-z0-9_/-]*$"}}},"required":["kind","id","event_type","source","input_mapping"],"additionalProperties":false}]}},"providers":{"type":"object","properties":{"llm":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"route":{"type":"string","enum":["platform","fleet","simulated"]},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128},"provider":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version","provider"],"additionalProperties":false,"nullable":true}},"required":["model","route","credential"],"additionalProperties":false},"analysis":{"allOf":[{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ModelIdentity"},"route":{"type":"string","enum":["platform","fleet","simulated"]},"credential":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128},"provider":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version","provider"],"additionalProperties":false,"nullable":true}},"required":["model","route","credential"],"additionalProperties":false}],"nullable":true},"stt":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":128},"model":{"type":"string","minLength":1,"maxLength":128},"route":{"type":"string","enum":["platform","fleet","simulated"]},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1}},"required":["provider","model","route","languages"],"additionalProperties":false,"nullable":true},"tts":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":128},"model":{"type":"string","minLength":1,"maxLength":128},"voice_id":{"type":"string","minLength":1,"maxLength":128},"route":{"type":"string","enum":["platform","simulated"]},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1}},"required":["provider","model","voice_id","route","languages"],"additionalProperties":false,"nullable":true}},"required":["llm","analysis","stt","tts"],"additionalProperties":false},"analysis":{"type":"array","items":{"type":"object","additionalProperties":{}}},"policy":{"type":"object","properties":{"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["policy_version"],"additionalProperties":false}},"required":["plan_schema_version","compiler","agent","source","channels","languages","flow","actions","notifications","knowledge","triggers","providers","analysis","policy"],"additionalProperties":false},"PublicationRef":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"required":["agent_id","version","digest"],"additionalProperties":false},"PublicationsGetResponse200":{"type":"object","properties":{"ref":{"$ref":"#/components/schemas/PublicationRef"},"published_at":{"type":"string","format":"date-time"},"published_by":{"allOf":[{"$ref":"#/components/schemas/PrincipalRef"}],"nullable":true},"is_head":{"type":"boolean"},"test":{"type":"boolean"},"plan":{"$ref":"#/components/schemas/PublicationPlan"},"layout":{"$ref":"#/components/schemas/AgentLayout"}},"required":["ref","published_at","published_by","is_head","test","plan","layout"],"additionalProperties":false},"PublicationsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"ref":{"$ref":"#/components/schemas/PublicationRef"},"plan_schema_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1},"source_kind":{"type":"string","enum":["studio","retell_import","api"]},"published_at":{"type":"string","format":"date-time"},"published_by":{"$ref":"#/components/schemas/PrincipalRef"},"is_head":{"type":"boolean"},"test":{"type":"boolean"}},"required":["ref","plan_schema_version","channels","languages","source_kind","published_at","published_by","is_head","test"],"additionalProperties":false}},"next_cursor":{"type":"string","maxLength":1024,"nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"PublicationsPromoteRequest":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":2147483647},"expected_head_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"draft_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true}},"required":["version","expected_head_version"],"additionalProperties":false},"PublicationsPromoteResponse200":{"type":"object","properties":{"agent":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["agent"]},"id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"}},"required":["tenant_id","kind","id"],"additionalProperties":false},"from_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"to_version":{"type":"integer","minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"moved":{"type":"boolean"}},"required":["agent","from_version","to_version","digest","moved"],"additionalProperties":false},"PublicationsPublishRequest":{"type":"object","properties":{"draft_id":{"type":"string","format":"uuid"},"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"version":{"type":"integer","minimum":0,"maximum":2147483647},"live":{"type":"boolean","default":true},"keep_draft":{"type":"boolean","default":false},"expected_head_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true}},"required":["draft_id","expected_revision","version"],"additionalProperties":false},"Run":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"run_id":{"type":"string","format":"uuid"},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"publication":{"$ref":"#/components/schemas/PublicationRef"},"plan_schema_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"channel":{"type":"string","enum":["cloud","phone","web"]},"mode":{"type":"string","enum":["task","chat","background","outbound","inbound"]},"state":{"type":"string","enum":["admitted","running","ending","completed","failed","cancelled","rejected","expired"]},"phone_state":{"type":"string","enum":["admitted","preparing","awaiting_sip","dialing","ringing","active","terminating","ended","rejected","expired","setup_failed"],"nullable":true},"outcome":{"allOf":[{"$ref":"#/components/schemas/RunOutcome"}],"nullable":true},"disposition":{"type":"string","nullable":true},"trigger":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["sip"]},"number_id":{"type":"string","format":"uuid"},"call_id_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["kind","number_id","call_id_sha256"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["api"]},"idempotency_key_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["kind","idempotency_key_sha256"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["schedule"]},"trigger_id":{"type":"string","minLength":1,"maxLength":128},"scheduled_for":{"type":"string","format":"date-time"}},"required":["kind","trigger_id","scheduled_for"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["event"]},"trigger_id":{"type":"string","minLength":1,"maxLength":128},"source_event_id":{"type":"string","format":"uuid"}},"required":["kind","trigger_id","source_event_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["callback"]},"source_run_id":{"type":"string","format":"uuid"},"effect_id":{"type":"string","format":"uuid"}},"required":["kind","source_run_id","effect_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["evaluation"]},"comparison_id":{"type":"string","format":"uuid"}},"required":["kind","comparison_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["test"]},"test_run_id":{"type":"string","format":"uuid"},"suite_id":{"type":"string","format":"uuid"},"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"trial":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","test_run_id","suite_id","case_id","trial"],"additionalProperties":false}]},"principal":{"$ref":"#/components/schemas/PrincipalRef"},"attempt_count":{"type":"integer","minimum":0},"created_at":{"type":"string","format":"date-time"},"started_at":{"type":"string","format":"date-time","nullable":true},"ended_at":{"type":"string","format":"date-time","nullable":true},"version":{"type":"integer","minimum":0,"maximum":2147483647},"to":{"type":"string","minLength":1,"maxLength":64,"nullable":true},"from":{"type":"string","minLength":1,"maxLength":64,"nullable":true},"duration_ms":{"type":"integer","minimum":0,"nullable":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"test":{"type":"boolean"},"provider_keys":{"type":"object","additionalProperties":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","enum":["platform"]}},"required":["source"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","enum":["tenant"]},"last4":{"type":"string","minLength":1,"maxLength":4},"fingerprint":{"type":"string","pattern":"^sha256:[a-f0-9]{12}$"}},"required":["source","last4","fingerprint"],"additionalProperties":false}]}}},"required":["owner_id","environment","tenant_id","run_id","agent_id","publication","plan_schema_version","channel","mode","state","phone_state","outcome","disposition","trigger","principal","attempt_count","created_at","started_at","ended_at","version","to","from","duration_ms","metadata","test"],"additionalProperties":false},"RunOutcome":{"type":"object","properties":{"transport":{"type":"string","enum":["completed","busy","no_answer","rejected","cancelled","provider_failure","admission_expired","not_applicable"]},"execution":{"type":"string","enum":["completed","failed","cancelled","not_started","unknown"]},"contact":{"type":"string","enum":["human","voicemail","ivr","unknown","not_applicable"]},"business":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["known"]},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["status","value"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unknown"]}},"required":["status"],"additionalProperties":false}]},"reason":{"type":"string","minLength":1,"maxLength":128},"result":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true}},"required":["transport","execution","contact","business","reason","result"],"additionalProperties":false},"RunsAnalysisResponse200":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["pending","running","completed","failed","not_requested"]},"evaluation_id":{"type":"string","format":"uuid","nullable":true},"disposition":{"type":"string","maxLength":128,"nullable":true},"successful":{"type":"boolean","nullable":true},"fields":{"type":"object","additionalProperties":{}},"model":{"allOf":[{"$ref":"#/components/schemas/ModelIdentity"}],"nullable":true},"completed_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["run_id","state","evaluation_id","disposition","successful","fields","model","completed_at"],"additionalProperties":false},"RunsCancelRequest":{"type":"object","properties":{"reason":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$","default":"customer_cancelled"}},"additionalProperties":false},"RunsCapacityResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["cloud","phone","web"]},"active":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"admission_enabled":{"type":"boolean"}},"required":["channel","active","limit","admission_enabled"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"RunsCreateRequest":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string","enum":["cloud"]},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"mode":{"type":"string","enum":["task","chat"]},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{"type":"string","maxLength":512},"default":{}},"test":{"type":"boolean","default":false}},"required":["channel","agent_id","mode","input"],"additionalProperties":false},{"type":"object","properties":{"channel":{"type":"string","enum":["phone"]},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"to":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"},"from":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"},"dynamic_variables":{"type":"object","additionalProperties":{"type":"string","maxLength":4096},"default":{}},"metadata":{"type":"object","additionalProperties":{"type":"string","maxLength":512},"default":{}},"test":{"type":"boolean","default":false}},"required":["channel","agent_id","to"],"additionalProperties":false}]},"RunsEffectsResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/EffectRecord"}}},"required":["items"],"additionalProperties":false},"RunsEventsResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SemanticEvent"}},"next_after_sequence":{"type":"integer","minimum":0,"nullable":true}},"required":["items","next_after_sequence"],"additionalProperties":false},"RunsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Run"}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"RunsRecordingResponse200":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["pending","recording","processing","ready","partial","failed","not_required","expired"]},"url":{"type":"string","format":"uri","nullable":true,"description":"Link to play or share the recording: a signed URL, or the agent's unsigned public link when it opted out of signed URLs"},"url_expires_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"media_url":{"type":"string","format":"uri","nullable":true,"description":"Direct signed URL of the recording bytes, for your own clients to read the audio (for example to draw a waveform): valid for at most five minutes and pinned to the recorded version. Do not share it; read runs.recording again for a fresh one when it expires"},"media_url_expires_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true,"description":"When media_url stops working"},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true}},"required":["run_id","state","url","url_expires_at","media_url","media_url_expires_at","content"],"additionalProperties":false},"RunsResultResponse200":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["pending","ready","none","expired"]},"result":{"type":"object","additionalProperties":{},"nullable":true},"output_schema":{"type":"object","additionalProperties":{},"nullable":true},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"purged":{"type":"boolean"}},"required":["run_id","state","result","output_schema","content","purged"],"additionalProperties":false},"RunsSendMessageRequest":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":32000}},"required":["text"],"additionalProperties":false},"RunsSendMessageResponse202":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"index":{"type":"integer","minimum":0}},"required":["run_id","index"],"additionalProperties":false},"RunsTranscriptResponse200":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["complete","partial","not_available","expired"]},"utterances":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"role":{"type":"string","enum":["agent","user"]},"text":{"type":"string"},"segment_id":{"type":"string","minLength":1,"nullable":true},"observed_offset_ms":{"type":"integer","minimum":0,"nullable":true},"interrupted":{"type":"boolean"},"start_ms":{"type":"integer","minimum":0,"nullable":true},"end_ms":{"type":"integer","minimum":0,"nullable":true},"node_id":{"type":"string","minLength":1,"nullable":true}},"required":["index","role","text","segment_id","observed_offset_ms","interrupted","start_ms","end_ms","node_id"],"additionalProperties":false}},"checkpoint":{"type":"object","properties":{"segments":{"type":"integer","minimum":0},"last_completed_turn_offset_ms":{"type":"integer","minimum":0},"published_at":{"type":"string","format":"date-time"}},"required":["segments","last_completed_turn_offset_ms","published_at"],"additionalProperties":false,"nullable":true},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true}},"required":["run_id","state","utterances","checkpoint","content"],"additionalProperties":false},"RunsUpdateGetResponse200":{"type":"object","properties":{"update_id":{"type":"string","format":"uuid"},"run_id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":0},"status":{"type":"string","enum":["acknowledged","applying","applied","rejected","indeterminate"]},"acknowledged_at":{"type":"string","format":"date-time"},"deadline":{"type":"string","format":"date-time"},"completed_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"reason":{"type":"string","maxLength":256,"nullable":true},"applied":{"type":"boolean"}},"required":["update_id","run_id","revision","status","acknowledged_at","deadline","completed_at","reason","applied"],"additionalProperties":false},"RunsUpdateRequest":{"type":"object","properties":{"override_dynamic_variables":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"metadata":{"type":"object","additionalProperties":{},"nullable":true}},"additionalProperties":false},"RunsUpdateResponse200":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"update":{"$ref":"#/components/schemas/RunsUpdateGetResponse200"}},"required":["run_id","update"],"additionalProperties":false},"RunsUsageResponse200":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"connected_ms":{"type":"integer","minimum":0,"nullable":true},"llm_input_tokens":{"type":"integer","minimum":0,"nullable":true},"llm_output_tokens":{"type":"integer","minimum":0,"nullable":true},"stt_ms":{"type":"integer","minimum":0,"nullable":true},"tts_characters":{"type":"integer","minimum":0,"nullable":true},"measurements":{"type":"integer","minimum":0},"cost":{"type":"object","properties":{"currency":{"type":"string","enum":["USD"]},"amount":{"allOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"}],"nullable":true},"completeness":{"type":"string","enum":["complete","partial","unpriced"]}},"required":["currency","amount","completeness"],"additionalProperties":false}},"required":["run_id","connected_ms","llm_input_tokens","llm_output_tokens","stt_ms","tts_characters","measurements","cost"],"additionalProperties":false},"SecretMetadata":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"name":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"kind":{"type":"string","enum":["webhook_signing","http_auth","sip_auth"]},"current_version":{"type":"string","minLength":1,"maxLength":128},"versions":{"type":"array","items":{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":128},"created_at":{"type":"string","format":"date-time"}},"required":["version","created_at"],"additionalProperties":false},"minItems":1},"created_at":{"type":"string","format":"date-time"}},"required":["id","name","kind","current_version","versions","created_at"],"additionalProperties":false},"SecretsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SecretMetadata"}}},"required":["items"],"additionalProperties":false},"SecretsPutRequest":{"type":"object","properties":{"kind":{"type":"string","enum":["webhook_signing","http_auth","sip_auth"]},"value":{"type":"string","minLength":1,"maxLength":16384}},"required":["kind","value"],"additionalProperties":false},"SemanticEvent":{"anyOf":[{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.admitted"]},"data":{"type":"object","properties":{"channel":{"type":"string","enum":["cloud","phone","web"]},"mode":{"type":"string","enum":["task","chat","background","outbound","inbound"]},"trigger":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["sip"]},"number_id":{"type":"string","format":"uuid"},"call_id_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["kind","number_id","call_id_sha256"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["api"]},"idempotency_key_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["kind","idempotency_key_sha256"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["schedule"]},"trigger_id":{"type":"string","minLength":1,"maxLength":128},"scheduled_for":{"type":"string","format":"date-time"}},"required":["kind","trigger_id","scheduled_for"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["event"]},"trigger_id":{"type":"string","minLength":1,"maxLength":128},"source_event_id":{"type":"string","format":"uuid"}},"required":["kind","trigger_id","source_event_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["callback"]},"source_run_id":{"type":"string","format":"uuid"},"effect_id":{"type":"string","format":"uuid"}},"required":["kind","source_run_id","effect_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["evaluation"]},"comparison_id":{"type":"string","format":"uuid"}},"required":["kind","comparison_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["test"]},"test_run_id":{"type":"string","format":"uuid"},"suite_id":{"type":"string","format":"uuid"},"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"trial":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["kind","test_run_id","suite_id","case_id","trial"],"additionalProperties":false}]},"principal":{"$ref":"#/components/schemas/PrincipalRef"},"input_sha256":{"allOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"}],"nullable":true}},"required":["channel","mode","trigger","principal","input_sha256"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.state_changed"]},"data":{"type":"object","properties":{"from":{"type":"string","enum":["admitted","running","ending","completed","failed","cancelled","rejected","expired"]},"to":{"type":"string","enum":["admitted","running","ending","completed","failed","cancelled","rejected","expired"]},"phone_from":{"type":"string","enum":["admitted","preparing","awaiting_sip","dialing","ringing","active","terminating","ended","rejected","expired","setup_failed"],"nullable":true},"phone_to":{"type":"string","enum":["admitted","preparing","awaiting_sip","dialing","ringing","active","terminating","ended","rejected","expired","setup_failed"],"nullable":true},"reason":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}},"required":["from","to","phone_from","phone_to","reason"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.attempt_started"]},"data":{"type":"object","properties":{"attempt_id":{"type":"string","format":"uuid"},"attempt_number":{"type":"integer","exclusiveMinimum":true,"minimum":0},"worker_kind":{"type":"string","enum":["voice","jobs"]},"worker_version":{"type":"string","minLength":1,"maxLength":128}},"required":["attempt_id","attempt_number","worker_kind","worker_version"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.attempt_ended"]},"data":{"type":"object","properties":{"attempt_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["succeeded","failed","abandoned"]},"reason":{"allOf":[{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}],"nullable":true}},"required":["attempt_id","state","reason"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.node_entered"]},"data":{"type":"object","properties":{"node_id":{"type":"string","minLength":1,"maxLength":128},"component_id":{"allOf":[{"type":"string","minLength":1,"maxLength":128}],"nullable":true},"from_node_id":{"allOf":[{"type":"string","minLength":1,"maxLength":128}],"nullable":true},"via":{"type":"string","enum":["prompt_edge","automatic","action_result","start","global","flex_task"]}},"required":["node_id","component_id","from_node_id","via"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.message"]},"data":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"role":{"type":"string","enum":["user","agent"]},"tokens":{"allOf":[{"type":"integer","minimum":0}],"nullable":true}},"required":["index","role","tokens"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["transcript.updated"]},"data":{"type":"object","properties":{"segments":{"type":"integer","minimum":0},"complete":{"type":"boolean"}},"required":["segments","complete"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.ended"]},"data":{"type":"object","properties":{"outcome":{"$ref":"#/components/schemas/RunOutcome"},"disposition":{"type":"string","minLength":1,"maxLength":128,"nullable":true},"duration_ms":{"type":"integer","minimum":0},"connected_ms":{"allOf":[{"type":"integer","minimum":0}],"nullable":true}},"required":["outcome","disposition","duration_ms","connected_ms"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["phone.sip_received"]},"data":{"type":"object","properties":{"trunk_id":{"type":"string","minLength":1,"maxLength":128}},"required":["trunk_id"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["phone.amd_verdict"]},"data":{"type":"object","properties":{"verdict":{"type":"string","enum":["human","voicemail","ivr","unknown"]},"detection_ms":{"type":"integer","minimum":0}},"required":["verdict","detection_ms"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["phone.voicemail"]},"data":{"type":"object","properties":{"outcome":{"type":"string","enum":["hung_up","left","interrupted"]}},"required":["outcome"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["phone.transfer"]},"data":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"},"node_id":{"type":"string","minLength":1,"maxLength":128},"ordinal":{"type":"integer","exclusiveMinimum":true,"minimum":0},"phase":{"type":"string","enum":["refer_sent","refer_accepted","confirmed","failed","uncertain"]},"sip_status":{"type":"integer","nullable":true}},"required":["effect_id","node_id","ordinal","phase","sip_status"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["action.requested"]},"data":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"},"action_id":{"type":"string","minLength":1,"maxLength":128},"action_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"effect_kind":{"type":"string","enum":["none","transaction","gateway_inference","http","livekit","sip_dial","sip_transfer","sip_hangup","run_admission","gpu"]},"node_id":{"allOf":[{"type":"string","minLength":1,"maxLength":128}],"nullable":true},"ordinal":{"type":"integer","minimum":0},"input_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["effect_id","action_id","action_version","effect_kind","node_id","ordinal","input_sha256"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["action.decided"]},"data":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"}},"required":["effect_id"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["effect.sent"]},"data":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"},"send_attempt":{"type":"integer","exclusiveMinimum":true,"minimum":0},"idempotency_key_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["effect_id","send_attempt","idempotency_key_sha256"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["effect.settled"]},"data":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["succeeded","failed","uncertain"]},"receipt_sha256":{"allOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"}],"nullable":true},"reason":{"allOf":[{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}],"nullable":true},"action_id":{"type":"string","minLength":1,"maxLength":128},"action_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"effect_kind":{"type":"string","enum":["none","transaction","gateway_inference","http","livekit","sip_dial","sip_transfer","sip_hangup","run_admission","gpu"]},"node_id":{"allOf":[{"type":"string","minLength":1,"maxLength":128}],"nullable":true},"ordinal":{"allOf":[{"type":"integer","minimum":0}],"nullable":true},"send_attempts":{"type":"integer","minimum":0}},"required":["effect_id","state","receipt_sha256","reason"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["knowledge.retrieved"]},"data":{"type":"object","properties":{"pin_id":{"type":"string","format":"uuid"},"generation_id":{"type":"string","format":"uuid"},"chunks":{"type":"integer","minimum":0}},"required":["pin_id","generation_id","chunks"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["recording.updated"]},"data":{"type":"object","properties":{"state":{"type":"string","enum":["pending","recording","processing","ready","partial","failed","not_required"]},"artifactId":{"type":"string"},"reason":{"type":"string"}},"required":["state"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["analysis.updated"]},"data":{"type":"object","properties":{"state":{"type":"string","enum":["pending","running","completed","failed","not_requested"]},"evaluation_id":{"type":"string","format":"uuid","nullable":true},"reason":{"allOf":[{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}],"nullable":true}},"required":["state","evaluation_id","reason"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["publication.published"]},"data":{"type":"object","properties":{"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"plan_schema_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"compiler_version":{"type":"string","minLength":1,"maxLength":64},"channels":{"type":"array","items":{"type":"string","enum":["cloud","phone"]},"minItems":1},"languages":{"type":"array","items":{"type":"string","enum":["en","es"]},"minItems":1},"published_by":{"$ref":"#/components/schemas/PrincipalRef"}},"required":["digest","plan_schema_version","compiler_version","channels","languages","published_by"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["publication.head_moved"]},"data":{"type":"object","properties":{"from_version":{"allOf":[{"type":"integer","minimum":0,"maximum":2147483647}],"nullable":true},"to_version":{"type":"integer","minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"moved_by":{"$ref":"#/components/schemas/PrincipalRef"}},"required":["from_version","to_version","digest","moved_by"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["gateway.request.admitted"]},"data":{"type":"object","properties":{"producer_kind":{"type":"string","enum":["talos_session","talos_analysis","talos_cloud","test_caller","evaluation","knowledge","internal"]},"selection_kind":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"model_identity":{"allOf":[{"$ref":"#/components/schemas/ModelIdentity"}],"nullable":true}},"required":["producer_kind","selection_kind","model_identity"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["gateway.attempt.rejected"]},"data":{"type":"object","properties":{"ordinal":{"type":"integer","minimum":0},"target_identity":{"$ref":"#/components/schemas/ModelIdentity"},"reasons":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}}},"required":["ordinal","target_identity","reasons"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["gateway.attempt.consumed"]},"data":{"type":"object","properties":{"attempt_id":{"type":"string","format":"uuid"},"ordinal":{"type":"integer","minimum":0},"model_identity":{"$ref":"#/components/schemas/ModelIdentity"}},"required":["attempt_id","ordinal","model_identity"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["gateway.attempt.finished"]},"data":{"type":"object","properties":{"attempt_id":{"type":"string","format":"uuid"},"status":{"type":"integer"},"provider_request_id":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"measurement_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"latency_ms":{"type":"integer","minimum":0}},"required":["attempt_id","status","provider_request_id","measurement_id","latency_ms"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["gateway.attempt.uncertain"]},"data":{"type":"object","properties":{"attempt_id":{"type":"string","format":"uuid"},"reason":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}},"required":["attempt_id","reason"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["gateway.request.completed"]},"data":{"type":"object","properties":{"status":{"type":"integer"},"final_attempt_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true}},"required":["status","final_attempt_id"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["operation.applied"]},"data":{"type":"object","properties":{"command":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"state":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"payload_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["command","state","payload_sha256"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["evaluation.recorded"]},"data":{"type":"object","properties":{"kind":{"type":"string","enum":["manual","judge","analysis"]},"rubric_id":{"type":"string","minLength":1,"maxLength":128},"rubric_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"score":{"type":"number","minimum":0,"maximum":1,"nullable":true}},"required":["kind","rubric_id","rubric_version","score"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["comparison.started"]},"data":{"type":"object","properties":{"baseline":{"$ref":"#/components/schemas/PublicationRef"},"candidate":{"$ref":"#/components/schemas/PublicationRef"}},"required":["baseline","candidate"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["comparison.case_settled"]},"data":{"type":"object","properties":{"baseline":{"$ref":"#/components/schemas/PublicationRef"},"candidate":{"$ref":"#/components/schemas/PublicationRef"},"case_run_id":{"type":"string","format":"uuid"},"verdict":{"type":"string","enum":["candidate","baseline","tie","unscored"]}},"required":["baseline","candidate","case_run_id","verdict"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["comparison.completed"]},"data":{"type":"object","properties":{"baseline":{"$ref":"#/components/schemas/PublicationRef"},"candidate":{"$ref":"#/components/schemas/PublicationRef"},"summary":{"type":"object","properties":{"cases":{"type":"integer"},"candidate_wins":{"type":"integer"},"baseline_wins":{"type":"integer"},"ties":{"type":"integer"},"unscored":{"type":"integer"}},"required":["cases","candidate_wins","baseline_wins","ties","unscored"],"additionalProperties":false}},"required":["baseline","candidate","summary"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["artifact.stored"]},"data":{"type":"object","properties":{"kind":{"type":"string","enum":["recording","transcript","message","document","analysis","evaluation_case","run_input","run_result"]},"receipt_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true}},"required":["kind","receipt_id"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["artifact.expired"]},"data":{"type":"object","properties":{"kind":{"type":"string","enum":["recording","transcript","message","document","analysis","evaluation_case","run_input","run_result"]},"receipt_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true}},"required":["kind","receipt_id"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["artifact.purged"]},"data":{"type":"object","properties":{"kind":{"type":"string","enum":["recording","transcript","message","document","analysis","evaluation_case","run_input","run_result"]},"receipt_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true}},"required":["kind","receipt_id"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["tenant.voice_configured"]},"data":{"type":"object","properties":{"operation":{"type":"string","enum":["admission","capacity_set","trunk_bind","trunk_unbind"]},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"enabled":{"type":"boolean"},"max_active_calls":{"type":"integer","minimum":1,"maximum":100000},"enabled_trunks":{"type":"integer","minimum":0}},"required":["operation","revision","enabled","max_active_calls","enabled_trunks"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.degraded"]},"data":{"type":"object","properties":{"reason":{"type":"string","enum":["database_unreachable"]},"episodes":{"type":"integer","minimum":0},"unreachable_ms":{"type":"integer","minimum":0},"lost":{"type":"object","properties":{"journal":{"type":"integer","minimum":0},"usage":{"type":"integer","minimum":0},"call_updates":{"type":"integer","minimum":0},"transcript":{"type":"integer","minimum":0}},"required":["journal","usage","call_updates","transcript"],"additionalProperties":false}},"required":["reason","episodes","unreachable_ms","lost"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["run.turn_events"]},"data":{"type":"object","properties":{"engine":{"type":"string","enum":["v2","v3"]},"events":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["caller_turn"]},"at":{"type":"number"},"phase":{"type":"string","enum":["start","pause","resume"]},"speechEndAt":{"type":"number"}},"required":["type","at","phase"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["speculation"]},"at":{"type":"number"},"requestId":{"type":"string","minLength":1,"maxLength":256},"phase":{"type":"string","enum":["fired","cancelled","committed"]}},"required":["type","at","requestId","phase"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["turn_decision"]},"at":{"type":"number"},"requestId":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["reply","wait","fallback"]},"by":{"type":"string","enum":["speculation","decision_only","eou","backstop","host_fallback"]},"reason":{"type":"string","enum":["deadline","refused","refused_greeting","empty","stall","tool_as_text","race"]}},"required":["type","at","requestId","kind"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["agent_line"]},"at":{"type":"number"},"lineId":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["line","atomic"]},"phase":{"type":"string","enum":["first_audio","end"]},"interrupted":{"type":"boolean"},"playbackMs":{"type":"number"}},"required":["type","at","lineId","kind","phase"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["overlap"]},"at":{"type":"number"},"onsetAt":{"type":"number"},"stage":{"type":"string","enum":["A","B","C"]},"verdict":{"type":"string","enum":["hold","duck","yield","early_answer","backchannel","interjection"]},"levelDb":{"type":"number"},"echoScore":{"type":"number"}},"required":["type","at","onsetAt","stage","verdict","levelDb","echoScore"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["atomic_unit"]},"at":{"type":"number"},"unitId":{"type":"string","minLength":1,"maxLength":256},"delivered":{"type":"boolean"},"restarted":{"type":"boolean"}},"required":["type","at","unitId","delivered","restarted"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["compliance_block"]},"at":{"type":"number"},"rule":{"type":"string","minLength":1,"maxLength":256},"clauseHash":{"type":"string","minLength":1,"maxLength":256}},"required":["type","at","rule","clauseHash"],"additionalProperties":false}]},"maxItems":1000}},"required":["engine","events"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["test_run.started"]},"data":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"integer","minimum":0,"maximum":2147483647},"purpose":{"type":"string","enum":["manual","publish_gate","schedule","release"]},"suites":{"type":"array","items":{"type":"object","properties":{"suite_id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["suite_id","revision"],"additionalProperties":false},"minItems":1,"maxItems":10},"trials":{"type":"integer","minimum":0}},"required":["agent_id","version","purpose","suites","trials"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["test_run.trial_settled"]},"data":{"type":"object","properties":{"suite_id":{"type":"string","format":"uuid"},"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"trial":{"type":"integer","exclusiveMinimum":true,"minimum":0},"run_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"verdict":{"type":"string","enum":["passed","failed","errored"]},"reason":{"allOf":[{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}],"nullable":true}},"required":["suite_id","case_id","trial","run_id","verdict","reason"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false},{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"schema_version":{"type":"number","enum":[1]},"subject":{"type":"object","properties":{"kind":{"type":"string","enum":["run","gateway_request","publication","evaluation","comparison","operation","artifact","gpu_deployment","tenant","test_run"]},"id":{"type":"string","minLength":1,"maxLength":256}},"required":["kind","id"],"additionalProperties":false},"correlation_id":{"type":"string","minLength":1,"maxLength":256},"causation_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"producer":{"type":"string","enum":["talos","gateway","control-plane"]},"producer_version":{"type":"string","minLength":1,"maxLength":128},"occurred_at":{"type":"string","format":"date-time"},"privacy_class":{"type":"string","enum":["operational","confidential"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":512},"content":{"allOf":[{"$ref":"#/components/schemas/ContentRef"}],"nullable":true},"run":{"type":"object","properties":{"run_id":{"type":"string","format":"uuid"},"attempt_id":{"type":"string","format":"uuid","nullable":true},"publication":{"$ref":"#/components/schemas/PublicationRef"}},"required":["run_id","attempt_id","publication"],"additionalProperties":false,"nullable":true},"policy":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"decision":{"type":"string","enum":["allow","deny","unavailable"]},"reason":{"type":"string","maxLength":128,"nullable":true},"policy_version":{"type":"string","pattern":"^[a-f0-9]{12}$"}},"required":["action_id","decision","reason","policy_version"],"additionalProperties":false,"nullable":true},"type":{"type":"string","enum":["test_run.completed"]},"data":{"type":"object","properties":{"state":{"type":"string","enum":["completed","cancelled"]},"verdict":{"allOf":[{"type":"string","enum":["passed","failed","errored"]}],"nullable":true},"summary":{"type":"object","properties":{"cases":{"type":"integer","minimum":0},"passed":{"type":"integer","minimum":0},"flaky_passed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"errored":{"type":"integer","minimum":0},"invalid":{"type":"integer","minimum":0},"trials":{"type":"integer","minimum":0},"regressed":{"type":"integer","minimum":0},"fixed":{"type":"integer","minimum":0},"guard_events":{"type":"integer","minimum":0}},"required":["cases","passed","flaky_passed","failed","errored","invalid","trials","regressed","fixed","guard_events"],"additionalProperties":false,"nullable":true}},"required":["state","verdict","summary"],"additionalProperties":false},"sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"recorded_at":{"type":"string","format":"date-time"}},"required":["owner_id","environment","tenant_id","event_id","schema_version","subject","correlation_id","causation_id","producer","producer_version","occurred_at","privacy_class","idempotency_key","content","run","policy","type","data","sequence","recorded_at"],"additionalProperties":false}]},"TeamInviteRequest":{"type":"object","properties":{"email":{"type":"string","pattern":"^(?!\\.)(?!.*\\.\\.)([a-zA-Z0-9_'+\\-\\.]*)[a-zA-Z0-9_+-]@([a-zA-Z0-9][a-zA-Z0-9\\-]*\\.)+[a-zA-Z]{2,}$"},"role":{"type":"string","enum":["admin","member","viewer"]}},"required":["email","role"],"additionalProperties":false},"TeamInviteResponse201":{"type":"object","properties":{"invitation_id":{"type":"string","format":"uuid"},"email":{"type":"string","pattern":"^(?!\\.)(?!.*\\.\\.)([a-zA-Z0-9_'+\\-\\.]*)[a-zA-Z0-9_+-]@([a-zA-Z0-9][a-zA-Z0-9\\-]*\\.)+[a-zA-Z]{2,}$"},"role":{"type":"string","enum":["admin","member","viewer"]},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"delivery":{"allOf":[{"type":"string","enum":["sent","not_configured","failed","uncertain"]}],"nullable":true},"accept_url":{"type":"string","format":"uri","nullable":true}},"required":["invitation_id","email","role","expires_at","created_at","delivery","accept_url"],"additionalProperties":false},"TeamListResponse200":{"type":"object","properties":{"members":{"type":"array","items":{"$ref":"#/components/schemas/TeamSetRoleResponse200"}},"invitations":{"type":"array","items":{"type":"object","properties":{"invitation_id":{"type":"string","format":"uuid"},"email":{"type":"string","pattern":"^(?!\\.)(?!.*\\.\\.)([a-zA-Z0-9_'+\\-\\.]*)[a-zA-Z0-9_+-]@([a-zA-Z0-9][a-zA-Z0-9\\-]*\\.)+[a-zA-Z]{2,}$"},"role":{"type":"string","enum":["admin","member","viewer"]},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["invitation_id","email","role","expires_at","created_at"],"additionalProperties":false}}},"required":["members","invitations"],"additionalProperties":false},"TeamSetRoleRequest":{"type":"object","properties":{"role":{"type":"string","enum":["owner","admin","member","viewer"]},"can_dial":{"type":"boolean"}},"additionalProperties":false},"TeamSetRoleResponse200":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"email":{"type":"string","pattern":"^(?!\\.)(?!.*\\.\\.)([a-zA-Z0-9_'+\\-\\.]*)[a-zA-Z0-9_+-]@([a-zA-Z0-9][a-zA-Z0-9\\-]*\\.)+[a-zA-Z]{2,}$"},"name":{"type":"string","maxLength":256,"nullable":true},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"can_dial":{"type":"boolean"},"joined_at":{"type":"string","format":"date-time"}},"required":["user_id","email","name","role","can_dial","joined_at"],"additionalProperties":false},"TenantSettingsGetResponse200":{"type":"object","properties":{"name":{"type":"string","minLength":1},"display_name":{"type":"string","nullable":true},"retention":{"type":"object","properties":{"recording_days":{"type":"integer","minimum":1,"maximum":3650},"transcript_days":{"type":"integer","minimum":1,"maximum":3650},"document_days":{"type":"integer","minimum":1,"maximum":3650,"nullable":true},"source":{"type":"string","enum":["platform_default","tenant"]},"version":{"type":"integer","minimum":0}},"required":["recording_days","transcript_days","document_days","source","version"],"additionalProperties":false}},"required":["name","display_name","retention"],"additionalProperties":false},"TenantSettingsUpdateRequest":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":128,"nullable":true},"retention":{"type":"object","properties":{"recording_days":{"type":"integer","minimum":1,"maximum":3650},"transcript_days":{"type":"integer","minimum":1,"maximum":3650},"document_days":{"type":"integer","minimum":1,"maximum":3650,"nullable":true},"expected_version":{"type":"integer","minimum":0}},"required":["recording_days","transcript_days","document_days","expected_version"],"additionalProperties":false}},"additionalProperties":false},"TestCase":{"type":"object","properties":{"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"name":{"type":"string","minLength":1,"maxLength":200},"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":10,"default":[]},"mode":{"type":"string","enum":["text","audio"],"default":"text"},"language":{"type":"string","enum":["en","es"]},"caller":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["persona"]},"goal":{"type":"string","minLength":1,"maxLength":500},"brief":{"type":"string","minLength":1,"maxLength":4000},"facts":{"type":"object","additionalProperties":{"type":"string","maxLength":512},"default":{}},"behavior":{"type":"object","properties":{"verbosity":{"type":"string","enum":["short","normal","rambling"],"default":"short"},"patience":{"type":"integer","minimum":1,"maximum":10,"default":3},"interrupts":{"type":"string","enum":["never","sometimes","often"],"default":"never"},"pauses":{"type":"string","enum":["never","sometimes","often"],"default":"never"},"backchannels":{"type":"string","enum":["never","sometimes","often"],"default":"never"}},"additionalProperties":false,"default":{}}},"required":["kind","goal","brief"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["script"]},"steps":{"type":"array","items":{"type":"object","properties":{"says":{"type":"string","minLength":1,"maxLength":1000},"keypad":{"type":"object","properties":{"keys":{"type":"string","pattern":"^[0-9*#]{1,64}$"},"interval_ms":{"type":"integer","minimum":50,"maximum":1000,"default":120}},"required":["keys"],"additionalProperties":false},"plays":{"type":"object","properties":{"kind":{"type":"string","enum":["screener_prompt","voicemail_greeting"]},"text":{"type":"string","minLength":1,"maxLength":1000},"beep":{"type":"boolean","default":true}},"required":["kind"],"additionalProperties":false},"level_db":{"type":"number","minimum":-60,"maximum":0},"silence_ms":{"type":"integer","minimum":500,"maximum":600000},"pause_before_ms":{"type":"integer","minimum":300,"maximum":5000},"interrupt_at_ms":{"type":"integer","minimum":0,"maximum":15000},"expect":{"type":"object","properties":{"lands":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20}},"required":["lands"],"additionalProperties":false}},"additionalProperties":false},"minItems":1,"maxItems":30}},"required":["kind","steps"],"additionalProperties":false}]},"voice":{"type":"object","properties":{"voice_id":{"type":"string","minLength":1,"maxLength":128},"rate":{"type":"number","minimum":0.7,"maximum":1.3,"default":1},"channel":{"type":"string","enum":["pstn","wideband"],"default":"pstn"},"background":{"type":"object","properties":{"kind":{"type":"string","enum":["none","room","car","street","babble","music"]},"snr_db":{"type":"number","minimum":0,"maximum":40}},"required":["kind","snr_db"],"additionalProperties":false,"default":{"kind":"none","snr_db":40}},"echo":{"type":"object","properties":{"level_db":{"type":"number","minimum":-40,"maximum":-3},"delay_ms":{"type":"integer","minimum":20,"maximum":600}},"required":["level_db","delay_ms"],"additionalProperties":false,"nullable":true,"default":null}},"required":["voice_id"],"additionalProperties":false,"nullable":true,"default":null},"dynamic_variables":{"type":"object","additionalProperties":{"type":"string","maxLength":4096},"default":{}},"mocks":{"type":"array","items":{"type":"object","properties":{"action_id":{"type":"string","minLength":1,"maxLength":128},"when":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","maxLength":256,"pattern":"^(\\/[^/]*)*$"},"op":{"type":"string","enum":["equals","one_of","contains","regex","exists","absent","number_range"]},"value":{}},"required":["path","op"],"additionalProperties":false},"maxItems":10,"default":[]},"respond":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["response"]},"status":{"type":"integer","minimum":100,"maximum":599},"body":{},"delay_ms":{"type":"integer","minimum":0,"maximum":60000}},"required":["kind","status"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["error"]},"error":{"type":"string","enum":["timeout","network"]},"delay_ms":{"type":"integer","minimum":0,"maximum":60000}},"required":["kind","error"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["transfer"]},"outcome":{"type":"string","enum":["answered","busy","no_answer","failed"]},"delay_ms":{"type":"integer","minimum":0,"maximum":60000}},"required":["kind","outcome"],"additionalProperties":false}]},"times":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100}},"required":["action_id","respond"],"additionalProperties":false},"maxItems":50,"default":[]},"max_turns":{"type":"integer","minimum":1,"maximum":30,"default":12},"timeout_ms":{"type":"integer","minimum":30000,"maximum":600000},"trials":{"type":"integer","minimum":1,"maximum":30},"pass_policy":{"type":"string","enum":["majority","all"],"default":"majority"},"blocking":{"type":"boolean","default":true},"assertions":{"type":"array","items":{"$ref":"#/components/schemas/Assertion"},"minItems":1,"maxItems":20}},"required":["case_id","name","language","caller","assertions"],"additionalProperties":false},"TestRun":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"test_run_id":{"type":"string","format":"uuid"},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"publication":{"$ref":"#/components/schemas/PublicationRef"},"purpose":{"type":"string","enum":["manual","publish_gate","schedule","release"]},"suites":{"type":"array","items":{"type":"object","properties":{"suite_id":{"type":"string","format":"uuid"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"required":["suite_id","revision","digest"],"additionalProperties":false},"minItems":1,"maxItems":10},"state":{"type":"string","enum":["queued","running","completed","cancelled"]},"verdict":{"type":"string","enum":["passed","failed","errored"],"nullable":true},"progress":{"type":"object","properties":{"trials":{"type":"integer","minimum":0},"admitted":{"type":"integer","minimum":0},"settled":{"type":"integer","minimum":0}},"required":["trials","admitted","settled"],"additionalProperties":false},"summary":{"type":"object","properties":{"cases":{"type":"integer","minimum":0},"passed":{"type":"integer","minimum":0},"flaky_passed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"errored":{"type":"integer","minimum":0},"invalid":{"type":"integer","minimum":0},"trials":{"type":"integer","minimum":0},"regressed":{"type":"integer","minimum":0},"fixed":{"type":"integer","minimum":0},"guard_events":{"type":"integer","minimum":0}},"required":["cases","passed","flaky_passed","failed","errored","invalid","trials","regressed","fixed","guard_events"],"additionalProperties":false,"nullable":true},"baseline_test_run_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"judge_model":{"allOf":[{"$ref":"#/components/schemas/ModelIdentity"}],"nullable":true},"cost":{"type":"object","properties":{"estimated_usd":{"type":"number","minimum":0},"measured_usd":{"type":"number","minimum":0,"nullable":true}},"required":["estimated_usd","measured_usd"],"additionalProperties":false},"created_by":{"$ref":"#/components/schemas/PrincipalRef"},"created_at":{"type":"string","format":"date-time"},"finished_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["owner_id","environment","tenant_id","test_run_id","agent_id","publication","purpose","suites","state","verdict","progress","summary","baseline_test_run_id","judge_model","cost","created_by","created_at","finished_at"],"additionalProperties":false},"TestRunCreateRequest":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"suite_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":10},"case_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"minItems":1,"maxItems":100},"trials":{"type":"integer","minimum":1,"maximum":10},"baseline_test_run_id":{"type":"string","format":"uuid"}},"required":["agent_id","version","suite_ids"],"additionalProperties":false},"TestRunsCancelRequest":{"type":"object","properties":{},"additionalProperties":false},"TestRunsEstimateResponse200":{"type":"object","properties":{"trials":{"type":"integer","minimum":0},"est_cost_usd":{"type":"number","minimum":0},"est_minutes":{"type":"number","minimum":0}},"required":["trials","est_cost_usd","est_minutes"],"additionalProperties":false},"TestRunsListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TestRun"}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"TestRunsResultsResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"suite_id":{"type":"string","format":"uuid"},"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"name":{"type":"string","minLength":1,"maxLength":200},"verdict":{"type":"string","enum":["passed","flaky_passed","failed","errored","invalid"],"nullable":true},"change":{"type":"string","enum":["fixed","regressed","unchanged","new","removed"],"nullable":true},"blocking":{"type":"boolean"},"diagnostics":{"type":"array","items":{"$ref":"#/components/schemas/Diagnostic"},"maxItems":50},"trials":{"type":"array","items":{"$ref":"#/components/schemas/TrialResult"},"maxItems":30}},"required":["suite_id","case_id","name","verdict","change","blocking","diagnostics","trials"],"additionalProperties":false}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"TestRunsTrialResponse200":{"type":"object","properties":{"test_run_id":{"type":"string","format":"uuid"},"suite_id":{"type":"string","format":"uuid"},"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"name":{"type":"string","minLength":1,"maxLength":200},"result":{"$ref":"#/components/schemas/TrialResult"},"case":{"type":"object","properties":{"run":{"$ref":"#/components/schemas/Run"},"language":{"type":"string","enum":["en","es"]},"turns":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"role":{"type":"string","enum":["user","agent"]},"text":{"type":"string","maxLength":32000},"node_id":{"allOf":[{"type":"string","minLength":1,"maxLength":128}],"nullable":true},"at_ms":{"allOf":[{"type":"integer","minimum":0}],"nullable":true}},"required":["index","role","text","node_id","at_ms"],"additionalProperties":false},"maxItems":2000},"path":{"type":"array","items":{"type":"object","properties":{"node_id":{"type":"string","minLength":1,"maxLength":128},"turn":{"type":"integer","minimum":0},"via":{"type":"string","enum":["prompt_edge","automatic","action_result","start","global","flex_task"]}},"required":["node_id","turn","via"],"additionalProperties":false},"maxItems":2000},"tool_calls":{"type":"array","items":{"type":"object","properties":{"effect_id":{"type":"string","format":"uuid"},"action_id":{"type":"string","minLength":1,"maxLength":128},"node_id":{"allOf":[{"type":"string","minLength":1,"maxLength":128}],"nullable":true},"turn":{"type":"integer","minimum":0},"args":{},"answered_by":{"anyOf":[{"type":"object","properties":{"mock":{"type":"integer","minimum":0}},"required":["mock"],"additionalProperties":false},{"type":"string","enum":["source_receipt"]},{"type":"string","enum":["unmocked"]},{"type":"string","enum":["default"]}]},"state":{"type":"string","enum":["succeeded","failed"]},"error_code":{"type":"string","maxLength":128,"nullable":true}},"required":["effect_id","action_id","node_id","turn","answered_by","state","error_code"],"additionalProperties":false},"maxItems":500},"transfer":{"type":"object","properties":{"node_id":{"type":"string","minLength":1,"maxLength":128},"turn":{"type":"integer","minimum":0}},"required":["node_id","turn"],"additionalProperties":false,"nullable":true},"ended":{"type":"object","properties":{"reason":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"class":{"type":"string","enum":["completed","transferred","caller_hangup","max_turns","timeout","failed","cancelled","inactivity"]},"disposition":{"type":"string","maxLength":128,"nullable":true},"infrastructure":{"type":"boolean"}},"required":["reason","class","disposition","infrastructure"],"additionalProperties":false},"variables":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"guard_events":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["compliance_block"]},"turn":{"type":"integer","minimum":0},"rule":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"clause_hash":{"type":"string","minLength":1,"maxLength":256}},"required":["type","turn","rule","clause_hash"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rpc_unconfirmed"]},"turn":{"type":"integer","minimum":0}},"required":["type","turn"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["atomic_unit"]},"turn":{"type":"integer","minimum":0},"unit_id":{"type":"string","minLength":1,"maxLength":256},"delivered":{"type":"boolean"}},"required":["type","turn","unit_id","delivered"],"additionalProperties":false}]},"maxItems":2000},"caller_trace":{"type":"object","properties":{"clock":{"type":"string","enum":["participant"]},"outcome":{"type":"string","enum":["completed","failed","timeout"]},"truncated":{"type":"boolean"},"lines":{"type":"array","items":{"type":"object","properties":{"step":{"type":"integer","nullable":true},"start":{"type":"number"},"end":{"type":"number"},"pauses":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"],"additionalProperties":false},"maxItems":10},"kind":{"type":"string","enum":["line","interjection","backchannel","beep","keypad"]}},"required":["step","start","end","pauses","kind"],"additionalProperties":false},"maxItems":200},"agent_audio":{"type":"array","items":{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"number"},{"type":"number"}]},"maxItems":2000},"joined_at_unix_ms":{"type":"integer","minimum":0,"nullable":true,"default":null}},"required":["clock","lines","agent_audio"],"additionalProperties":false,"nullable":true},"redaction":{"type":"object","properties":{"policy_version":{"type":"string","minLength":1}},"required":["policy_version"],"additionalProperties":false,"nullable":true},"cost_usd":{"type":"number","minimum":0,"nullable":true}},"required":["run","language","turns","path","tool_calls","transfer","ended","variables","guard_events","caller_trace","redaction","cost_usd"],"additionalProperties":false,"nullable":true}},"required":["test_run_id","suite_id","case_id","name","result","case"],"additionalProperties":false},"TestSessionsCreateRequest":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"dynamic_variables":{"type":"object","additionalProperties":{"type":"string","maxLength":4096},"default":{}},"metadata":{"type":"object","additionalProperties":{"type":"string","maxLength":512},"default":{}}},"required":["agent_id","version"],"additionalProperties":false},"TestSessionsCreateResponse201":{"type":"object","properties":{"session_id":{"type":"string","format":"uuid"},"run_id":{"type":"string","format":"uuid"},"livekit_url":{"type":"string","format":"uri","pattern":"^wss?:\\/\\/"},"room":{"type":"string","minLength":1,"maxLength":256},"participant_identity":{"type":"string","minLength":1,"maxLength":128},"participant_token":{"type":"string","minLength":1},"expires_at":{"type":"string","format":"date-time"}},"required":["session_id","run_id","livekit_url","room","participant_identity","participant_token","expires_at"],"additionalProperties":false},"TestSuitesCreateRequest":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"name":{"type":"string","minLength":1,"maxLength":200},"spec":{"$ref":"#/components/schemas/TestSuiteSpec"}},"required":["agent_id","name","spec"],"additionalProperties":false},"TestSuitesEditRequest":{"type":"object","properties":{"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"edits":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"op":{"type":"string","enum":["set_name"]},"name":{"type":"string","minLength":1,"maxLength":200}},"required":["op","name"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","enum":["upsert_case"]},"case":{"$ref":"#/components/schemas/TestCase"}},"required":["op","case"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","enum":["remove_case"]},"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"}},"required":["op","case_id"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","enum":["reorder_cases"]},"case_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"maxItems":100}},"required":["op","case_ids"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","enum":["set_source"]},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["selector"]},"window_days":{"type":"integer","minimum":1,"maximum":90},"versions":{"type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647},"maxItems":20},"contact":{"type":"array","items":{"type":"string","enum":["human","voicemail","ivr","unknown"]},"minItems":1,"default":["human"]},"dispositions":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"maxItems":32},"min_caller_turns":{"type":"integer","minimum":1,"default":1},"sample":{"type":"string","enum":["latest","stratified_by_disposition"],"default":"latest"},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["kind","window_days","limit"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["runs"]},"run_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200}},"required":["kind","run_ids"],"additionalProperties":false}]}},"required":["op","source"],"additionalProperties":false}]},"minItems":1,"maxItems":100}},"required":["expected_revision","edits"],"additionalProperties":false},"TestSuitesListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"suite_id":{"type":"string","format":"uuid"},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"name":{"type":"string","minLength":1,"maxLength":200},"kind":{"type":"string","enum":["simulation","replay"]},"required":{"type":"boolean"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"case_count":{"type":"integer","minimum":0},"updated_at":{"type":"string","format":"date-time"},"last_run":{"type":"object","properties":{"test_run_id":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"state":{"type":"string","enum":["queued","running","completed","cancelled"]},"verdict":{"type":"string","enum":["passed","failed","errored"],"nullable":true},"created_at":{"type":"string","format":"date-time"},"finished_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["test_run_id","version","state","verdict","created_at","finished_at"],"additionalProperties":false,"nullable":true}},"required":["owner_id","environment","tenant_id","suite_id","agent_id","name","kind","required","revision","digest","case_count","updated_at","last_run"],"additionalProperties":false}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false},"TestSuiteSpec":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["simulation"]},"cases":{"type":"array","items":{"$ref":"#/components/schemas/TestCase"},"minItems":1,"maxItems":100}},"required":["kind","cases"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["replay"]},"source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["selector"]},"window_days":{"type":"integer","minimum":1,"maximum":90},"versions":{"type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647},"maxItems":20},"contact":{"type":"array","items":{"type":"string","enum":["human","voicemail","ivr","unknown"]},"minItems":1,"default":["human"]},"dispositions":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"},"maxItems":32},"min_caller_turns":{"type":"integer","minimum":1,"default":1},"sample":{"type":"string","enum":["latest","stratified_by_disposition"],"default":"latest"},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["kind","window_days","limit"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["runs"]},"run_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200}},"required":["kind","run_ids"],"additionalProperties":false}]},"trials":{"type":"integer","minimum":1,"maximum":3,"default":1},"population":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["regression"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"metric":{"type":"string","enum":["outcome_agreement","edge_agreement"]},"tolerance_per_30":{"type":"integer","minimum":0,"maximum":30,"default":1}},"required":["type","id","metric"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["judged_divergence"]},"id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"max_judged_worse":{"type":"integer","minimum":0}},"required":["type","id","max_judged_worse"],"additionalProperties":false}]},"minItems":1,"maxItems":5},"every_case":{"type":"array","items":{"$ref":"#/components/schemas/Assertion"},"maxItems":10,"default":[]}},"required":["kind","source","population"],"additionalProperties":false}]},"TestSuitesValidateRequest":{"anyOf":[{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":2147483647}},"required":["version"],"additionalProperties":false},{"type":"object","properties":{"draft":{"type":"boolean","enum":[true]}},"required":["draft"],"additionalProperties":false}]},"TestSuitesValidateResponse200":{"type":"object","properties":{"ok":{"type":"boolean"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"diagnostics":{"type":"array","items":{"$ref":"#/components/schemas/Diagnostic"},"maxItems":1000}},"required":["ok","revision","diagnostics"],"additionalProperties":false},"TestSuiteView":{"type":"object","properties":{"owner_id":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"tenant_id":{"type":"string","format":"uuid"},"suite_id":{"type":"string","format":"uuid"},"agent_id":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]*$"},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":2147483647},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"spec":{"$ref":"#/components/schemas/TestSuiteSpec"},"created_by":{"$ref":"#/components/schemas/PrincipalRef"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"archived_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true},"last_run":{"type":"object","properties":{"test_run_id":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":0,"maximum":2147483647},"state":{"type":"string","enum":["queued","running","completed","cancelled"]},"verdict":{"type":"string","enum":["passed","failed","errored"],"nullable":true},"created_at":{"type":"string","format":"date-time"},"finished_at":{"allOf":[{"type":"string","format":"date-time"}],"nullable":true}},"required":["test_run_id","version","state","verdict","created_at","finished_at"],"additionalProperties":false,"nullable":true},"flaky_case_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"maxItems":100}},"required":["owner_id","environment","tenant_id","suite_id","agent_id","name","required","revision","digest","spec","created_by","created_at","updated_at","archived_at","last_run","flaky_case_ids"],"additionalProperties":false},"TrialResult":{"type":"object","properties":{"case_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"trial":{"type":"integer","exclusiveMinimum":true,"minimum":0},"attempt":{"type":"integer","exclusiveMinimum":true,"minimum":0},"run_id":{"allOf":[{"type":"string","format":"uuid"}],"nullable":true},"state":{"type":"string","enum":["pending","running","evaluating","settled","cancelled"]},"verdict":{"type":"string","enum":["passed","failed","errored"],"nullable":true},"reason":{"allOf":[{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}],"nullable":true},"assertions":{"type":"array","items":{"type":"object","properties":{"assertion_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"type":{"type":"string","minLength":1,"maxLength":64},"verdict":{"type":"string","enum":["passed","failed","not_applicable","insufficient_data","errored"]},"measured":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"}],"nullable":true}},"evidence":{"type":"object","properties":{"turns":{"type":"array","items":{"type":"integer","minimum":0},"maxItems":50},"node_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"effect_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":20}},"required":["turns","node_ids","effect_ids"],"additionalProperties":false},"judge":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1},"rejudged":{"type":"boolean"},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"verdict":{"type":"string","enum":["pass","fail","na"]},"score":{"type":"integer","minimum":1,"maximum":5,"nullable":true},"evidence_turns":{"type":"array","items":{"type":"integer","minimum":0},"maxItems":20},"rationale":{"type":"string","maxLength":300,"nullable":true}},"required":["id","verdict","score","evidence_turns","rationale"],"additionalProperties":false},"maxItems":12}},"required":["score","rejudged","criteria"],"additionalProperties":false,"nullable":true},"reason":{"allOf":[{"type":"string","pattern":"^[a-z][a-z0-9_.:-]{0,127}$"}],"nullable":true}},"required":["assertion_id","type","verdict","measured","evidence","judge","reason"],"additionalProperties":false},"maxItems":25},"guard":{"type":"object","properties":{"compliance_blocks":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"rpc_unconfirmed":{"type":"integer","minimum":0},"atomic_half_said":{"type":"integer","minimum":0}},"required":["compliance_blocks","rpc_unconfirmed","atomic_half_said"],"additionalProperties":false},"content_state":{"type":"string","enum":["retained","expired"]}},"required":["case_id","trial","attempt","run_id","state","verdict","reason","assertions","guard","content_state"],"additionalProperties":false},"TrunksCreateRequest":{"type":"object","properties":{"trunk_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9][a-z0-9_-]*$"},"name":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","enum":["twilio_elastic_sip","generic_sip"]},"termination_uri":{"type":"string","minLength":1,"maxLength":253,"pattern":"^[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?$"},"auth_username":{"type":"string","minLength":1,"maxLength":256},"auth_secret":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false},"inbound":{"type":"boolean","default":false}},"required":["trunk_id","name","provider","termination_uri","auth_username","auth_secret"],"additionalProperties":false},"TrunksListResponse200":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ByocTrunk"}}},"required":["items"],"additionalProperties":false},"TrunksUpdateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256},"termination_uri":{"type":"string","minLength":1,"maxLength":253,"pattern":"^[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?$"},"auth_username":{"type":"string","minLength":1,"maxLength":256},"auth_secret":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"string","minLength":1,"maxLength":128}},"required":["id","version"],"additionalProperties":false},"inbound":{"type":"boolean"}},"additionalProperties":false},"UsageRateCardResponse200":{"type":"object","properties":{"configured":{"type":"boolean"},"rate_card_id":{"type":"string","minLength":1,"nullable":true},"currency":{"type":"string","enum":["USD"]},"period_start":{"type":"string","format":"date-time","nullable":true},"period_end":{"type":"string","format":"date-time","nullable":true},"rates":{"type":"array","items":{"type":"object","properties":{"rate_id":{"type":"string","minLength":1},"meter":{"type":"string","enum":["telephony.connected_ms","stt.audio_ms","tts.characters","tts.audio_ms"]},"unit":{"type":"string","enum":["ms","character"]},"usd_per_unit":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$"},"display_unit":{"type":"string","enum":["minute","1000_characters"]},"usd_per_display_unit":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$"}},"required":["rate_id","meter","unit","usd_per_unit","display_unit","usd_per_display_unit"],"additionalProperties":false}}},"required":["configured","rate_card_id","currency","period_start","period_end","rates"],"additionalProperties":false},"UsageSummaryResponse200":{"type":"object","properties":{"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"group_by":{"type":"string","enum":["agent","run","day"]},"purpose":{"type":"string","enum":["billable","test"]},"rows":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"runs":{"type":"integer","minimum":0},"connected_ms":{"type":"integer","minimum":0},"llm_input_tokens":{"type":"integer","minimum":0,"nullable":true},"llm_output_tokens":{"type":"integer","minimum":0,"nullable":true},"stt_ms":{"type":"integer","minimum":0,"nullable":true},"tts_characters":{"type":"integer","minimum":0,"nullable":true},"cost":{"type":"object","properties":{"currency":{"type":"string","enum":["USD"]},"amount":{"allOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$"}],"nullable":true},"completeness":{"type":"string","enum":["complete","partial","unpriced"]}},"required":["currency","amount","completeness"],"additionalProperties":false}},"required":["key","runs","connected_ms","llm_input_tokens","llm_output_tokens","stt_ms","tts_characters","cost"],"additionalProperties":false}},"completeness":{"type":"string","enum":["complete","partial"]},"next_cursor":{"type":"string","maxLength":1024,"nullable":true}},"required":["window","group_by","purpose","rows","completeness","next_cursor"],"additionalProperties":false},"VoicesListResponse200":{"type":"object","properties":{"tts":{"type":"object","properties":{"provider":{"type":"string","enum":["elevenlabs","simulated_elevenlabs"]},"models":{"type":"array","items":{"type":"string","minLength":1},"minItems":1},"default_model":{"type":"string","minLength":1},"default_voice_id":{"type":"string","minLength":1}},"required":["provider","models","default_model","default_voice_id"],"additionalProperties":false},"stt":{"type":"object","properties":{"provider":{"type":"string","enum":["elevenlabs","simulated_stt"]},"models":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["provider","models"],"additionalProperties":false},"preview_available":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"voice_id":{"type":"string","minLength":1,"maxLength":256},"name":{"type":"string","minLength":1},"provider":{"type":"string","enum":["elevenlabs","simulated_elevenlabs"]},"category":{"type":"string","nullable":true},"preview_url":{"type":"string","format":"uri","nullable":true},"languages":{"type":"array","items":{"type":"string","minLength":2,"maxLength":8}},"accent":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"use_case":{"type":"string","nullable":true}},"required":["voice_id","name","provider","category","preview_url","languages","accent","gender","age","description","use_case"],"additionalProperties":false}}},"required":["tts","stt","items"],"additionalProperties":false},"VoicesPreviewRequest":{"type":"object","properties":{"voice_id":{"type":"string","minLength":1,"maxLength":256},"model":{"type":"string","minLength":1,"maxLength":128},"language":{"type":"string","enum":["en","es"]},"speed":{"type":"number","minimum":0.5,"maximum":2},"expressiveness":{"type":"number","minimum":0,"maximum":2}},"required":["voice_id","model","language","speed","expressiveness"],"additionalProperties":false},"VoicesPreviewResponse200":{"type":"object","properties":{"audio_base64":{"type":"string","minLength":1,"maxLength":3000000},"media_type":{"type":"string","enum":["audio/mpeg"]},"text":{"type":"string"}},"required":["audio_base64","media_type","text"],"additionalProperties":false}}},"tags":[{"name":"agents","x-displayName":"Agents","description":"Create, import, clone, list and delete agents."},{"name":"drafts","x-displayName":"Drafts","description":"The one editable working copy of an agent."},{"name":"publications","x-displayName":"Publications","description":"Immutable versions, and the head that runs use by default."},{"name":"actions","x-displayName":"Actions","description":"The actions a publication can take."},{"name":"models","x-displayName":"Models","description":"Models available to your environment."},{"name":"voices","x-displayName":"Voices","description":"Speech models and voices an agent can use."},{"name":"runs","x-displayName":"Runs","description":"Start cloud and phone runs, follow their events and read what they produced."},{"name":"test_sessions","x-displayName":"Test sessions","description":"Talk to an agent version from a browser."},{"name":"test_suites","x-displayName":"Test suites","description":"Simulated callers and the assertions each conversation must pass."},{"name":"evaluations","x-displayName":"Evaluations","description":"Score runs against a rubric."},{"name":"comparisons","x-displayName":"Comparisons","description":"Compare publication versions on existing runs."},{"name":"test_runs","x-displayName":"Test runs","description":"Run test suites against one agent version and read the verdicts."},{"name":"documents","x-displayName":"Knowledge documents","description":"Upload and manage source documents."},{"name":"knowledge","x-displayName":"Knowledge configuration","description":"Embedding configuration and searchable generations."},{"name":"trunks","x-displayName":"SIP trunks","description":"Bring your own carrier: connect a SIP trunk."},{"name":"numbers","x-displayName":"Phone numbers","description":"Import numbers from a trunk and assign them to agents."},{"name":"call_limits","x-displayName":"Call limits","description":"Your organization's optional daily limit on outbound calls."},{"name":"usage","x-displayName":"Usage","description":"Metered usage and rates."},{"name":"alerts","x-displayName":"Alert rules","description":"Notify on usage and run metrics."},{"name":"alert_destinations","x-displayName":"Alert destinations","description":"Configure Slack and PagerDuty destinations."},{"name":"budgets","x-displayName":"Budgets","description":"The spending cap for your organization."},{"name":"keys","x-displayName":"API keys","description":"Create, rotate and revoke the keys that call this API."},{"name":"secrets","x-displayName":"Secrets","description":"Write-only values agents reference: webhook signing, HTTP and SIP credentials."},{"name":"provider_keys","x-displayName":"Provider credentials","description":"Use your own model-provider credentials."},{"name":"team","x-displayName":"Members and invitations","description":"Manage workspace access."},{"name":"tenant_settings","x-displayName":"Workspace settings","description":"Display name and data retention."},{"name":"audit","x-displayName":"Audit log","description":"Read the workspace audit history."},{"name":"environments","x-displayName":"Environments","description":"Your organization's production and sandbox environments."}],"x-tagGroups":[{"name":"Agents","tags":["agents","drafts","publications","actions","models","voices"]},{"name":"Runs","tags":["runs","test_sessions"]},{"name":"Testing","tags":["test_suites","evaluations","comparisons","test_runs"]},{"name":"Knowledge","tags":["documents","knowledge"]},{"name":"Phone","tags":["trunks","numbers","call_limits"]},{"name":"Usage","tags":["usage","alerts","alert_destinations","budgets"]},{"name":"Access","tags":["keys","secrets","provider_keys","team","tenant_settings","audit","environments"]}]}