Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/everruns/everruns/llms.txt

Use this file to discover all available pages before exploring further.

​
DELETE /v1/agents/

Archive an agent by setting its status to archived. This is a soft delete - the agent data is preserved but marked as archived.

​
Path Parameters

​
id
string
required
UUID of the agent to archive

​
Response

Returns 204 No Content on success.

​
Example Request

curl -X DELETE http://localhost:9300/v1/agents/01933b5a-0000-7000-8000-000000000001

​
Example Response

204 No Content

​
Behavior

Archiving an agent:
  • Sets the agent’s status field to archived
  • Does not delete the agent data
  • Does not affect existing sessions using this agent
  • Prevents the agent from being selected for new sessions (in UI)
  • The agent still appears in list responses with status: "archived"

​
Existing Sessions

Sessions that were created with an archived agent will continue to function normally. The agent configuration is captured at session creation time. 
# This session continues to work even if the agent is archived
curl -X POST http://localhost:9300/v1/sessions/01933b5a-0000-7000-8000-000000000100/messages \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "content": [{"type": "text", "text": "Hello"}]
    }
  }'

​
Restoring Archived Agents

To restore an archived agent, use the PATCH endpoint to set the status back to active: 
curl -X PATCH http://localhost:9300/v1/agents/01933b5a-0000-7000-8000-000000000001 \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'

​
Error Responses

  • 404 Not Found - Agent with specified ID does not exist
  • 500 Internal Server Error - Server error
There is currently no hard delete operation. Once created, agent data is permanently retained in the database. This is by design to maintain audit trails and session history.