Archive Agent

POST/v1/agents/{agent_id}/archive

Archive an agent. Existing sessions keep their agent snapshot, while new sessions can no longer reference the archived agent.

Path parameters

stringagent_idrequired

Unique agent identifier beginning with agent_.

Soft delete

Archiving is designed as a soft delete. Existing sessions continue to run from their pinned agent snapshot.

Errors

401authentication_error

The API key is missing or invalid.

404not_found

The agent does not exist.

curl -X POST \
  "https://api.sandbase.ai/v1/agents/agent_01HqR2k7.../archive" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "id": "agent_01HqR2k7...",
  "type": "agent",
  "version": 1,
  "name": "Research Assistant",
  "archived_at": "2026-05-29T12:00:00Z",
  "updated_at": "2026-05-29T12:00:00Z"
}