REST API: agents
Create, inspect, update, and delete agents from a trusted backend.
Use the Agents REST endpoints to run an agent's full lifecycle from your own backend. List agents, or create an agent. Then store the returned identifier in your service. Before you update an agent, fetch its current resource. Keep each update narrow. A configuration change, an avatar removal, and a deletion are different actions. Each action has different recovery expectations.
Deletion is an administrative operation. Before you request a deletion, make sure that the organization and the agent identifier are correct. Record the deletion in your own audit trail. You can cancel a pending deletion with the dedicated endpoint. Do not assume that another kind of update reverses a deletion. An avatar removal deletes only the avatar. It does not delete the agent or its configured knowledge.
Use a write-scope key for routine changes. Use a more privileged key for destructive actions. Parse the standard response envelope. Log the error codes. Do not retry authorization errors or validation errors. For setup parameters and exact payloads, see the generated reference. This guide describes the lifecycle workflow. It does not replace the schema catalog.