Routes · Delete
Delete a route via API
Endpoint
POST
https://claix.dev/routes/delete/{route_id}Deletes a route from your account and all of its versions. The operation is irreversible. Only routes you own are removed: if the UUID is missing or belongs to another account, the API returns 404.
Replace {route_id} with the UUID. DELETE is also accepted, as is sending route_id in the JSON body or query string.
This call is free: it is not billed.
1. Authentication
Include your API key on every request:
x-api-key: <YOUR_API_KEY>
or
Authorization: Bearer <YOUR_API_KEY>
2. Request format
Method: POST (also DELETE)
| Field | Type | Required | Description |
|---|---|---|---|
| route_id | uuid | Yes | In the URL /routes/delete/{route_id}. Alternatives: JSON body { "route_id": "..." } or ?route_id=. |
If route_id is in the URL, no body is required.
3. How to build the call
- Get the
route_idof the route you want to delete. - Call
https://claix.dev/routes/delete/<route_id>with POST or DELETE and your API key. - Expect 200: only then are the route and its versions gone.
If the route was assigned to an agent, review that agent in the dashboard and remove the stale reference.
4. Call examples
Use the panel on the right for cURL, JavaScript, Node.js, Python, PHP, and n8n examples.
5. Successful response
200 OK · Content-Type: application/json
{
"success": true,
"deleted": true,
"route_id": "7c2f9a1e-4b8d-4e6a-9f21-0a1b2c3d4e5f",
"name": "Agenda de citas",
"slug": "agenda_de_citas"
}6. Common errors
| HTTP | When |
|---|---|
| 401 | Missing/invalid API key or inactive account. |
| 404 | Route not found or not on your account. |
| 400 | Missing route_id or not a valid UUID. |
| 405 | Method not allowed. |
| 500 | Internal error while deleting. |
Error example:
{
"error": "Descripción legible del problema.",
"detalle": "Información técnica adicional (solo presente en algunos casos).",
"log_id": "7c2e1a90-4b3d-4f8a-9e21-6d5c8b0a1f34"
}