A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.
Advice about the draft's values as they stand, each naming its field (field, label, code, message). Never a refusal: the save and Publish go ahead. Today: an opening line that already says what Sempera adds after it (the AI disclosure, or the recording notice when calls are recorded), so callers would hear it twice.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Sempera Docs","description":"Build, test and run Sempera phone agents from your own code. One hostname, one credential model, one contract.","colors":{"primary":"#176e3c","light":"#34d77e","dark":"#176e3c"},"logo":{"light":"https://mintcdn.com/sempera/BFZIRfLeGhKa12-h/logo/light.svg?fit=max\u0026auto=format\u0026n=BFZIRfLeGhKa12-h\u0026q=85\u0026s=197dd5eaf7dc9a1818d4172dc949b1ba","dark":"https://mintcdn.com/sempera/BFZIRfLeGhKa12-h/logo/dark.svg?fit=max\u0026auto=format\u0026n=BFZIRfLeGhKa12-h\u0026q=85\u0026s=4a299ab69a4466b868af4aabdc59fe09"},"favicon":"https://mintcdn.com/sempera/BFZIRfLeGhKa12-h/favicon.svg?fit=max\u0026auto=format\u0026n=BFZIRfLeGhKa12-h\u0026q=85\u0026s=ac66c2604bc29953fdb21fc003d7a7f9","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"background":{"color":{"light":"#ffffff","dark":"#171512"}},"navbar":{"links":[{"href":"mailto:hello@sempera.org","label":"Contact"}],"primary":{"type":"button","label":"Log in to the App","href":"https://app.sempera.org"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/sempera-ai","x":"https://x.com/SemperaAI"}},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Sempera App","icon":"layout-dashboard","href":"https://app.sempera.org"},{"anchor":"OpenAPI contract","icon":"braces","href":"https://api.sempera.org/openapi.json"},{"anchor":"sempera.org","icon":"globe","href":"https://sempera.org"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sempera","hasAudioNarration":false,"actualSubdomain":"sempera","customDomains":["docs.sempera.org"],"gitSource":{"type":"github","owner":"sempera-ai","repo":"docs-site","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6aec92ebe14133cbd36a8e1a"},"chroma":{"latestBuiltDeploymentHistoryId":"6aec935ee14133cbd36aab83","collectionId":"42cdc5cc-53f2-4f03-a4f7-abdfdd604cca","liveDeploymentHistoryId":"6aec935ee14133cbd36aab83","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aecc972a42a54473993172d","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".sidebar-group-header,.sidebar-title,.eyebrow{text-transform:none}"}],"page":{"pagePath":"api-reference/agents/read-the-draft","slug":"/api-reference/agents/read-the-draft","pageMetadata":{"title":"Read the draft","description":null,"deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/draft","href":"/api-reference/agents/read-the-draft","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Read the draft","description":null,"deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/draft","href":"/api-reference/agents/read-the-draft","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getAgentDraft","summary":"Read the draft","tags":["Agents"],"parameters":["c5cffc3b-8eea-4719-8c8c-7c123c51941b"],"security":["37543173-fbfd-4f58-a39d-34206d48fcff"],"x-sempera-scope":"agents:read","responses":{"200":"034153d6-926f-43b6-93ce-9e98810c1d13","400":"fe376438-29e0-4e6d-891a-2d1567f803a1","401":"9067121c-c9bf-49bf-92a9-4e3ab38d5676","403":"1cceeaa7-f046-494c-83c9-cdfaeb2cb7e2","404":"eb43ab1e-e9c5-4b1e-8674-61ce3a68a373","409":"8326a5fe-8f60-47f5-ac79-0dda852191ad","429":"08bcf427-3f0a-4ca2-8780-5b743396e1ba"},"method":"get","type":"path","servers":["f0861052-13c5-4d7b-8266-2c872aff2e40"],"path":"/v1/agents/{agent_id}/draft","baseUrlOptions":["https://api.sempera.org"],"title":"Read the draft","description":"","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c5cffc3b-8eea-4719-8c8c-7c123c51941b":{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The agent's stable id.","uniqueKey":"","typeLabel":"string"},"description":"The agent's stable id."}},"responses":{"034153d6-926f-43b6-93ce-9e98810c1d13":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"const":"agent_draft","uniqueKey":"object","typeLabel":"any"},"agent_id":{"type":"string","uniqueKey":"agent_id","typeLabel":"string"},"revision":{"oneOf":[{"type":"string","uniqueKey":"revision.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"revision.oneOf.1","typeLabel":"null"}],"uniqueKey":"revision","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","uniqueKey":"updated_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string | null"},"by":{"oneOf":[{"type":"string","uniqueKey":"by.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"by.oneOf.1","typeLabel":"null"}],"uniqueKey":"by","typeLabel":"string | null"},"fields":{"type":"object","uniqueKey":"fields","typeLabel":"object"},"warnings":{"type":"array","description":"Advice about the draft's values as they stand, each naming its field (`field`, `label`, `code`, `message`). Never a refusal: the save and Publish go ahead. Today: an opening line that already says what Sempera adds after it (the AI disclosure, or the recording notice when calls are recorded), so callers would hear it twice.","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"warnings.items.[INDEX].field","typeLabel":"string"},"label":{"type":"string","uniqueKey":"warnings.items.[INDEX].label","typeLabel":"string"},"code":{"type":"string","uniqueKey":"warnings.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"warnings.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"warnings.items.[INDEX]","typeLabel":"object"},"uniqueKey":"warnings","typeLabel":"object[]"},"summary":{"oneOf":[{}],"uniqueKey":"summary","typeLabel":"any"},"editable_fields":{"oneOf":[{}],"uniqueKey":"editable_fields","typeLabel":"any"},"result":{"oneOf":[{}],"uniqueKey":"result","typeLabel":"any"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"agent_draft","agent_id":"\u003cstring>","revision":"\u003cstring>","updated_at":"\u003cstring>","by":"\u003cstring>","fields":{},"warnings":[{"field":"\u003cstring>","label":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}],"summary":"\u003cunknown>","editable_fields":"\u003cunknown>","result":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fe376438-29e0-4e6d-891a-2d1567f803a1":{"description":"Validation failed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["AGENT_ENV_UNPINNED","CALL_RL_PLAN_ALLOWANCE","CALL_RL_PLAN_CONCURRENCY","CALL_RL_PLAN_DAILY","CALL_RL_PLAN_DAILY_MINUTES","CALL_RL_PLAN_HOURLY","PHONE_AGENT_UNPINNED","PHONE_APPROVAL_EXPIRED","PHONE_APPROVAL_INVALID","PHONE_APPROVAL_REQUIRED","PHONE_COST_UNKNOWN","PHONE_DESTINATION_BLOCKED","PHONE_FUNDING_NOT_LIVE","PHONE_NUMBER_MISSING","PHONE_OUTSIDE_HOURS","PHONE_PLAN_INACTIVE","PHONE_RECIPIENT_OPTED_OUT","SMS_RL_PLAN_ALLOWANCE","SMS_RL_PLAN_DAILY","SMS_RL_PLAN_HOURLY","authentication_required","capability_unavailable","conflict","credits_exhausted","credits_unavailable","csrf_failed","forbidden","gone","idempotency_key_reused","insufficient_scope","internal_error","invalid_credential","method_not_allowed","not_found","owner_setup_required","payload_too_large","provider_failed","provider_timeout","rate_limited","service_unavailable","validation_failed","workspace_suspended"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","uniqueKey":"error.field","typeLabel":"string"},"scope":{"type":"string","uniqueKey":"error.scope","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.reason","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGENT_ENV_UNPINNED","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","scope":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9067121c-c9bf-49bf-92a9-4e3ab38d5676":{"description":"Authentication required or invalid credential","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["AGENT_ENV_UNPINNED","CALL_RL_PLAN_ALLOWANCE","CALL_RL_PLAN_CONCURRENCY","CALL_RL_PLAN_DAILY","CALL_RL_PLAN_DAILY_MINUTES","CALL_RL_PLAN_HOURLY","PHONE_AGENT_UNPINNED","PHONE_APPROVAL_EXPIRED","PHONE_APPROVAL_INVALID","PHONE_APPROVAL_REQUIRED","PHONE_COST_UNKNOWN","PHONE_DESTINATION_BLOCKED","PHONE_FUNDING_NOT_LIVE","PHONE_NUMBER_MISSING","PHONE_OUTSIDE_HOURS","PHONE_PLAN_INACTIVE","PHONE_RECIPIENT_OPTED_OUT","SMS_RL_PLAN_ALLOWANCE","SMS_RL_PLAN_DAILY","SMS_RL_PLAN_HOURLY","authentication_required","capability_unavailable","conflict","credits_exhausted","credits_unavailable","csrf_failed","forbidden","gone","idempotency_key_reused","insufficient_scope","internal_error","invalid_credential","method_not_allowed","not_found","owner_setup_required","payload_too_large","provider_failed","provider_timeout","rate_limited","service_unavailable","validation_failed","workspace_suspended"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","uniqueKey":"error.field","typeLabel":"string"},"scope":{"type":"string","uniqueKey":"error.scope","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.reason","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGENT_ENV_UNPINNED","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","scope":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1cceeaa7-f046-494c-83c9-cdfaeb2cb7e2":{"description":"Insufficient scope or role","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["AGENT_ENV_UNPINNED","CALL_RL_PLAN_ALLOWANCE","CALL_RL_PLAN_CONCURRENCY","CALL_RL_PLAN_DAILY","CALL_RL_PLAN_DAILY_MINUTES","CALL_RL_PLAN_HOURLY","PHONE_AGENT_UNPINNED","PHONE_APPROVAL_EXPIRED","PHONE_APPROVAL_INVALID","PHONE_APPROVAL_REQUIRED","PHONE_COST_UNKNOWN","PHONE_DESTINATION_BLOCKED","PHONE_FUNDING_NOT_LIVE","PHONE_NUMBER_MISSING","PHONE_OUTSIDE_HOURS","PHONE_PLAN_INACTIVE","PHONE_RECIPIENT_OPTED_OUT","SMS_RL_PLAN_ALLOWANCE","SMS_RL_PLAN_DAILY","SMS_RL_PLAN_HOURLY","authentication_required","capability_unavailable","conflict","credits_exhausted","credits_unavailable","csrf_failed","forbidden","gone","idempotency_key_reused","insufficient_scope","internal_error","invalid_credential","method_not_allowed","not_found","owner_setup_required","payload_too_large","provider_failed","provider_timeout","rate_limited","service_unavailable","validation_failed","workspace_suspended"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","uniqueKey":"error.field","typeLabel":"string"},"scope":{"type":"string","uniqueKey":"error.scope","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.reason","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGENT_ENV_UNPINNED","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","scope":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"eb43ab1e-e9c5-4b1e-8674-61ce3a68a373":{"description":"Not found (or not in your scope)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["AGENT_ENV_UNPINNED","CALL_RL_PLAN_ALLOWANCE","CALL_RL_PLAN_CONCURRENCY","CALL_RL_PLAN_DAILY","CALL_RL_PLAN_DAILY_MINUTES","CALL_RL_PLAN_HOURLY","PHONE_AGENT_UNPINNED","PHONE_APPROVAL_EXPIRED","PHONE_APPROVAL_INVALID","PHONE_APPROVAL_REQUIRED","PHONE_COST_UNKNOWN","PHONE_DESTINATION_BLOCKED","PHONE_FUNDING_NOT_LIVE","PHONE_NUMBER_MISSING","PHONE_OUTSIDE_HOURS","PHONE_PLAN_INACTIVE","PHONE_RECIPIENT_OPTED_OUT","SMS_RL_PLAN_ALLOWANCE","SMS_RL_PLAN_DAILY","SMS_RL_PLAN_HOURLY","authentication_required","capability_unavailable","conflict","credits_exhausted","credits_unavailable","csrf_failed","forbidden","gone","idempotency_key_reused","insufficient_scope","internal_error","invalid_credential","method_not_allowed","not_found","owner_setup_required","payload_too_large","provider_failed","provider_timeout","rate_limited","service_unavailable","validation_failed","workspace_suspended"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","uniqueKey":"error.field","typeLabel":"string"},"scope":{"type":"string","uniqueKey":"error.scope","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.reason","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGENT_ENV_UNPINNED","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","scope":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8326a5fe-8f60-47f5-ac79-0dda852191ad":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["AGENT_ENV_UNPINNED","CALL_RL_PLAN_ALLOWANCE","CALL_RL_PLAN_CONCURRENCY","CALL_RL_PLAN_DAILY","CALL_RL_PLAN_DAILY_MINUTES","CALL_RL_PLAN_HOURLY","PHONE_AGENT_UNPINNED","PHONE_APPROVAL_EXPIRED","PHONE_APPROVAL_INVALID","PHONE_APPROVAL_REQUIRED","PHONE_COST_UNKNOWN","PHONE_DESTINATION_BLOCKED","PHONE_FUNDING_NOT_LIVE","PHONE_NUMBER_MISSING","PHONE_OUTSIDE_HOURS","PHONE_PLAN_INACTIVE","PHONE_RECIPIENT_OPTED_OUT","SMS_RL_PLAN_ALLOWANCE","SMS_RL_PLAN_DAILY","SMS_RL_PLAN_HOURLY","authentication_required","capability_unavailable","conflict","credits_exhausted","credits_unavailable","csrf_failed","forbidden","gone","idempotency_key_reused","insufficient_scope","internal_error","invalid_credential","method_not_allowed","not_found","owner_setup_required","payload_too_large","provider_failed","provider_timeout","rate_limited","service_unavailable","validation_failed","workspace_suspended"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","uniqueKey":"error.field","typeLabel":"string"},"scope":{"type":"string","uniqueKey":"error.scope","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.reason","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGENT_ENV_UNPINNED","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","scope":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"08bcf427-3f0a-4ca2-8780-5b743396e1ba":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["AGENT_ENV_UNPINNED","CALL_RL_PLAN_ALLOWANCE","CALL_RL_PLAN_CONCURRENCY","CALL_RL_PLAN_DAILY","CALL_RL_PLAN_DAILY_MINUTES","CALL_RL_PLAN_HOURLY","PHONE_AGENT_UNPINNED","PHONE_APPROVAL_EXPIRED","PHONE_APPROVAL_INVALID","PHONE_APPROVAL_REQUIRED","PHONE_COST_UNKNOWN","PHONE_DESTINATION_BLOCKED","PHONE_FUNDING_NOT_LIVE","PHONE_NUMBER_MISSING","PHONE_OUTSIDE_HOURS","PHONE_PLAN_INACTIVE","PHONE_RECIPIENT_OPTED_OUT","SMS_RL_PLAN_ALLOWANCE","SMS_RL_PLAN_DAILY","SMS_RL_PLAN_HOURLY","authentication_required","capability_unavailable","conflict","credits_exhausted","credits_unavailable","csrf_failed","forbidden","gone","idempotency_key_reused","insufficient_scope","internal_error","invalid_credential","method_not_allowed","not_found","owner_setup_required","payload_too_large","provider_failed","provider_timeout","rate_limited","service_unavailable","validation_failed","workspace_suspended"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","uniqueKey":"error.field","typeLabel":"string"},"scope":{"type":"string","uniqueKey":"error.scope","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.reason","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGENT_ENV_UNPINNED","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","scope":"\u003cstring>","reason":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"37543173-fbfd-4f58-a39d-34206d48fcff":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"sempera_sk_...","description":"A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.","scopes":["agents:read"],"schemeName":"apiKey"}}},"servers":{"f0861052-13c5-4d7b-8266-2c872aff2e40":{"url":"https://api.sempera.org"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"sempera_sk_...","description":"A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.","scopes":["agents:read"],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"https://api.sempera.org/openapi.json"},"subdomain":"sempera","siteName":"Sempera Docs","title":"Read the draft - Sempera Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T18:22:48.866Z","originalFileLocation":"api-reference/agents/read-the-draft.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Sempera Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read the draft - Sempera Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sempera Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sempera.org/api-reference/agents/read-the-draft\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sempera.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Read+the+draft\u0026amp;theme=e8c706f0d52c141d9a2e088e\u0026amp;signature=8c3aaf17bbd18c64ec2ec694bcac0b39ae0fd321a69cb9a91e70d5ec5b7cb9fe\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Read the draft - Sempera Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sempera.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Read+the+draft\u0026amp;theme=e8c706f0d52c141d9a2e088e\u0026amp;signature=8c3aaf17bbd18c64ec2ec694bcac0b39ae0fd321a69cb9a91e70d5ec5b7cb9fe\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sempera/XANv45edSmb7a7tx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sempera Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#176e3c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sempera.org/api-reference/agents/read-the-draft\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents/read-the-draft.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sempera.org/#organization\",\"name\":\"Sempera Docs\",\"url\":\"https://docs.sempera.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sempera/BFZIRfLeGhKa12-h/logo/light.svg?fit=max\u0026auto=format\u0026n=BFZIRfLeGhKa12-h\u0026q=85\u0026s=197dd5eaf7dc9a1818d4172dc949b1ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sempera.org#website\",\"name\":\"Sempera Docs\",\"url\":\"https://docs.sempera.org\",\"publisher\":{\"@id\":\"https://docs.sempera.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sempera.org/api-reference/agents/read-the-draft#webpage\",\"url\":\"https://docs.sempera.org/api-reference/agents/read-the-draft\",\"name\":\"Read the draft\",\"dateModified\":\"2026-11-05T18:22:48.866Z\",\"isPartOf\":{\"@id\":\"https://docs.sempera.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sempera.org/api-reference/agents/read-the-draft#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sempera.org/api-reference/agents/read-the-draft#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.sempera.org/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read the draft\",\"item\":\"https://docs.sempera.org/api-reference/agents/read-the-draft\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sempera.org/api-reference/agents/read-the-draft#apireference\",\"headline\":\"Read the draft\",\"name\":\"Read the draft\",\"url\":\"https://docs.sempera.org/api-reference/agents/read-the-draft\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sempera.org/api-reference/agents/read-the-draft#webpage\"},\"dateModified\":\"2026-11-05T18:22:48.866Z\",\"publisher\":{\"@id\":\"https://docs.sempera.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sempera.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sempera Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sempera Docs","nav":{"global":{"anchors":[{"anchor":"Sempera App","icon":"layout-dashboard","href":"https://app.sempera.org"},{"anchor":"OpenAPI contract","icon":"braces","href":"https://api.sempera.org/openapi.json"},{"anchor":"sempera.org","icon":"globe","href":"https://sempera.org"}]},"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/api-overview"},{"title":"Authentication and credentials","href":"/authentication"},{"title":"Errors, pagination, idempotency and limits","sidebarTitle":"Errors and limits","href":"/errors-and-limits"},{"title":"Webhooks","href":"/webhooks"}]},{"group":"Meta","pages":[{"title":"A developer guide page (Markdown)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /docs/{page}","href":"/api-reference/meta/a-developer-guide-page-markdown"},{"title":"Retrieval map for coding agents","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /llms.txt","href":"/api-reference/meta/retrieval-map-for-coding-agents"},{"title":"OpenAPI 3.1 document","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /openapi.json","href":"/api-reference/meta/openapi-31-document"},{"title":"Robots policy for the API host","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /robots.txt","href":"/api-reference/meta/robots-policy-for-the-api-host"},{"title":"API front door","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1","href":"/api-reference/meta/api-front-door"},{"title":"Liveness","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/health","href":"/api-reference/meta/liveness"}]},{"group":"Compatibility","pages":[]},{"group":"Scenarios","pages":[{"title":"The judges that score a test scenario's calls","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agent-testing/scenarios/{uuid}/eval-agents","href":"/api-reference/scenarios/the-judges-that-score-a-test-scenarios-calls"},{"title":"Create pathway folders, move pathways and save their order","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/pathway-organization","href":"/api-reference/scenarios/create-pathway-folders-move-pathways-and-save-their-order"},{"title":"List an agent's scenarios","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/scenarios","href":"/api-reference/scenarios/list-an-agents-scenarios"},{"title":"Add a scenario to an agent's draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/scenarios","href":"/api-reference/scenarios/add-a-scenario-to-an-agents-draft"},{"title":"The agent's own words per published version","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/scenarios/agent/history","href":"/api-reference/scenarios/the-agents-own-words-per-published-version"},{"title":"One scenario","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/scenarios/{scenario_uuid}","href":"/api-reference/scenarios/one-scenario"},{"title":"Update a pathway in the agent's draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/scenarios/{scenario_uuid}","href":"/api-reference/scenarios/update-a-pathway-in-the-agents-draft"},{"title":"Delete a scenario (from the draft, or from the archive)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v2/agents/{uuid}/scenarios/{scenario_uuid}","href":"/api-reference/scenarios/delete-a-scenario-from-the-draft-or-from-the-archive"},{"title":"Archive a scenario (out of the draft, restorable)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/scenarios/{scenario_uuid}/archive","href":"/api-reference/scenarios/archive-a-scenario-out-of-the-draft-restorable"},{"title":"Copy a scenario to another agent of this workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/scenarios/{scenario_uuid}/copy","href":"/api-reference/scenarios/copy-a-scenario-to-another-agent-of-this-workspace"},{"title":"One scenario per published version","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/scenarios/{scenario_uuid}/history","href":"/api-reference/scenarios/one-scenario-per-published-version"},{"title":"Restore an archived scenario into the draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/scenarios/{scenario_uuid}/restore","href":"/api-reference/scenarios/restore-an-archived-scenario-into-the-draft"},{"title":"Every agent's scenarios in this workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/scenarios","href":"/api-reference/scenarios/every-agents-scenarios-in-this-workspace"}]},{"group":"Tests","pages":[{"title":"Run bounded concurrent synthetic graph scenarios","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agent-testing/tornado","href":"/api-reference/tests/run-bounded-concurrent-synthetic-graph-scenarios"},{"title":"Read a synthetic graph run receipt","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agent-testing/tornado/{run_id}","href":"/api-reference/tests/read-a-synthetic-graph-run-receipt"},{"title":"Run an offline simulation set","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/simulations","href":"/api-reference/tests/run-an-offline-simulation-set"},{"title":"Read an offline simulation set","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/simulations/{simulation_id}","href":"/api-reference/tests/read-an-offline-simulation-set"},{"title":"List an agent's standards with their latest result","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/standards","href":"/api-reference/tests/list-an-agents-standards-with-their-latest-result"},{"title":"Save a node-level standard (a step, a fixed situation, what the step must do)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/standards","href":"/api-reference/tests/save-a-node-level-standard-a-step-a-fixed-situation-what-the-step-must-do"},{"title":"Run standards against the agent's current version (background job)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/standards/run","href":"/api-reference/tests/run-standards-against-the-agents-current-version-background-job"},{"title":"Standards runs, newest first","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/standards/runs","href":"/api-reference/tests/standards-runs-newest-first"},{"title":"Delete a standard","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/standards/{standard_id}","href":"/api-reference/tests/delete-a-standard"},{"title":"Change a standard","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/standards/{standard_id}","href":"/api-reference/tests/change-a-standard"},{"title":"Failures per graph node over a window, and the weakest link","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/test-analytics","href":"/api-reference/tests/failures-per-graph-node-over-a-window-and-the-weakest-link"},{"title":"Run a turn's situation against the step's current and a candidate instruction (nothing is saved)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/testbed/runs","href":"/api-reference/tests/run-a-turns-situation-against-the-steps-current-and-a-candidate-instruction-nothing-is-saved"},{"title":"A Testbed run and its per-situation comparison","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/testbed/runs/{run_id}","href":"/api-reference/tests/a-testbed-run-and-its-per-situation-comparison"},{"title":"The situation at one turn of a stored conversation: the step, its instruction, the original reply","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/testbed/situation","href":"/api-reference/tests/the-situation-at-one-turn-of-a-stored-conversation:-the-step-its-instruction-the-original-reply"},{"title":"Save a Testbed situation and expectations as a standard","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/testbed/standards","href":"/api-reference/tests/save-a-testbed-situation-and-expectations-as-a-standard"},{"title":"List test runs for an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/tests","href":"/api-reference/tests/list-test-runs-for-an-agent"},{"title":"Run the test battery (background job)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/tests","href":"/api-reference/tests/run-the-test-battery-background-job"},{"title":"Get a test run","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/tests/{test_id}","href":"/api-reference/tests/get-a-test-run"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}","href":"/api-reference/agents/get-an-agent"},{"title":"Delete an agent (irreversible)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/agents/{agent_id}","href":"/api-reference/agents/delete-an-agent-irreversible"},{"title":"Archive (reversible)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/archive","href":"/api-reference/agents/archive-reversible"},{"title":"Deployment ledger","description":null,"deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/deployments","href":"/api-reference/agents/deployment-ledger"},{"title":"Read the draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/draft","href":"/api-reference/agents/read-the-draft"},{"title":"Discard the draft","description":null,"deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/agents/{agent_id}/draft","href":"/api-reference/agents/discard-the-draft"},{"title":"Edit the draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/agents/{agent_id}/draft","href":"/api-reference/agents/edit-the-draft"},{"title":"Read agent business identity","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/identity","href":"/api-reference/agents/read-agent-business-identity"},{"title":"Save agent contact card and business details","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json put /v1/agents/{agent_id}/identity","href":"/api-reference/agents/save-agent-contact-card-and-business-details"},{"title":"Check the contact card delivery boundary","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/identity/send-test","href":"/api-reference/agents/check-the-contact-card-delivery-boundary"},{"title":"Download agent contact card","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/identity/vcard","href":"/api-reference/agents/download-agent-contact-card"},{"title":"Record a business identity review request","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/identity/verification","href":"/api-reference/agents/record-a-business-identity-review-request"},{"title":"Inferred caller-memory schema","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/memory/schema","href":"/api-reference/agents/inferred-caller-memory-schema"},{"title":"Typed preview turn","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/preview","href":"/api-reference/agents/typed-preview-turn"},{"title":"Publish a new immutable version","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/publish","href":"/api-reference/agents/publish-a-new-immutable-version"},{"title":"Roll back to a previous deployment","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/rollback","href":"/api-reference/agents/roll-back-to-a-previous-deployment"},{"title":"Restore an archived agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/unarchive","href":"/api-reference/agents/restore-an-archived-agent"},{"title":"List published versions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/versions","href":"/api-reference/agents/list-published-versions"},{"title":"Save a version of the approved agent specification","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/versions","href":"/api-reference/agents/save-a-version-of-the-approved-agent-specification"},{"title":"Get a version","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/versions/{version_id}","href":"/api-reference/agents/get-a-version"}]},{"group":"Sessions","pages":[{"title":"Read API chat channel","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/channels/api-chat","href":"/api-reference/sessions/read-api-chat-channel"},{"title":"Enable or disable API chat","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/agents/{agent_id}/channels/api-chat","href":"/api-reference/sessions/enable-or-disable-api-chat"},{"title":"Send a message to the published agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/chat","href":"/api-reference/sessions/send-a-message-to-the-published-agent"},{"title":"List sessions for an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/sessions","href":"/api-reference/sessions/list-sessions-for-an-agent"},{"title":"Create a Web voice or simulator session","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sessions","href":"/api-reference/sessions/create-a-web-voice-or-simulator-session"},{"title":"Get a session","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/sessions/{session_id}","href":"/api-reference/sessions/get-a-session"},{"title":"Read live translation availability and recent sessions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/translation-sessions","href":"/api-reference/sessions/read-live-translation-availability-and-recent-sessions"},{"title":"Start a Sempera live translation session","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/translation-sessions","href":"/api-reference/sessions/start-a-sempera-live-translation-session"},{"title":"List the voices a session or draft may name","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/voices","href":"/api-reference/sessions/list-the-voices-a-session-or-draft-may-name"},{"title":"Read this agent's waiting and operator-held widget chats","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/widget-live-chats","href":"/api-reference/sessions/read-this-agents-waiting-and-operator-held-widget-chats"},{"title":"Claim, take over or reply to a widget chat, or return it to the agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/widget-live-chats/{chat_id}","href":"/api-reference/sessions/claim-take-over-or-reply-to-a-widget-chat-or-return-it-to-the-agent"}]},{"group":"Dialing pools","pages":[{"title":"List dialing pools and owned number readiness","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/dialing-pools","href":"/api-reference/dialing-pools/list-dialing-pools-and-owned-number-readiness"},{"title":"Create an owned number pool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/dialing-pools","href":"/api-reference/dialing-pools/create-an-owned-number-pool"},{"title":"Read a dialing pool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/dialing-pools/{pool_id}","href":"/api-reference/dialing-pools/read-a-dialing-pool"},{"title":"Preview caller ID without dialing or reserving","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/dialing-pools/{pool_id}/preview","href":"/api-reference/dialing-pools/preview-caller-id-without-dialing-or-reserving"},{"title":"Replace dialing pool settings","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/dialing-pools/{pool_id}/update","href":"/api-reference/dialing-pools/replace-dialing-pool-settings"}]},{"group":"Knowledge","pages":[{"title":"Read version-bound knowledge retrieval settings","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/knowledge/retrieval-settings","href":"/api-reference/knowledge/read-version-bound-knowledge-retrieval-settings"},{"title":"Stage knowledge retrieval settings in the agent draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json put /v1/agents/{agent_id}/knowledge/retrieval-settings","href":"/api-reference/knowledge/stage-knowledge-retrieval-settings-in-the-agent-draft"},{"title":"List an agent's knowledge sources","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/knowledge-sources","href":"/api-reference/knowledge/list-an-agents-knowledge-sources"},{"title":"Upload a document (multipart)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/knowledge-sources","href":"/api-reference/knowledge/upload-a-document-multipart"},{"title":"Create a plain-text knowledge source","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/knowledge-sources/text","href":"/api-reference/knowledge/create-a-plain-text-knowledge-source"},{"title":"Get a knowledge source","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/knowledge-sources/{source_id}","href":"/api-reference/knowledge/get-a-knowledge-source"},{"title":"Remove a knowledge source","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/knowledge-sources/{source_id}","href":"/api-reference/knowledge/remove-a-knowledge-source"},{"title":"Update a text source without publishing the agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/knowledge-sources/{source_id}","href":"/api-reference/knowledge/update-a-text-source-without-publishing-the-agent"},{"title":"Re-process a source","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/knowledge-sources/{source_id}/reparse","href":"/api-reference/knowledge/re-process-a-source"},{"title":"Ask knowledge using local retrieval, with cited passages","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/knowledge/chat","href":"/api-reference/knowledge/ask-knowledge-using-local-retrieval-with-cited-passages"},{"title":"Read one public page or refresh a previously read page","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/knowledge/crawl","href":"/api-reference/knowledge/read-one-public-page-or-refresh-a-previously-read-page"},{"title":"Link, delete or dismiss a recorded knowledge question","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/knowledge/questions/{question_id}","href":"/api-reference/knowledge/link-delete-or-dismiss-a-recorded-knowledge-question"},{"title":"Ingest an answer and resolve a recorded question","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json put /v1/knowledge/questions/{question_id}/answer","href":"/api-reference/knowledge/ingest-an-answer-and-resolve-a-recorded-question"},{"title":"Test local retrieval against selected or published knowledge","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/knowledge/test","href":"/api-reference/knowledge/test-local-retrieval-against-selected-or-published-knowledge"},{"title":"List source testing choices and pathway nodes","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/knowledge/testing-context","href":"/api-reference/knowledge/list-source-testing-choices-and-pathway-nodes"}]},{"group":"Memory","pages":[{"title":"Enable or disable memory in the agent draft","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/agents/{agent_id}/memory","href":"/api-reference/memory/enable-or-disable-memory-in-the-agent-draft"},{"title":"Create a caller fact or summary","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/memory","href":"/api-reference/memory/create-a-caller-fact-or-summary"},{"title":"Forget one caller line for one agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/memory/reset","href":"/api-reference/memory/forget-one-caller-line-for-one-agent"},{"title":"Correct a caller fact or summary","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/memory/{memory_id}","href":"/api-reference/memory/correct-a-caller-fact-or-summary"}]},{"group":"Messaging","pages":[{"title":"Messaging channel setup","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/messaging","href":"/api-reference/messaging/messaging-channel-setup"},{"title":"List channel conversations","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/messaging/{channel}/conversations","href":"/api-reference/messaging/list-channel-conversations"},{"title":"Read channel conversation","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/agents/{agent_id}/messaging/{channel}/conversations/{conversation_id}","href":"/api-reference/messaging/read-channel-conversation"},{"title":"Check channel send admission","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/agents/{agent_id}/messaging/{channel}/messages","href":"/api-reference/messaging/check-channel-send-admission"}]},{"group":"Alerts","pages":[{"title":"List this organization's metric alert rules","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/alerts","href":"/api-reference/alerts/list-this-organizations-metric-alert-rules"},{"title":"Create a metric alert rule","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/alerts","href":"/api-reference/alerts/create-a-metric-alert-rule"},{"title":"Metrics and channels an alert rule may use","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/alerts/metrics","href":"/api-reference/alerts/metrics-and-channels-an-alert-rule-may-use"},{"title":"Preview an alert without saving or notifying","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/alerts/preview","href":"/api-reference/alerts/preview-an-alert-without-saving-or-notifying"},{"title":"Get a metric alert rule and its trigger log","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/alerts/{id}","href":"/api-reference/alerts/get-a-metric-alert-rule-and-its-trigger-log"},{"title":"Delete a metric alert rule","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/alerts/{id}","href":"/api-reference/alerts/delete-a-metric-alert-rule"},{"title":"Update a metric alert rule","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/alerts/{id}","href":"/api-reference/alerts/update-a-metric-alert-rule"},{"title":"Evaluate a metric alert rule now","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/alerts/{id}/evaluate","href":"/api-reference/alerts/evaluate-a-metric-alert-rule-now"}]},{"group":"API keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key (secret shown once)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/api-keys","href":"/api-reference/api-keys/create-an-api-key-secret-shown-once"},{"title":"Get an API key","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/api-keys/{key_id}","href":"/api-reference/api-keys/get-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/api-keys/{key_id}","href":"/api-reference/api-keys/revoke-an-api-key"},{"title":"Rename an API key","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/api-keys/{key_id}","href":"/api-reference/api-keys/rename-an-api-key"}]},{"group":"Automations","pages":[{"title":"Events a trigger can listen for","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/automation/events","href":"/api-reference/automations/events-a-trigger-can-listen-for"},{"title":"List trigger executions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/automation/executions","href":"/api-reference/automations/list-trigger-executions"},{"title":"Get a trigger execution","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/automation/executions/{id}","href":"/api-reference/automations/get-a-trigger-execution"},{"title":"Send a failed or stalled webhook or tool run again, once","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/automation/executions/{id}/retry","href":"/api-reference/automations/send-a-failed-or-stalled-webhook-or-tool-run-again-once"},{"title":"Create a trigger (one record)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/automation/pipelines","href":"/api-reference/automations/create-a-trigger-one-record"},{"title":"List this organization's triggers","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/automation/triggers","href":"/api-reference/automations/list-this-organizations-triggers"},{"title":"Create a trigger","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/automation/triggers","href":"/api-reference/automations/create-a-trigger"},{"title":"Get a trigger","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/automation/triggers/{id}","href":"/api-reference/automations/get-a-trigger"},{"title":"Delete a trigger","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/automation/triggers/{id}","href":"/api-reference/automations/delete-a-trigger"},{"title":"Update, pause or resume a trigger","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/automation/triggers/{id}","href":"/api-reference/automations/update-pause-or-resume-a-trigger"},{"title":"A trigger's executions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/automation/triggers/{id}/executions","href":"/api-reference/automations/a-triggers-executions"},{"title":"Dry-run a trigger against a sample event (nothing is delivered)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/automation/triggers/{id}/test","href":"/api-reference/automations/dry-run-a-trigger-against-a-sample-event-nothing-is-delivered"}]},{"group":"Calls","pages":[{"title":"List phone calls for an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/calls","href":"/api-reference/calls/list-phone-calls-for-an-agent"},{"title":"Create an outbound call","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/calls","href":"/api-reference/calls/create-an-outbound-call"},{"title":"Stop all active phone calls in this credential's scope","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/calls/active/stop","href":"/api-reference/calls/stop-all-active-phone-calls-in-this-credentials-scope"},{"title":"Transfer an active phone call","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/calls/active/transfer","href":"/api-reference/calls/transfer-an-active-phone-call"},{"title":"Get a phone call","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/calls/{call_id}","href":"/api-reference/calls/get-a-phone-call"},{"title":"Ask questions about a finished phone call","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/calls/{call_id}/analyze","href":"/api-reference/calls/ask-questions-about-a-finished-phone-call"},{"title":"Read a corrected transcript with speaker labels and turn confidence","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/calls/{call_id}/corrected-transcript","href":"/api-reference/calls/read-a-corrected-transcript-with-speaker-labels-and-turn-confidence"},{"title":"Import a corrected transcript; it reads as an unverified owner import","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/calls/{call_id}/corrected-transcript","href":"/api-reference/calls/import-a-corrected-transcript;-it-reads-as-an-unverified-owner-import"},{"title":"Stop one active phone call","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/calls/{call_id}/stop","href":"/api-reference/calls/stop-one-active-phone-call"},{"title":"SSE snapshot of live calls","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/live-calls/stream","href":"/api-reference/calls/sse-snapshot-of-live-calls"},{"title":"SSE snapshot of a live transcript","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/live-calls/transcript/stream","href":"/api-reference/calls/sse-snapshot-of-a-live-transcript"},{"title":"Signed download URL for a call recording","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/recordings/{recording_id}","href":"/api-reference/calls/signed-download-url-for-a-call-recording"}]},{"group":"Citation schemas","pages":[{"title":"List citation schemas","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/citation_schemas","href":"/api-reference/citation-schemas/list-citation-schemas"},{"title":"Score extraction quality over call history","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/citation_schemas/backfill","href":"/api-reference/citation-schemas/score-extraction-quality-over-call-history"},{"title":"List citation schemas (the /list path)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/citation_schemas/list","href":"/api-reference/citation-schemas/list-citation-schemas-the-list-path"}]},{"group":"Connected clients","pages":[{"title":"List connected clients","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/client-grants","href":"/api-reference/connected-clients/list-connected-clients"},{"title":"Create a scoped REST credential (secret shown once)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/client-grants/rest","href":"/api-reference/connected-clients/create-a-scoped-rest-credential-secret-shown-once"},{"title":"Disconnect one client","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/client-grants/{grant_id}","href":"/api-reference/connected-clients/disconnect-one-client"}]},{"group":"Contacts","pages":[{"title":"Merge console contact profiles","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/contacts/merge","href":"/api-reference/contacts/merge-console-contact-profiles"},{"title":"Resolve a workspace contact without guessing","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/contacts/resolve","href":"/api-reference/contacts/resolve-a-workspace-contact-without-guessing"},{"title":"Read organisation contact schema","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/contacts/schema","href":"/api-reference/contacts/read-organisation-contact-schema"},{"title":"Save organisation contact schema","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json put /v1/contacts/schema","href":"/api-reference/contacts/save-organisation-contact-schema"}]},{"group":"Credits","pages":[{"title":"Read the workspace's credit balance","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/credits","href":"/api-reference/credits/read-the-workspaces-credit-balance"},{"title":"List the workspace's credit history","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/credits/history","href":"/api-reference/credits/list-the-workspaces-credit-history"}]},{"group":"Evals","pages":[{"title":"List eval criteria","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals","href":"/api-reference/evals/list-eval-criteria"},{"title":"Create an eval criterion","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/evals","href":"/api-reference/evals/create-an-eval-criterion"},{"title":"Judge templates Sempera ships","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/agent-templates","href":"/api-reference/evals/judge-templates-sempera-ships"},{"title":"This workspace's judges with their latest run","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/agents","href":"/api-reference/evals/this-workspaces-judges-with-their-latest-run"},{"title":"Score one judge template against an agent's recent calls (not saved)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/evals/quick-run","href":"/api-reference/evals/score-one-judge-template-against-an-agents-recent-calls-not-saved"},{"title":"Eval results for an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/results","href":"/api-reference/evals/eval-results-for-an-agent"},{"title":"Judge an agent's completed conversations","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/evals/run","href":"/api-reference/evals/judge-an-agents-completed-conversations"},{"title":"Evaluation runs of this workspace's agents","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/runs","href":"/api-reference/evals/evaluation-runs-of-this-workspaces-agents"},{"title":"One evaluation run with its results","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/runs/{run_id}","href":"/api-reference/evals/one-evaluation-run-with-its-results"},{"title":"Calls a judge can score, with their verdicts","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/test-cases","href":"/api-reference/evals/calls-a-judge-can-score-with-their-verdicts"},{"title":"Saved judge suites for this workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/user-templates","href":"/api-reference/evals/saved-judge-suites-for-this-workspace"},{"title":"Save a judge suite (a named bundle of templates for one agent)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/evals/user-templates","href":"/api-reference/evals/save-a-judge-suite-a-named-bundle-of-templates-for-one-agent"},{"title":"Get an eval criterion","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/{eval_id}","href":"/api-reference/evals/get-an-eval-criterion"},{"title":"Archive an eval criterion","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/evals/{eval_id}","href":"/api-reference/evals/archive-an-eval-criterion"},{"title":"Update an eval criterion","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/evals/{eval_id}","href":"/api-reference/evals/update-an-eval-criterion"},{"title":"Propose judge tuning from corrected production-call verdicts; save nothing","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/evals/{eval_id}/align","href":"/api-reference/evals/propose-judge-tuning-from-corrected-production-call-verdicts;-save-nothing"},{"title":"Recent completed production calls available to this judge","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/evals/{eval_id}/production-calls","href":"/api-reference/evals/recent-completed-production-calls-available-to-this-judge"},{"title":"Evaluate selected stored production calls without saving a second copy","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/evals/{eval_id}/production-run","href":"/api-reference/evals/evaluate-selected-stored-production-calls-without-saving-a-second-copy"}]},{"group":"Integrations","pages":[{"title":"List integrations","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/integrations","href":"/api-reference/integrations/list-integrations"},{"title":"Create an integration","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/integrations","href":"/api-reference/integrations/create-an-integration"},{"title":"Compatibility integration detail","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/integrations/{integration_id}","href":"/api-reference/integrations/compatibility-integration-detail"},{"title":"Disable an integration","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/integrations/{integration_id}","href":"/api-reference/integrations/disable-an-integration"},{"title":"Update an integration","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/integrations/{integration_id}","href":"/api-reference/integrations/update-an-integration"},{"title":"Compatibility integration actions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/integrations/{integration_id}/actions","href":"/api-reference/integrations/compatibility-integration-actions"},{"title":"Verify an integration's connection","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/integrations/{integration_id}/verify","href":"/api-reference/integrations/verify-an-integrations-connection"}]},{"group":"MCP","pages":[{"title":"MCP JSON-RPC over HTTP","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/mcp","href":"/api-reference/mcp/mcp-json-rpc-over-http"},{"title":"Setup guidance for connecting one coding-agent client","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/mcp/clients/{client}","href":"/api-reference/mcp/setup-guidance-for-connecting-one-coding-agent-client"},{"title":"List connected AI clients","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/mcp/connections","href":"/api-reference/mcp/list-connected-ai-clients"},{"title":"Connect an AI client (secret shown once)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/mcp/connections","href":"/api-reference/mcp/connect-an-ai-client-secret-shown-once"},{"title":"Disconnect an AI client","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/mcp/connections/{connection_id}","href":"/api-reference/mcp/disconnect-an-ai-client"}]},{"group":"Authentication","pages":[{"title":"Describe the calling credential","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/me","href":"/api-reference/authentication/describe-the-calling-credential"}]},{"group":"Models","pages":[{"title":"List Sempera's published TTS models and their capabilities","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/models","href":"/api-reference/models/list-semperas-published-tts-models-and-their-capabilities"},{"title":"Public, unauthenticated model discovery","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/models","href":"/api-reference/models/public-unauthenticated-model-discovery"},{"title":"List what each Sempera TTS model supports","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/tts/models","href":"/api-reference/models/list-what-each-sempera-tts-model-supports"},{"title":"What one Sempera TTS model supports","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/tts/models/{model_id}","href":"/api-reference/models/what-one-sempera-tts-model-supports"}]},{"group":"Workspaces","pages":[{"title":"Read the organization's Sempera service pin","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/org/service-version","href":"/api-reference/workspaces/read-the-organizations-sempera-service-pin"},{"title":"Pin new sessions to an installed Sempera release","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json put /v1/org/service-version","href":"/api-reference/workspaces/pin-new-sessions-to-an-installed-sempera-release"},{"title":"List installed Sempera service versions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/org/service-versions","href":"/api-reference/workspaces/list-installed-sempera-service-versions"},{"title":"List workspaces","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Get a workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/workspaces/{workspace_id}","href":"/api-reference/workspaces/get-a-workspace"},{"title":"Rename a workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/workspaces/{workspace_id}","href":"/api-reference/workspaces/rename-a-workspace"}]},{"group":"Organizations","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/organizations","href":"/api-reference/organizations/list-organizations"},{"title":"Create a reseller-funded child organisation","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/organizations","href":"/api-reference/organizations/create-a-reseller-funded-child-organisation"},{"title":"Get an organization","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/organizations/{organization_id}","href":"/api-reference/organizations/get-an-organization"}]},{"group":"Personas","pages":[{"title":"List compiled personas","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/personas","href":"/api-reference/personas/list-compiled-personas"},{"title":"Get a compiled persona","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/personas/{persona_id}","href":"/api-reference/personas/get-a-compiled-persona"}]},{"group":"Phone","pages":[{"title":"Send an approved text","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-messages","href":"/api-reference/phone/send-an-approved-text"},{"title":"Preview a text and get its owner approval link","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-messages/preview","href":"/api-reference/phone/preview-a-text-and-get-its-owner-approval-link"},{"title":"Poll a phone signup","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-onboarding/poll","href":"/api-reference/phone/poll-a-phone-signup"},{"title":"Start an owner-approved phone signup","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-onboarding/start","href":"/api-reference/phone/start-an-owner-approved-phone-signup"},{"title":"Read the phone line, plan and allowance","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/phone-profile","href":"/api-reference/phone/read-the-phone-line-plan-and-allowance"},{"title":"Start an approved call","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-tasks","href":"/api-reference/phone/start-an-approved-call"},{"title":"Preview a call and get its owner approval link","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-tasks/preview","href":"/api-reference/phone/preview-a-call-and-get-its-owner-approval-link"},{"title":"Read a phone task and its result","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/phone-tasks/{task_id}","href":"/api-reference/phone/read-a-phone-task-and-its-result"},{"title":"Cancel a phone task","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-tasks/{task_id}/cancel","href":"/api-reference/phone/cancel-a-phone-task"},{"title":"Read a text thread on the plan's number","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/phone-threads/{thread_id}","href":"/api-reference/phone/read-a-text-thread-on-the-plans-number"}]},{"group":"Phone numbers","pages":[{"title":"List phone numbers bound to an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/phone-numbers","href":"/api-reference/phone-numbers/list-phone-numbers-bound-to-an-agent"},{"title":"Bind a phone number to an agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/phone-numbers","href":"/api-reference/phone-numbers/bind-a-phone-number-to-an-agent"}]},{"group":"Platform","pages":[{"title":"Deployment identity and capacity (CI/certification)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/platform","href":"/api-reference/platform/deployment-identity-and-capacity-cicertification"}]},{"group":"Prompts","pages":[{"title":"List this workspace's saved prompts","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/prompts","href":"/api-reference/prompts/list-this-workspaces-saved-prompts"},{"title":"Save a prompt for future use","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/prompts","href":"/api-reference/prompts/save-a-prompt-for-future-use"},{"title":"Get a saved prompt","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/prompts/{prompt_id}","href":"/api-reference/prompts/get-a-saved-prompt"}]},{"group":"Developer settings","pages":[{"title":"Every agent version put on an environment in this workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/release-deployments","href":"/api-reference/developer-settings/every-agent-version-put-on-an-environment-in-this-workspace"},{"title":"Add a workspace secret (the value is never returned)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/secrets","href":"/api-reference/developer-settings/add-a-workspace-secret-the-value-is-never-returned"},{"title":"Delete a workspace secret","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/secrets/{id}","href":"/api-reference/developer-settings/delete-a-workspace-secret"},{"title":"Rename a workspace secret, replace a Static value, or pause and resume it","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/secrets/{id}","href":"/api-reference/developer-settings/rename-a-workspace-secret-replace-a-static-value-or-pause-and-resume-it"},{"title":"Fetch a Refresh secret's value now (the value is never returned)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/secrets/{id}/refresh","href":"/api-reference/developer-settings/fetch-a-refresh-secrets-value-now-the-value-is-never-returned"},{"title":"JWT request signing settings and keys","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/signing","href":"/api-reference/developer-settings/jwt-request-signing-settings-and-keys"},{"title":"Update JWT request signing","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/signing","href":"/api-reference/developer-settings/update-jwt-request-signing"},{"title":"Generate or rotate the signing key","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/signing/keys","href":"/api-reference/developer-settings/generate-or-rotate-the-signing-key"},{"title":"Withdraw every signing key but the active one","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/signing/keys/revoke-previous","href":"/api-reference/developer-settings/withdraw-every-signing-key-but-the-active-one"},{"title":"A workspace's public signing keys (JWKS)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/workspaces/{workspace_id}/.well-known/jwks.json","href":"/api-reference/developer-settings/a-workspaces-public-signing-keys-jwks"}]},{"group":"SMS","pages":[{"title":"Send a bounded SMS batch","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/batch","href":"/api-reference/sms/send-a-bounded-sms-batch"},{"title":"Get SMS conversation","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/sms/conversations/{conversation_id}","href":"/api-reference/sms/get-sms-conversation"},{"title":"end SMS conversation","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/conversations/{conversation_id}/end","href":"/api-reference/sms/end-sms-conversation"},{"title":"handoff SMS conversation","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/conversations/{conversation_id}/handoff","href":"/api-reference/sms/handoff-sms-conversation"},{"title":"List SMS messages","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/sms/conversations/{conversation_id}/messages","href":"/api-reference/sms/list-sms-messages"},{"title":"Send conversation message","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/conversations/{conversation_id}/messages","href":"/api-reference/sms/send-conversation-message"},{"title":"Record an SMS opt-out without sending","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/conversations/{conversation_id}/opt-out","href":"/api-reference/sms/record-an-sms-opt-out-without-sending"},{"title":"Read SMS consent and sending policy","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/sms/conversations/{conversation_id}/policy","href":"/api-reference/sms/read-sms-consent-and-sending-policy"},{"title":"resume SMS conversation","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/conversations/{conversation_id}/resume","href":"/api-reference/sms/resume-sms-conversation"},{"title":"Send SMS","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/sms/send","href":"/api-reference/sms/send-sms"}]},{"group":"Snippets","pages":[{"title":"List code snippets","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/snippets","href":"/api-reference/snippets/list-code-snippets"},{"title":"Create a code snippet (its first draft)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/snippets","href":"/api-reference/snippets/create-a-code-snippet-its-first-draft"},{"title":"Get a code snippet and its versions","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/snippets/{snippet_id}","href":"/api-reference/snippets/get-a-code-snippet-and-its-versions"},{"title":"Archive (or restore) a code snippet","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/snippets/{snippet_id}","href":"/api-reference/snippets/archive-or-restore-a-code-snippet"},{"title":"Edit the draft (opens a new draft after the highest version when none is open)","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/snippets/{snippet_id}","href":"/api-reference/snippets/edit-the-draft-opens-a-new-draft-after-the-highest-version-when-none-is-open"},{"title":"Publish the draft as an immutable version","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/snippets/{snippet_id}/publish","href":"/api-reference/snippets/publish-the-draft-as-an-immutable-version"},{"title":"Run a version (or the draft) on sample input in the sandbox","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/snippets/{snippet_id}/test","href":"/api-reference/snippets/run-a-version-or-the-draft-on-sample-input-in-the-sandbox"},{"title":"Get one version of a code snippet","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/snippets/{snippet_id}/versions/{version}","href":"/api-reference/snippets/get-one-version-of-a-code-snippet"}]},{"group":"Assistant","pages":[{"title":"Send a mobile linking code","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/text-assistant/link","href":"/api-reference/assistant/send-a-mobile-linking-code"},{"title":"Unlink your mobile number","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/text-assistant/link","href":"/api-reference/assistant/unlink-your-mobile-number"},{"title":"Confirm your mobile linking code","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/text-assistant/link/confirm","href":"/api-reference/assistant/confirm-your-mobile-linking-code"},{"title":"Read text Assistant settings","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/text-assistant/settings","href":"/api-reference/assistant/read-text-assistant-settings"},{"title":"Enable or disable the text Assistant","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/text-assistant/settings","href":"/api-reference/assistant/enable-or-disable-the-text-assistant"},{"title":"Read your text Assistant thread","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/text-assistant/thread","href":"/api-reference/assistant/read-your-text-assistant-thread"}]},{"group":"Tools","pages":[{"title":"List tools","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/tools","href":"/api-reference/tools/list-tools"},{"title":"Create a tool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/tools","href":"/api-reference/tools/create-a-tool"},{"title":"Get a tool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/tools/{tool_id}","href":"/api-reference/tools/get-a-tool"},{"title":"Disable (archive) a tool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/tools/{tool_id}","href":"/api-reference/tools/disable-archive-a-tool"},{"title":"Update a tool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/tools/{tool_id}","href":"/api-reference/tools/update-a-tool"},{"title":"Execute a tool in test mode","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/tools/{tool_id}/execute","href":"/api-reference/tools/execute-a-tool-in-test-mode"},{"title":"Recent executions of a tool","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/tools/{tool_id}/executions","href":"/api-reference/tools/recent-executions-of-a-tool"}]},{"group":"Voices","pages":[{"title":"List workspace voice collection","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/voices/library","href":"/api-reference/voices/list-workspace-voice-collection"},{"title":"Add a cleared voice to the workspace library","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/voices/library/add","href":"/api-reference/voices/add-a-cleared-voice-to-the-workspace-library"},{"title":"Read a voice shared with this workspace","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/voices/library/{entry_id}","href":"/api-reference/voices/read-a-voice-shared-with-this-workspace"},{"title":"Set the workspace rating for a saved voice","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/voices/library/{entry_id}/rate","href":"/api-reference/voices/set-the-workspace-rating-for-a-saved-voice"},{"title":"Play a saved voice with the workspace sample text","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/voices/library/{entry_id}/sample","href":"/api-reference/voices/play-a-saved-voice-with-the-workspace-sample-text"},{"title":"Enable or revoke authenticated team sharing","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/voices/library/{entry_id}/share","href":"/api-reference/voices/enable-or-revoke-authenticated-team-sharing"},{"title":"List professional clone preparations","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/voices/studio","href":"/api-reference/voices/list-professional-clone-preparations"},{"title":"Prepare a professional clone without uploading or training","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/voices/studio","href":"/api-reference/voices/prepare-a-professional-clone-without-uploading-or-training"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/get-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Delivery attempts","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/webhooks/{webhook_id}/deliveries","href":"/api-reference/webhooks/delivery-attempts"},{"title":"Resend a recorded webhook delivery","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/webhooks/{webhook_id}/deliveries/{delivery_id}/resend","href":"/api-reference/webhooks/resend-a-recorded-webhook-delivery"},{"title":"Send a signed test event","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/webhooks/{webhook_id}/test","href":"/api-reference/webhooks/send-a-signed-test-event"}]},{"group":"Widgets","pages":[{"title":"Widget custom components on this workspace's agents","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v1/widget/custom-components","href":"/api-reference/widgets/widget-custom-components-on-this-workspaces-agents"},{"title":"Attach a custom component to a node of a widget's agent","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v1/widget/custom-components","href":"/api-reference/widgets/attach-a-custom-component-to-a-node-of-a-widgets-agent"},{"title":"Remove a widget custom component","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json delete /v1/widget/custom-components/{id}","href":"/api-reference/widgets/remove-a-widget-custom-component"},{"title":"Update a widget custom component","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v1/widget/custom-components/{id}","href":"/api-reference/widgets/update-a-widget-custom-component"}]},{"group":"Experiments","pages":[{"title":"List experiments","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/experiments","href":"/api-reference/experiments/list-experiments"},{"title":"Create and start experiment","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/experiments","href":"/api-reference/experiments/create-and-start-experiment"},{"title":"Get experiment","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/experiments/{experiment_id}","href":"/api-reference/experiments/get-experiment"},{"title":"Update experiment","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json patch /v2/agents/{uuid}/experiments/{experiment_id}","href":"/api-reference/experiments/update-experiment"},{"title":"Get observed experiment results","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/agents/{uuid}/experiments/{experiment_id}/results","href":"/api-reference/experiments/get-observed-experiment-results"},{"title":"Stop experiment","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/agents/{uuid}/experiments/{experiment_id}/stop","href":"/api-reference/experiments/stop-experiment"}]},{"group":"Batches","pages":[{"title":"Create and start a call batch","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/batches/create","href":"/api-reference/batches/create-and-start-a-call-batch"},{"title":"Get batch","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/batches/{batch_id}","href":"/api-reference/batches/get-batch"},{"title":"Get batch attempts","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json get /v2/batches/{batch_id}/logs","href":"/api-reference/batches/get-batch-attempts"},{"title":"Advance due batch recipients","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/batches/{batch_id}/run","href":"/api-reference/batches/advance-due-batch-recipients"},{"title":"Stop queued batch recipients","deprecated":null,"version":null,"openapi":"https://api.sempera.org/openapi.json post /v2/batches/{batch_id}/stop","href":"/api-reference/batches/stop-queued-batch-recipients"}]}]},{"tab":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Read the draft - Sempera Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}