Patch agents
Authorizations
JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer
Path Parameters
Unique identifier of the agent to update
^[0-9A-HJKMNP-TV-Z]{26}$Body
Request body for updating an existing agent
Updated display name for the agent
2 - 100Updated URL-friendly unique identifier
2 - 64^[a-z0-9-]+$Updated lifecycle status
ACTIVE, SUSPENDED, DELETED Updated key-value metadata (replaces existing metadata)
Response
OK
Full agent resource representation
Unique identifier of the agent
^[0-9A-HJKMNP-TV-Z]{26}$Organization ID that owns this agent
^[0-9A-HJKMNP-TV-Z]{26}$Human-readable display name
URL-friendly unique identifier
Current lifecycle status
ACTIVE, SUSPENDED, DELETED Prefix of the agent's API key for identification, or null if no key is set
ISO 8601 timestamp of the last API-key rotation, null if never rotated
Arbitrary key-value metadata
Email identities associated with this agent
Phone identities associated with this agent
Timestamp when the agent was created
Timestamp when the agent was last updated
Per-capability readiness summary. Optional for backward compatibility — clients without readiness handling continue to work; clients that branch on it get the delayed-verification gap closed.
