Skip to main content
PUT
Replace an agent's fallback providers

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

Body

application/json

PUT /agents/{agent_id}/fallbacks: the whole ordered list (positions 1..N in this order) and, optionally, routing. Omitting routing keeps it; null resets it to the defaults.

fallbacks
AgentFallbackEntry · object[]
required
routing
AgentRoutingUpdate · object | null

Part or all of AgentRouting; an omitted field keeps its value.

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
fallbacks
AgentFallbackRead · object[]
routing
AgentRouting · object

An agent's failover settings, always whole (every default filled).

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

primary_residency
enum<string>
default:unknown
Available options:
us,
eu,
apac,
global,
unknown