Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.
Headers
X-Request-ID
string | null
Path Parameters
agent_id
string<uuid>
required
Body
application/json
name
string | null
description
string | null
system_prompt
string | null
purpose
string | null
Maximum string length: 4000
purpose_mode
enum<string> | null
Available options:
monitor,
enforce
source
enum<string> | null
Available options:
auto,
manual
provider_id
string<uuid> | null
owner_id
string<uuid> | null
deployment_id
string<uuid> | null
debug_payloads_until
string<date-time> | null
Response
Successful Response
id
string<uuid>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
org_id
string<uuid>
required
owner_id
string<uuid> | null
required
name
string | null
required
description
string | null
required
system_prompt
string | null
required
status
enum<string>
required
Available options:
draft,
active
source
enum<string>
required
Available options:
auto,
manual
provider_id
string<uuid> | null
required
provider
AgentProviderSummary · object | null
required
Show child attributes
agent_url
string
required
read-only
Endpoint base URL for this agent. Cloud agents render https://runtime.xenovia.io/{agent_id}/v1; hybrid agents render their deployment's ingress URL plus /{agent_id}/v1.
purpose
string | null
purpose_mode
enum<string>
default:monitor
Available options:
monitor,
enforce
coding_tool
string | null
platform
string | null
connected
boolean
default:false
deployment_id
string<uuid> | null
debug_payloads_until
string<date-time> | null
fallbacks
AgentFallbackRead · object[]
Show child attributes
routing
AgentRouting · object
An agent's failover settings, always whole (every default filled).
Show child attributes
primary_capabilities
ModelCapabilities · object | null
What a model can take, from the public model directory (models.dev);
each member is null when the directory does not say (assume capable).
Show child attributes
primary_residency
enum<string>
default:unknown
Available options:
us,
eu,
apac,
global,
unknown
hosted_tools
HostedTools · object | null
An agent's hosted tool allow-list: GET/PUT /agents/{agent_id}/hosted-tools,
AgentRead.hosted_tools and the config snapshot's hosted_tools.
mode is what the runtime does with a hosted tool outside the list:
enforce refuses the request, monitor records it and lets it
through. mcp_servers may be set without mcp in families: it
is kept and served, and the runtime allows no MCP tool while mcp is
not in the families (so an admin can switch MCP off without losing the
server list).
Show child attributes
hosted_tool_families
string[]
coding_tool_hosted_tool_families
string[]
sub_agents_summary
SubAgentsSummary · object
AgentRead.sub_agents_summary: how many sub-agents of each kind.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Xenovia","colors":{"primary":"#087D73","light":"#37AEA0","dark":"#087D73"},"logo":{"light":"https://mintcdn.com/xenovia/fXYbfbUZbT5Ajr9c/logo/xenovia-logo.svg?fit=max\u0026auto=format\u0026n=fXYbfbUZbT5Ajr9c\u0026q=85\u0026s=35e1d4d64610ecc78b840c284519c509","dark":"https://mintcdn.com/xenovia/fXYbfbUZbT5Ajr9c/logo/xenovia-logo.svg?fit=max\u0026auto=format\u0026n=fXYbfbUZbT5Ajr9c\u0026q=85\u0026s=35e1d4d64610ecc78b840c284519c509","href":"https://xenovia.io"},"favicon":"https://mintcdn.com/xenovia/RO5UF1Tk8L9B7yPt/logo/app-icon.svg?fit=max\u0026auto=format\u0026n=RO5UF1Tk8L9B7yPt\u0026q=85\u0026s=1c57a0b3bb29fc0be05f8d78f7657e78","background":{"color":{"light":"#FCFCFE","dark":"#050C16"}},"navbar":{"links":[{"href":"mailto:richard.loomis@xenovia.io","label":"Contact"}],"primary":{"type":"button","label":"Open Platform","href":"https://app.xenovia.io/"}},"footer":{"socials":{"x":"https://x.com/xenovia_io","linkedin":"https://www.linkedin.com/company/xenovia"}},"fonts":{"family":"Plus Jakarta Sans"},"integrations":{"posthog":{"apiKey":"phc_q4nUtwYn8CNyQYTfZChzYhYWhAVBWA7sYP5sTCcUbfMQ","sessionRecording":false}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xenovia","hasAudioNarration":false,"actualSubdomain":"xenovia","customDomains":["docs.xenovia.io"],"gitSource":{"type":"github","owner":"xenovia-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6afad66668b1903921ee8081"},"entitlements":{},"buildId":"6afadc6600a0506726303049","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API","count":121},{"language":"default","tag":"Docs","count":27},{"language":"default","tag":"Agents","count":21},{"language":"default","tag":"Providers","count":17},{"language":"default","tag":"Policies","count":16},{"language":"default","tag":"Organization","count":15},{"language":"default","tag":"Alerts","count":12},{"language":"default","tag":"Sessions and traces","count":12},{"language":"default","tag":"API keys","count":9},{"language":"default","tag":"Neon","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"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":"editor-metadata","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},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".dark img[src^=\"/icons/\"]{filter:invert(1) hue-rotate(180deg)}.xn-logos{display:grid;grid-template-columns:repeat(auto-fill, minmax(10rem, 1fr));gap:0.75rem}.xn-logo-card{display:flex;align-items:center;gap:0.75rem;padding:0.75rem 1rem;border:1px solid rgb(3 8 10 / 0.08);border-radius:0.75rem;font-size:0.875rem;font-weight:500;color:inherit;text-decoration:none}.xn-logo-card:hover{border-color:#087D73}.dark .xn-logo-card{border-color:rgb(252 252 254 / 0.09)}.dark .xn-logo-card:hover{border-color:#37AEA0}.xn-logo{width:1.5rem;height:1.5rem;object-fit:contain;flex:none;margin:0!important}.xn-dark{display:none}.dark .xn-dark{display:block}.dark .xn-light{display:none}"}],"page":{"pagePath":"api-reference/agents/update-agent","slug":"/api-reference/agents/update-agent","pageMetadata":{"title":"Update agent","description":"**Auth:** organization API key with `write` scope, or a signed-in user.\n\n`owner_id` and `deployment_id` can only be changed by a signed-in organization admin.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}","href":"/api-reference/agents/update-agent","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Auth:\"\n }), \" organization API key with \", _jsx(_components.code, {\n children: \"write\"\n }), \" scope, or a signed-in user.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"owner_id\"\n }), \" and \", _jsx(_components.code, {\n children: \"deployment_id\"\n }), \" can only be changed by a signed-in organization admin.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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":"Update agent","description":"**Auth:** organization API key with `write` scope, or a signed-in user.\n\n`owner_id` and `deployment_id` can only be changed by a signed-in organization admin.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}","href":"/api-reference/agents/update-agent","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["agents"],"summary":"Update agent","operationId":"patch_agent_api_v1_agents__agent_id__patch","parameters":["a1f2ba1d-6e0a-45ce-9f39-b134548bed8e","dcb9cb89-5854-472b-9027-64e1036d4098"],"requestBody":"e8da7b45-6fb9-48a3-adbe-797266239044","responses":{"200":"8b0fb8d6-4c32-4aa2-b0c3-01b64427f458","422":"dc71df03-0457-4f73-8c82-46f536807dbe"},"description":"**Auth:** organization API key with `write` scope, or a signed-in user.\n\n`owner_id` and `deployment_id` can only be changed by a signed-in organization admin.","method":"patch","type":"path","servers":["e7c82bd9-57a1-44c9-a36f-fd46ab7f418e"],"security":["c3faa7b4-ffd0-4ea7-bc9e-f88dd598b349"],"path":"/api/v1/agents/{agent_id}","baseUrlOptions":["https://cp.xenovia.io"],"title":"Update agent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a1f2ba1d-6e0a-45ce-9f39-b134548bed8e":{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"dcb9cb89-5854-472b-9027-64e1036d4098":{"name":"X-Request-ID","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Request-Id","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Request-Id","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"system_prompt":{"oneOf":[{"type":"string","title":"System Prompt","uniqueKey":"system_prompt.oneOf.0","typeLabel":"string"},{"type":"null","title":"System Prompt","uniqueKey":"system_prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"system_prompt","typeLabel":"string | null"},"purpose":{"oneOf":[{"type":"string","title":"Purpose","maxLength":4000,"uniqueKey":"purpose.oneOf.0","typeLabel":"string"},{"type":"null","title":"Purpose","uniqueKey":"purpose.oneOf.1","typeLabel":"null"}],"uniqueKey":"purpose","typeLabel":"string | null"},"purpose_mode":{"oneOf":[{"type":"string","title":"Purpose Mode","enum":["monitor","enforce"],"uniqueKey":"purpose_mode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Purpose Mode","uniqueKey":"purpose_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"purpose_mode","typeLabel":"enum\u003cstring> | null"},"source":{"oneOf":[{"type":"string","title":"AgentSource","enum":["auto","manual"],"uniqueKey":"source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"source.oneOf.1","typeLabel":"null"}],"uniqueKey":"source","typeLabel":"enum\u003cstring> | null"},"provider_id":{"oneOf":[{"type":"string","title":"Provider Id","format":"uuid","uniqueKey":"provider_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Provider Id","uniqueKey":"provider_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_id","typeLabel":"string\u003cuuid> | null"},"owner_id":{"oneOf":[{"type":"string","title":"Owner Id","format":"uuid","uniqueKey":"owner_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Owner Id","uniqueKey":"owner_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_id","typeLabel":"string\u003cuuid> | null"},"deployment_id":{"oneOf":[{"type":"string","title":"Deployment Id","format":"uuid","uniqueKey":"deployment_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Deployment Id","uniqueKey":"deployment_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"deployment_id","typeLabel":"string\u003cuuid> | null"},"debug_payloads_until":{"oneOf":[{"type":"string","title":"Debug Payloads Until","format":"date-time","uniqueKey":"debug_payloads_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Debug Payloads Until","uniqueKey":"debug_payloads_until.oneOf.1","typeLabel":"null"}],"uniqueKey":"debug_payloads_until","typeLabel":"string\u003cdate-time> | null"}},"type":"object","title":"AgentUpdate","uniqueKey":"","typeLabel":"AgentUpdate · object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","description":"\u003cstring>","system_prompt":"\u003cstring>","purpose":"\u003cstring>","provider_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","owner_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","deployment_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","debug_payloads_until":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"8b0fb8d6-4c32-4aa2-b0c3-01b64427f458":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"created_at":{"type":"string","format":"date-time","title":"Created At","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"org_id":{"type":"string","format":"uuid","title":"Org Id","isRequired":true,"uniqueKey":"org_id","typeLabel":"string\u003cuuid>"},"owner_id":{"oneOf":[{"type":"string","title":"Owner Id","format":"uuid","isRequired":true,"uniqueKey":"owner_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Owner Id","isRequired":true,"uniqueKey":"owner_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_id","typeLabel":"string\u003cuuid> | null"},"name":{"oneOf":[{"type":"string","title":"Name","isRequired":true,"uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","isRequired":true,"uniqueKey":"name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","isRequired":true,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","isRequired":true,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"description","typeLabel":"string | null"},"system_prompt":{"oneOf":[{"type":"string","title":"System Prompt","isRequired":true,"uniqueKey":"system_prompt.oneOf.0","typeLabel":"string"},{"type":"null","title":"System Prompt","isRequired":true,"uniqueKey":"system_prompt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"system_prompt","typeLabel":"string | null"},"status":{"type":"string","enum":["draft","active"],"title":"AgentStatus","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["auto","manual"],"title":"AgentSource","isRequired":true,"uniqueKey":"source","typeLabel":"enum\u003cstring>"},"provider_id":{"oneOf":[{"type":"string","title":"Provider Id","format":"uuid","isRequired":true,"uniqueKey":"provider_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Provider Id","isRequired":true,"uniqueKey":"provider_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"provider_id","typeLabel":"string\u003cuuid> | null"},"provider":{"oneOf":[{"type":"object","title":"AgentProviderSummary","required":["id","name","provider","model"],"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"provider.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"provider.oneOf.0.name","typeLabel":"string"},"provider":{"type":"string","title":"Provider","isRequired":true,"uniqueKey":"provider.oneOf.0.provider","typeLabel":"string"},"model":{"oneOf":[{"type":"string","title":"Model","isRequired":true,"uniqueKey":"provider.oneOf.0.model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","isRequired":true,"uniqueKey":"provider.oneOf.0.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"provider.oneOf.0.model","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"provider.oneOf.0","typeLabel":"AgentProviderSummary · object"},{"type":"null","isRequired":true,"uniqueKey":"provider.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"provider","typeLabel":"AgentProviderSummary · object | null"},"agent_url":{"type":"string","title":"Agent Url","description":"Endpoint base URL for this agent. Cloud agents render `https://runtime.xenovia.io/{agent_id}/v1`; hybrid agents render their deployment's ingress URL plus `/{agent_id}/v1`.","readOnly":true,"isRequired":true,"uniqueKey":"agent_url","typeLabel":"string"},"purpose":{"oneOf":[{"type":"string","title":"Purpose","uniqueKey":"purpose.oneOf.0","typeLabel":"string"},{"type":"null","title":"Purpose","uniqueKey":"purpose.oneOf.1","typeLabel":"null"}],"uniqueKey":"purpose","typeLabel":"string | null"},"purpose_mode":{"type":"string","enum":["monitor","enforce"],"title":"Purpose Mode","default":"monitor","uniqueKey":"purpose_mode","typeLabel":"enum\u003cstring>"},"coding_tool":{"oneOf":[{"type":"string","title":"Coding Tool","uniqueKey":"coding_tool.oneOf.0","typeLabel":"string"},{"type":"null","title":"Coding Tool","uniqueKey":"coding_tool.oneOf.1","typeLabel":"null"}],"uniqueKey":"coding_tool","typeLabel":"string | null"},"platform":{"oneOf":[{"type":"string","title":"Platform","uniqueKey":"platform.oneOf.0","typeLabel":"string"},{"type":"null","title":"Platform","uniqueKey":"platform.oneOf.1","typeLabel":"null"}],"uniqueKey":"platform","typeLabel":"string | null"},"connected":{"type":"boolean","title":"Connected","default":false,"uniqueKey":"connected","typeLabel":"boolean"},"deployment_id":{"oneOf":[{"type":"string","title":"Deployment Id","format":"uuid","uniqueKey":"deployment_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Deployment Id","uniqueKey":"deployment_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"deployment_id","typeLabel":"string\u003cuuid> | null"},"debug_payloads_until":{"oneOf":[{"type":"string","title":"Debug Payloads Until","format":"date-time","uniqueKey":"debug_payloads_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Debug Payloads Until","uniqueKey":"debug_payloads_until.oneOf.1","typeLabel":"null"}],"uniqueKey":"debug_payloads_until","typeLabel":"string\u003cdate-time> | null"},"fallbacks":{"items":{"properties":{"position":{"type":"integer","title":"Position","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].position","typeLabel":"integer"},"provider_id":{"type":"string","format":"uuid","title":"Provider Id","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider_id","typeLabel":"string\u003cuuid>"},"provider":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider.name","typeLabel":"string"},"provider":{"type":"string","title":"Provider","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider.provider","typeLabel":"string"},"model":{"oneOf":[{"type":"string","title":"Model","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider.model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider.model","typeLabel":"string | null"}},"type":"object","required":["id","name","provider","model"],"title":"AgentProviderSummary","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].provider","typeLabel":"AgentProviderSummary · object"},"model":{"oneOf":[{"type":"string","title":"Model","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fallbacks.items.[INDEX].model","typeLabel":"string | null"},"model_override":{"oneOf":[{"type":"string","title":"Model Override","uniqueKey":"fallbacks.items.[INDEX].model_override.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model Override","uniqueKey":"fallbacks.items.[INDEX].model_override.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].model_override","typeLabel":"string | null"},"residency":{"type":"string","enum":["us","eu","apac","global","unknown"],"title":"Residency","default":"unknown","uniqueKey":"fallbacks.items.[INDEX].residency","typeLabel":"enum\u003cstring>"},"capabilities":{"oneOf":[{"type":"object","title":"ModelCapabilities","description":"What a model can take, from the public model directory (models.dev);\neach member is null when the directory does not say (assume capable).","properties":{"context_window":{"oneOf":[{"type":"integer","title":"Context Window","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.context_window.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Context Window","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.context_window.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.context_window","typeLabel":"integer | null"},"max_output":{"oneOf":[{"type":"integer","title":"Max Output","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.max_output.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Output","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.max_output.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.max_output","typeLabel":"integer | null"},"vision":{"oneOf":[{"type":"boolean","title":"Vision","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.vision.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Vision","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.vision.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.vision","typeLabel":"boolean | null"},"tools":{"oneOf":[{"type":"boolean","title":"Tools","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.tools.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Tools","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.tools.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.tools","typeLabel":"boolean | null"},"reasoning":{"oneOf":[{"type":"boolean","title":"Reasoning","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.reasoning.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Reasoning","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.reasoning.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0.reasoning","typeLabel":"boolean | null"}},"uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.0","typeLabel":"ModelCapabilities · object"},{"type":"null","uniqueKey":"fallbacks.items.[INDEX].capabilities.oneOf.1","typeLabel":"null"}],"uniqueKey":"fallbacks.items.[INDEX].capabilities","typeLabel":"ModelCapabilities · object | null"}},"type":"object","required":["position","provider_id","provider","model"],"title":"AgentFallbackRead","uniqueKey":"fallbacks.items.[INDEX]","typeLabel":"AgentFallbackRead · object"},"type":"array","title":"Fallbacks","uniqueKey":"fallbacks","typeLabel":"AgentFallbackRead · object[]"},"routing":{"properties":{"fail_over_on":{"items":{"type":"string","enum":["unreachable","timeout","rate_limited","server_error","overloaded","setup_fault"],"uniqueKey":"routing.fail_over_on.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Fail Over On","uniqueKey":"routing.fail_over_on","typeLabel":"enum\u003cstring>[]"},"attempt_timeout_s":{"type":"integer","maximum":600,"minimum":10,"title":"Attempt Timeout S","default":120,"uniqueKey":"routing.attempt_timeout_s","typeLabel":"integer"},"total_budget_s":{"type":"integer","maximum":900,"minimum":10,"title":"Total Budget S","default":300,"uniqueKey":"routing.total_budget_s","typeLabel":"integer"},"first_token_timeout_s":{"oneOf":[{"type":"integer","title":"First Token Timeout S","maximum":120,"minimum":1,"uniqueKey":"routing.first_token_timeout_s.oneOf.0","typeLabel":"integer"},{"type":"null","title":"First Token Timeout S","uniqueKey":"routing.first_token_timeout_s.oneOf.1","typeLabel":"null"}],"uniqueKey":"routing.first_token_timeout_s","typeLabel":"integer | null"},"breaker_enabled":{"type":"boolean","title":"Breaker Enabled","default":true,"uniqueKey":"routing.breaker_enabled","typeLabel":"boolean"},"same_residency":{"type":"boolean","title":"Same Residency","default":false,"uniqueKey":"routing.same_residency","typeLabel":"boolean"}},"additionalProperties":false,"type":"object","title":"AgentRouting","description":"An agent's failover settings, always whole (every default filled).","uniqueKey":"routing","typeLabel":"AgentRouting · object"},"primary_capabilities":{"oneOf":[{"type":"object","title":"ModelCapabilities","description":"What a model can take, from the public model directory (models.dev);\neach member is null when the directory does not say (assume capable).","properties":{"context_window":{"oneOf":[{"type":"integer","title":"Context Window","uniqueKey":"primary_capabilities.oneOf.0.context_window.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Context Window","uniqueKey":"primary_capabilities.oneOf.0.context_window.oneOf.1","typeLabel":"null"}],"uniqueKey":"primary_capabilities.oneOf.0.context_window","typeLabel":"integer | null"},"max_output":{"oneOf":[{"type":"integer","title":"Max Output","uniqueKey":"primary_capabilities.oneOf.0.max_output.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Output","uniqueKey":"primary_capabilities.oneOf.0.max_output.oneOf.1","typeLabel":"null"}],"uniqueKey":"primary_capabilities.oneOf.0.max_output","typeLabel":"integer | null"},"vision":{"oneOf":[{"type":"boolean","title":"Vision","uniqueKey":"primary_capabilities.oneOf.0.vision.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Vision","uniqueKey":"primary_capabilities.oneOf.0.vision.oneOf.1","typeLabel":"null"}],"uniqueKey":"primary_capabilities.oneOf.0.vision","typeLabel":"boolean | null"},"tools":{"oneOf":[{"type":"boolean","title":"Tools","uniqueKey":"primary_capabilities.oneOf.0.tools.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Tools","uniqueKey":"primary_capabilities.oneOf.0.tools.oneOf.1","typeLabel":"null"}],"uniqueKey":"primary_capabilities.oneOf.0.tools","typeLabel":"boolean | null"},"reasoning":{"oneOf":[{"type":"boolean","title":"Reasoning","uniqueKey":"primary_capabilities.oneOf.0.reasoning.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Reasoning","uniqueKey":"primary_capabilities.oneOf.0.reasoning.oneOf.1","typeLabel":"null"}],"uniqueKey":"primary_capabilities.oneOf.0.reasoning","typeLabel":"boolean | null"}},"uniqueKey":"primary_capabilities.oneOf.0","typeLabel":"ModelCapabilities · object"},{"type":"null","uniqueKey":"primary_capabilities.oneOf.1","typeLabel":"null"}],"uniqueKey":"primary_capabilities","typeLabel":"ModelCapabilities · object | null"},"primary_residency":{"type":"string","enum":["us","eu","apac","global","unknown"],"title":"Primary Residency","default":"unknown","uniqueKey":"primary_residency","typeLabel":"enum\u003cstring>"},"hosted_tools":{"oneOf":[{"type":"object","title":"HostedTools","description":"An agent's hosted tool allow-list: GET/PUT /agents/{agent_id}/hosted-tools,\nAgentRead.hosted_tools and the config snapshot's ``hosted_tools``.\n\n``mode`` is what the runtime does with a hosted tool outside the list:\n``enforce`` refuses the request, ``monitor`` records it and lets it\nthrough. ``mcp_servers`` may be set without ``mcp`` in ``families``: it\nis kept and served, and the runtime allows no MCP tool while ``mcp`` is\nnot in the families (so an admin can switch MCP off without losing the\nserver list).","required":["mode"],"properties":{"mode":{"type":"string","enum":["monitor","enforce"],"title":"Mode","isRequired":true,"uniqueKey":"hosted_tools.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"families":{"items":{"type":"string","enum":["web_search","web_fetch","code_execution","computer","shell","file_search","image_generation","mcp","advisor","other"],"uniqueKey":"hosted_tools.oneOf.0.families.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Families","uniqueKey":"hosted_tools.oneOf.0.families","typeLabel":"enum\u003cstring>[]"},"mcp_servers":{"items":{"properties":{"label":{"type":"string","maxLength":64,"minLength":1,"title":"Label","isRequired":true,"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].label","typeLabel":"string"},"url":{"oneOf":[{"type":"string","title":"Url","uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].url","typeLabel":"string | null"},"connector_id":{"oneOf":[{"type":"string","title":"Connector Id","maxLength":256,"minLength":1,"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].connector_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Connector Id","uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].connector_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].connector_id","typeLabel":"string | null"},"tunnel_id":{"oneOf":[{"type":"string","title":"Tunnel Id","maxLength":256,"minLength":1,"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].tunnel_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Tunnel Id","uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].tunnel_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].tunnel_id","typeLabel":"string | null"},"tools":{"items":{"type":"string","maxLength":128,"minLength":1,"uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].tools.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":100,"title":"Tools","uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX].tools","typeLabel":"string[]"}},"additionalProperties":false,"type":"object","required":["label"],"title":"HostedMcpServer","description":"One remote MCP server the agent's model requests may use, named by\nexactly one of: its URL, a provider connector id, or a tunnel id. A\ncoding tool's agent names its servers by label alone (the server's name\nin the tool's MCP configuration), so the target is checked per agent\n(hosted_tools_service.check_hosted_tools).","uniqueKey":"hosted_tools.oneOf.0.mcp_servers.items.[INDEX]","typeLabel":"HostedMcpServer · object"},"type":"array","maxItems":50,"title":"Mcp Servers","uniqueKey":"hosted_tools.oneOf.0.mcp_servers","typeLabel":"HostedMcpServer · object[]"}},"additionalProperties":false,"uniqueKey":"hosted_tools.oneOf.0","typeLabel":"HostedTools · object"},{"type":"null","uniqueKey":"hosted_tools.oneOf.1","typeLabel":"null"}],"uniqueKey":"hosted_tools","typeLabel":"HostedTools · object | null"},"hosted_tool_families":{"items":{"type":"string","uniqueKey":"hosted_tool_families.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Hosted Tool Families","uniqueKey":"hosted_tool_families","typeLabel":"string[]"},"coding_tool_hosted_tool_families":{"items":{"type":"string","uniqueKey":"coding_tool_hosted_tool_families.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Coding Tool Hosted Tool Families","uniqueKey":"coding_tool_hosted_tool_families","typeLabel":"string[]"},"sub_agents_summary":{"properties":{"inline":{"type":"integer","title":"Inline","default":0,"uniqueKey":"sub_agents_summary.inline","typeLabel":"integer"},"linked":{"type":"integer","title":"Linked","default":0,"uniqueKey":"sub_agents_summary.linked","typeLabel":"integer"}},"type":"object","title":"SubAgentsSummary","description":"AgentRead.sub_agents_summary: how many sub-agents of each kind.","uniqueKey":"sub_agents_summary","typeLabel":"SubAgentsSummary · object"}},"type":"object","required":["id","created_at","updated_at","org_id","owner_id","name","description","system_prompt","status","source","provider_id","provider","agent_url"],"title":"AgentRead","uniqueKey":"","typeLabel":"AgentRead · object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","org_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","owner_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","description":"\u003cstring>","system_prompt":"\u003cstring>","status":"draft","source":"auto","provider_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","provider":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","provider":"\u003cstring>","model":"\u003cstring>"},"agent_url":"\u003cstring>","purpose":"\u003cstring>","purpose_mode":"monitor","coding_tool":"\u003cstring>","platform":"\u003cstring>","connected":false,"deployment_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","debug_payloads_until":"2023-11-07T05:31:56Z","fallbacks":[{"position":123,"provider_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","provider":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","provider":"\u003cstring>","model":"\u003cstring>"},"model":"\u003cstring>","model_override":"\u003cstring>","residency":"unknown","capabilities":{"context_window":123,"max_output":123,"vision":true,"tools":true,"reasoning":true}}],"routing":{"fail_over_on":["unreachable"],"attempt_timeout_s":120,"total_budget_s":300,"first_token_timeout_s":60,"breaker_enabled":true,"same_residency":false},"primary_capabilities":{"context_window":123,"max_output":123,"vision":true,"tools":true,"reasoning":true},"primary_residency":"unknown","hosted_tools":{"mode":"monitor","families":["web_search"],"mcp_servers":[{"label":"\u003cstring>","url":"\u003cstring>","connector_id":"\u003cstring>","tunnel_id":"\u003cstring>","tools":["\u003cstring>"]}]},"hosted_tool_families":["\u003cstring>"],"coding_tool_hosted_tool_families":["\u003cstring>"],"sub_agents_summary":{"inline":0,"linked":0}}}},"exampleType":"generated"}},"exampleType":"generated"},"dc71df03-0457-4f73-8c82-46f536807dbe":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c3faa7b4-ffd0-4ea7-bc9e-f88dd598b349":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Bearer token: an organization API key (`ak_…`) created under Settings → API Keys, or a dashboard user session token. Agent keys (`xe_…`) are not accepted here. Endpoints marked as user-only in their description reject organization keys with `403`.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"e7c82bd9-57a1-44c9-a36f-fd46ab7f418e":{"url":"https://cp.xenovia.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token: an organization API key (`ak_…`) created under Settings → API Keys, or a dashboard user session token. Agent keys (`xe_…`) are not accepted here. Endpoints marked as user-only in their description reject organization keys with `403`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token: an organization API key (`ak_…`) created under Settings → API Keys, or a dashboard user session token. Agent keys (`xe_…`) are not accepted here. Endpoints marked as user-only in their description reject organization keys with `403`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://cp.xenovia.io/openapi.json"},"subdomain":"xenovia","siteName":"Xenovia","title":"Update agent - Xenovia","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T10:14:35.601Z","originalFileLocation":"api-reference/agents/update-agent.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=\"description\" content=\"Auth: organization API key with write scope, or a signed-in user. owner_id and deployment_id can only be changed by a signed-in organization admin.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Xenovia\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update agent - Xenovia\">\u003cmeta data-mint-head property=\"og:description\" content=\"Auth: organization API key with write scope, or a signed-in user. owner_id and deployment_id can only be changed by a signed-in organization admin.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Xenovia\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.xenovia.io/api-reference/agents/update-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xenovia.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Update+agent\u0026amp;description=**Auth%3A**+organization+API+key+with+%60write%60+scope%2C+or+a+signed-in+user.%0A%0A%60owner_id%60+and+%60deployment_id%60+can+only+be+changed+by+a+signed-in+organization+admin.\u0026amp;theme=55bac7760962f1669e7a9bdc\u0026amp;signature=ea2d16d56481472b518ca1ee3ede0f23c4d908fbb0837a93f680a658d5082362\">\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=\"Update agent - Xenovia\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Auth: organization API key with write scope, or a signed-in user. owner_id and deployment_id can only be changed by a signed-in organization admin.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xenovia.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Update+agent\u0026amp;description=**Auth%3A**+organization+API+key+with+%60write%60+scope%2C+or+a+signed-in+user.%0A%0A%60owner_id%60+and+%60deployment_id%60+can+only+be+changed+by+a+signed-in+organization+admin.\u0026amp;theme=55bac7760962f1669e7a9bdc\u0026amp;signature=ea2d16d56481472b518ca1ee3ede0f23c4d908fbb0837a93f680a658d5082362\">\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/xenovia/qfN_5rBm5NpbpNma/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Xenovia\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#087D73\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.xenovia.io/api-reference/agents/update-agent\">\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/update-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.xenovia.io/#organization\",\"name\":\"Xenovia\",\"url\":\"https://docs.xenovia.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xenovia/fXYbfbUZbT5Ajr9c/logo/xenovia-logo.svg?fit=max\u0026auto=format\u0026n=fXYbfbUZbT5Ajr9c\u0026q=85\u0026s=35e1d4d64610ecc78b840c284519c509\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.xenovia.io#website\",\"name\":\"Xenovia\",\"url\":\"https://docs.xenovia.io\",\"publisher\":{\"@id\":\"https://docs.xenovia.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.xenovia.io/api-reference/agents/update-agent#webpage\",\"url\":\"https://docs.xenovia.io/api-reference/agents/update-agent\",\"name\":\"Update agent\",\"description\":\"Auth: organization API key with write scope, or a signed-in user. owner_id and deployment_id can only be changed by a signed-in organization admin.\",\"dateModified\":\"2026-11-16T10:14:35.601Z\",\"isPartOf\":{\"@id\":\"https://docs.xenovia.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.xenovia.io/api-reference/agents/update-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.xenovia.io/api-reference/agents/update-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.xenovia.io/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update agent\",\"item\":\"https://docs.xenovia.io/api-reference/agents/update-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.xenovia.io/api-reference/agents/update-agent#apireference\",\"headline\":\"Update agent\",\"name\":\"Update agent\",\"description\":\"Auth: organization API key with write scope, or a signed-in user. owner_id and deployment_id can only be changed by a signed-in organization admin.\",\"url\":\"https://docs.xenovia.io/api-reference/agents/update-agent\",\"mainEntityOfPage\":{\"@id\":\"https://docs.xenovia.io/api-reference/agents/update-agent#webpage\"},\"dateModified\":\"2026-11-16T10:14:35.601Z\",\"publisher\":{\"@id\":\"https://docs.xenovia.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.xenovia.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Xenovia\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Xenovia\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agents/update-agent.md","siteName":"Xenovia","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Docs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xenovia/icons/book-open.svg","pages":[{"title":"Docs","href":"/introduction"}]},{"tab":"Xenovia SDK","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xenovia/icons/lightning.svg","pages":[{"title":"Xenovia SDK","href":"/sdk/quickstart"}]},{"tab":"API","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xenovia/icons/brackets-curly.svg","groups":[{"group":"Core API","pages":[{"title":"API Introduction","icon":"code","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Errors and Limits","icon":"triangle-exclamation","href":"/api-reference/errors-and-limits"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents","href":"/api-reference/agents/create-agent"},{"title":"Get agent","description":"**Auth:** organization API key (`read` scope or higher) or a signed-in user.\n\nAn agent that belongs to another organization returns `404`.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}","href":"/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}","href":"/api-reference/agents/update-agent"},{"title":"Delete agent","description":"**Auth:** organization API key with `write` scope, or a signed-in user.\n\nAlso evicts the agent's API keys from the runtime cache; returns `503` if that eviction fails.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}","href":"/api-reference/agents/delete-agent"},{"title":"Activate agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/activate","href":"/api-reference/agents/activate-agent"},{"title":"Deactivate agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/deactivate","href":"/api-reference/agents/deactivate-agent"},{"title":"Get policy input schema","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/schema/policy-input","href":"/api-reference/agents/get-policy-input-schema"},{"title":"Replace an agent's fallback providers","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/agents/{agent_id}/fallbacks","href":"/api-reference/agents/replace-an-agents-fallback-providers"},{"title":"How an agent's model requests were routed","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/routing-stats","href":"/api-reference/agents/how-an-agents-model-requests-were-routed"},{"title":"Get agent readiness","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/readiness","href":"/api-reference/agents/get-agent-readiness"},{"title":"List suggested checks","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/check-suggestions","href":"/api-reference/agents/list-suggested-checks"},{"title":"Get hosted tool allow-list","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/hosted-tools","href":"/api-reference/agents/get-hosted-tool-allow-list"},{"title":"Replace hosted tool allow-list","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/agents/{agent_id}/hosted-tools","href":"/api-reference/agents/replace-hosted-tool-allow-list"},{"title":"List config snapshots","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/config-snapshots","href":"/api-reference/agents/list-config-snapshots"},{"title":"Get config snapshot","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/config-snapshots/{config_version}","href":"/api-reference/agents/get-config-snapshot"}]},{"group":"Sub-agents","pages":[{"title":"List sub-agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/sub-agents","href":"/api-reference/agents/list-sub-agents"},{"title":"Add sub-agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/sub-agents","href":"/api-reference/agents/add-sub-agent"},{"title":"Update inline sub-agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}","href":"/api-reference/agents/update-inline-sub-agent"},{"title":"Delete sub-agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}","href":"/api-reference/agents/delete-sub-agent"},{"title":"List parent agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/parents","href":"/api-reference/agents/list-parent-agents"}]},{"group":"Neon","pages":[{"title":"Get Neon settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/neon","href":"/api-reference/agents/get-neon-settings"},{"title":"Update Neon settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/agents/{agent_id}/neon","href":"/api-reference/agents/update-neon-settings"},{"title":"Explain Neon decision","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/neon/decisions/{decision_id}/explain","href":"/api-reference/agents/explain-neon-decision"},{"title":"List capabilities","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/capabilities","href":"/api-reference/agents/list-capabilities"},{"title":"Create capability","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/capabilities","href":"/api-reference/agents/create-capability"},{"title":"Update capability","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}/capabilities/{capability_id}","href":"/api-reference/agents/update-capability"},{"title":"Delete capability","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/capabilities/{capability_id}","href":"/api-reference/agents/delete-capability"}]},{"group":"Guardrails","pages":[{"title":"List guardrails","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/slm-checks","href":"/api-reference/agents/list-guardrails"},{"title":"Create guardrail","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/slm-checks","href":"/api-reference/agents/create-guardrail"},{"title":"Update guardrail","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}/slm-checks/{check_id}","href":"/api-reference/agents/update-guardrail"},{"title":"Delete guardrail","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/slm-checks/{check_id}","href":"/api-reference/agents/delete-guardrail"}]},{"group":"Providers","pages":[{"title":"List providers","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers","href":"/api-reference/providers/list-providers"},{"title":"Provider connection health","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers/health","href":"/api-reference/providers/provider-connection-health"},{"title":"Create provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers","href":"/api-reference/providers/create-provider"},{"title":"Get provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers/{provider_id}","href":"/api-reference/providers/get-provider"},{"title":"Update provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/providers/{provider_id}","href":"/api-reference/providers/update-provider"},{"title":"Delete provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/providers/{provider_id}","href":"/api-reference/providers/delete-provider"},{"title":"List agent providers","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/providers","href":"/api-reference/providers/list-agent-providers"},{"title":"Attach provider to agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/providers/{provider_id}","href":"/api-reference/providers/attach-provider-to-agent"},{"title":"Detach provider from agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/providers/{provider_id}","href":"/api-reference/providers/detach-provider-from-agent"},{"title":"Get provider catalog","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/provider-catalog","href":"/api-reference/providers/get-provider-catalog"},{"title":"List provider models","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers/{provider_id}/models","href":"/api-reference/providers/list-provider-models"},{"title":"List models for an unsaved provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers/models/draft","href":"/api-reference/providers/list-models-for-an-unsaved-provider"},{"title":"List catalog models","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/provider-catalog/{provider_id}/models","href":"/api-reference/providers/list-catalog-models"},{"title":"Test unsaved provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers/test","href":"/api-reference/providers/test-unsaved-provider"},{"title":"Test provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers/{provider_id}/test","href":"/api-reference/providers/test-provider"}]},{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies","href":"/api-reference/policies/list-policies"},{"title":"Create policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policies","href":"/api-reference/policies/create-policy"},{"title":"List policy inventory","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/inventory","href":"/api-reference/policies/list-policy-inventory"},{"title":"Get policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}","href":"/api-reference/policies/get-policy"},{"title":"Update policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/policies/{policy_id}","href":"/api-reference/policies/update-policy"},{"title":"Delete policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/policies/{policy_id}","href":"/api-reference/policies/delete-policy"},{"title":"Disable policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policies/{policy_id}/disable","href":"/api-reference/policies/disable-policy"},{"title":"Enable policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policies/{policy_id}/enable","href":"/api-reference/policies/enable-policy"},{"title":"List agent policies","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/policies","href":"/api-reference/policies/list-agent-policies"},{"title":"Attach policy to agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/policies/{policy_id}","href":"/api-reference/policies/attach-policy-to-agent"},{"title":"Detach policy from agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/policies/{policy_id}","href":"/api-reference/policies/detach-policy-from-agent"},{"title":"Set policy agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/policies/{policy_id}/agents","href":"/api-reference/policies/set-policy-agents"},{"title":"Set policy mode for an agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/policies/{policy_id}/agents/{agent_id}/mode","href":"/api-reference/policies/set-policy-mode-for-an-agent"},{"title":"List policy versions","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}/versions","href":"/api-reference/policies/list-policy-versions"},{"title":"Get policy stats","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}/stats","href":"/api-reference/policies/get-policy-stats"},{"title":"List policy activity","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}/activity","href":"/api-reference/policies/list-policy-activity"}]},{"group":"Policy templates","pages":[{"title":"List policy templates","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policy-templates","href":"/api-reference/policies/list-policy-templates"},{"title":"Get policy template","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policy-templates/{template_id}","href":"/api-reference/policies/get-policy-template"},{"title":"Instantiate policy template","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policy-templates/{template_id}/instantiate","href":"/api-reference/policies/instantiate-policy-template"},{"title":"List recommended templates","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/policy-templates/recommended","href":"/api-reference/policies/list-recommended-templates"}]},{"group":"API keys","pages":[{"title":"List organization API keys","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/keys","href":"/api-reference/api-keys/list-organization-api-keys"},{"title":"Create organization API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/orgs/{org_id}/keys","href":"/api-reference/api-keys/create-organization-api-key"},{"title":"List agent API keys","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/keys","href":"/api-reference/api-keys/list-agent-api-keys"},{"title":"Create agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/keys","href":"/api-reference/api-keys/create-agent-api-key"},{"title":"Revoke organization API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/orgs/{org_id}/keys/{key}","href":"/api-reference/api-keys/revoke-organization-api-key"},{"title":"Revoke agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/keys/{key}","href":"/api-reference/api-keys/revoke-agent-api-key"},{"title":"List sub-agent API keys","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}/keys","href":"/api-reference/agents/list-sub-agent-api-keys"},{"title":"Create sub-agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}/keys","href":"/api-reference/agents/create-sub-agent-api-key"},{"title":"Revoke sub-agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}/keys/{key}","href":"/api-reference/agents/revoke-sub-agent-api-key"}]},{"group":"Sessions and traces","pages":[{"title":"List sessions","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions","href":"/api-reference/sessions/list-sessions"},{"title":"List trace records","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces","href":"/api-reference/sessions/list-trace-records"},{"title":"List workflows","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/workflows","href":"/api-reference/sessions/list-workflows"},{"title":"Get session","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions/{session_id}","href":"/api-reference/sessions/get-session"},{"title":"Get agent activity","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/agent-activity","href":"/api-reference/sessions/get-agent-activity"},{"title":"Get trace stats","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/stats","href":"/api-reference/sessions/get-trace-stats"},{"title":"Get workflow","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/workflows/{workflow_id}","href":"/api-reference/sessions/get-workflow"},{"title":"Get trace flow","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/{trace_id}/flow","href":"/api-reference/sessions/get-trace-flow"},{"title":"Get session turns","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions/{session_id}/turns","href":"/api-reference/sessions/get-session-turns"},{"title":"Get trace overview","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/overview","href":"/api-reference/sessions/get-trace-overview"},{"title":"Get run payload","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/{trace_id}/runs/{run_id}/payload","href":"/api-reference/sessions/get-run-payload"},{"title":"Get run content","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/{trace_id}/runs/{run_id}/content","href":"/api-reference/sessions/get-run-content"}]},{"group":"Alerts","pages":[{"title":"List in-app notifications","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alert-notifications","href":"/api-reference/alerts/list-in-app-notifications"},{"title":"List alert rules","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alert-rules","href":"/api-reference/alerts/list-alert-rules"},{"title":"Create alert rule","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/alert-rules","href":"/api-reference/alerts/create-alert-rule"},{"title":"List alert events","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alerts","href":"/api-reference/alerts/list-alert-events"},{"title":"Get notification settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/notification-settings","href":"/api-reference/alerts/get-notification-settings"},{"title":"Update notification settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/notification-settings","href":"/api-reference/alerts/update-notification-settings"},{"title":"Mark all notifications read","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/alert-notifications/read-all","href":"/api-reference/alerts/mark-all-notifications-read"},{"title":"Update alert rule","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/alert-rules/{rule_id}","href":"/api-reference/alerts/update-alert-rule"},{"title":"Delete alert rule","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/alert-rules/{rule_id}","href":"/api-reference/alerts/delete-alert-rule"},{"title":"Get alert event","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alerts/{event_id}","href":"/api-reference/alerts/get-alert-event"},{"title":"Send test notification","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/notification-settings/test","href":"/api-reference/alerts/send-test-notification"},{"title":"Mark notification read","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/alert-notifications/{notification_id}/read","href":"/api-reference/alerts/mark-notification-read"}]},{"group":"Organization","pages":[{"title":"Get organization","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}","href":"/api-reference/organizations/get-organization"},{"title":"Update onboarding state","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/orgs/{org_id}","href":"/api-reference/organizations/update-onboarding-state"},{"title":"List audit logs","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs","href":"/api-reference/audit-logs/list-audit-logs"},{"title":"Verify audit chain","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs/verify","href":"/api-reference/audit-logs/verify-audit-chain"},{"title":"Export audit chain","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs/export","href":"/api-reference/audit-logs/export-audit-chain"},{"title":"Get audit signing key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs/signing-key","href":"/api-reference/audit-logs/get-audit-signing-key"},{"title":"List members","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/users","href":"/api-reference/users/list-members"},{"title":"Add member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/orgs/{org_id}/users","href":"/api-reference/users/add-member"},{"title":"Get member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/users/{user_id}","href":"/api-reference/users/get-member"},{"title":"Update member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/orgs/{org_id}/users/{user_id}","href":"/api-reference/users/update-member"},{"title":"Remove member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/orgs/{org_id}/users/{user_id}","href":"/api-reference/users/remove-member"}]},{"group":"Deployments (hybrid)","pages":[{"title":"List deployments","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/deployments","href":"/api-reference/deployments/list-deployments"},{"title":"Create deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/deployments","href":"/api-reference/deployments/create-deployment"},{"title":"Get deployment health","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/deployments/health","href":"/api-reference/deployments/get-deployment-health"},{"title":"Get deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/deployments/{deployment_id}","href":"/api-reference/deployments/get-deployment"},{"title":"Update deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/deployments/{deployment_id}","href":"/api-reference/deployments/update-deployment"},{"title":"Revoke deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/deployments/{deployment_id}/revoke","href":"/api-reference/deployments/revoke-deployment"},{"title":"Rotate deployment credential","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/deployments/{deployment_id}/rotate","href":"/api-reference/deployments/rotate-deployment-credential"}]}]}]},"basePath":"","title":"Update agent - Xenovia","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}