Skip to main content
DELETE
/
api
/
v1
/
agents
/
:name
Delete Agent
curl --request DELETE \
  --url https://api.example.com/api/v1/agents/:name
{
  "deleted": true
}
Deletes an agent and all associated data. This operation cannot be undone.

​
Path Parameters

​
Response

​
deleted
boolean
required
Confirmation that the agent was deleted. Always returns true on success.

​
Example Request

curl -X DELETE https://api.manifest.build/api/v1/agents/my-agent \
  -H "Cookie: better-auth.session_token=YOUR_SESSION_TOKEN"

​
Example Response

{
  "deleted": true
}

​
Error Responses

​
403 Forbidden

Returned when attempting to delete an agent in local mode: 
{
  "statusCode": 403,
  "message": "Cannot delete agents in local mode"
}

​
404 Not Found

Returned when:
  • The agent doesn’t exist
  • The agent doesn’t belong to the authenticated user
{
  "statusCode": 404,
  "message": "Not Found"
}

​
Notes

  • This operation is destructive and cannot be undone
  • Deleting an agent removes:
    • The agent entity
    • Associated API keys
    • All telemetry data (messages, logs, traces)
    • Usage statistics and analytics
  • Agent deletion is disabled in local mode (MANIFEST_MODE=local) for safety
  • In cloud mode, the deletion cascades through all related entities via database constraints
  • After deletion, the agent name becomes available for reuse

Build docs developers (and LLMs) love

Get started for freeTalk to us