Agents

Endpoints for managing agents and their versions. See the Agents guide for the workflow these endpoints support.

Agent management

• POST /api/v1/agents/ — create an agent.
• GET /api/v1/agents/ — list all agents.
• GET /api/v1/agents/{agent_id} — get one agent (by UUID or slug).
• PATCH /api/v1/agents/{agent_id} — update name, description, status.
• DELETE /api/v1/agents/{agent_id} — delete agent and all versions.

Version management

• POST /api/v1/agents/{agent_id}/versions — create a new version.
• GET /api/v1/agents/{agent_id}/versions — list versions.
• GET /api/v1/agents/{agent_id}/versions/{version} — get one version.
• PATCH /api/v1/agents/{agent_id}/versions/{version} — update version status.