Reten Docs

Deactivate Route

Soft-deactivate a route with cascade to operator links.

POST /api/routes/:id/deactivate

Soft-deactivates a route and cascades deactivation to all operator links.

Auth: Required — route:manage permission

Path Parameters

ParameterTypeDescription
idUUIDRoute ID

Example

curl -X POST https://api.reten.ai/api/routes/dd0e8400-e29b-41d4-a716-446655440000/deactivate \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
const routeId = "dd0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/routes/${routeId}/deactivate`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
  },
});
import requests

route_id = "dd0e8400-e29b-41d4-a716-446655440000"
response = requests.post(
    f"https://api.reten.ai/api/routes/{route_id}/deactivate",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
)

Response 204 No Content

Cascade Behavior

  • Route isActive → false
  • All route_operator_links for this route → isActive = false