REST API: agents
Create, inspect, update, and retire agents from a trusted backend.
Use the Agents REST endpoints to automate an agent lifecycle from your own backend. Start by listing or creating agents, retain the returned identifier in your service, and fetch that resource before applying an update. Keep each update narrow: a configuration change, avatar removal, and deletion are different operational actions with different recovery expectations.
Deletion is an administrative operation. Before requesting it, confirm that the intended organization and agent identifier are still current, and make the operation visible in your own audit trail. A pending deletion can be cancelled through the dedicated endpoint; do not assume an arbitrary update will reverse it. Removing an avatar likewise removes only the avatar, not the agent or its configured knowledge.
Use write scope for routine mutation and an appropriately privileged key for destructive work. Parse the standard response envelope and log error codes rather than retrying an authorization or validation error. For setup parameters and exact payloads, follow the generated reference; this guide is a lifecycle workflow, not a replacement schema catalog.