Skip to main content
POST
Deactivate agent

Authorizations

Authorization
string
header
required

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

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
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.

deployment_id
string<uuid> | null