Delete a Cloud Agent permanently via API
Permanently remove a Cloud Agent with DELETE https://api.cursor.com/v1/agents/{id}. Official reference: Cloud Agents API → Delete An Agent Permanently.
The Cloud Agents API v1 is in public beta. Authenticate with Basic auth (API key as username, empty password) or Authorization: Bearer YOUR_API_KEY. Create a user key at Cursor Dashboard → API Keys, or use a service account key. Availability: Beta (all plans) per the API overview.
This action is irreversible. Prefer archive when you might need the agent, its conversation, or its artifacts again.
Request
Path parameter id is the agent id (bc-…).
curl --request DELETE \
--url https://api.cursor.com/v1/agents/bc-00000000-0000-0000-0000-000000000001 \
-u YOUR_API_KEY:
Response:
{
"id": "bc-00000000-0000-0000-0000-000000000001"
}
After delete, Get An Agent and Create A Run for that id fail. Artifacts on the agent workspace are gone with the agent. Download anything you need first via List and download Cloud Agent artifacts via API.