Reten Docs
Routes

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 — MANAGE_ROUTES 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>"
import axios from 'axios';

const response = await axios.post(
  'https://api.reten.ai/api/routes/dd0e8400-e29b-41d4-a716-446655440000/deactivate',
  {},
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Response 204 No Content

Cascade Behavior

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