agents

Replace an agent's fallback providers

Changed on

Replace the whole ordered list of fallback providers (positions 1..N in the order sent, at most 3) and, when sent, the failover settings (routing, merged onto the current ones; null resets them).

Each fallback is one of the organisation's provider connections, with an optional model override. A refused change answers a detail object with a stable code and changes nothing. The agent's config version (and credential version) advances, so the runtime picks the chain up.

put/api/v1/agents/{agent_id}/fallbacks

Request

  • Base URL
    https://cp.xenovia.io (the document declares no server; this is the origin it was published from)
  • URL
    https://cp.xenovia.io/api/v1/agents/{agent_id}/fallbacks
  • Auth
    none declared

Path parameters

agent_idstring uuid required

Headers

Authorizationstring nullable
X-Request-IDstring nullable

Request body

Response

Successful Response

idstring uuid required
created_atstring date-time required
updated_atstring date-time required
org_idstring uuid required
owner_idstring uuid nullable required
namestring nullable required
descriptionstring nullable required
system_promptstring nullable required
purposestring nullable
purpose_mode'monitor' | 'enforce'
status'draft' | 'active' required
source'auto' | 'manual' required
coding_toolstring nullable
provider_idstring uuid nullable required
deployment_idstring uuid nullable
primary_residency'us' | 'eu' | 'apac' | 'global' | 'unknown'
agent_urlstring required

Inference base URL a developer pastes into their client (see format_agent_url for the hybrid/cloud rendering rules).

Changes

  • 3e25bef24f8fRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1882866431adRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status