Reten Docs

Create Route

Create a new route/territory.

POST /api/routes

Create a new route for territory management.

Auth: Required — MANAGE_ROUTES permission

Request Body

FieldTypeRequiredDescription
codestringYesUnique code per tenant
namestringYesRoute name

Example

curl -X POST https://api.reten.ai/api/routes \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "ZONE-NORTH",
    "name": "North Zone"
  }'
const response = await fetch("https://api.reten.ai/api/routes", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ code: "ZONE-NORTH", name: "North Zone" }),
});
const route = await response.json();
import requests

response = requests.post(
    "https://api.reten.ai/api/routes",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
    json={"code": "ZONE-NORTH", "name": "North Zone"},
)
route = response.json()

Response 201 Created

{
  "id": "dd0e8400-e29b-41d4-a716-446655440000",
  "code": "ZONE-NORTH",
  "name": "North Zone",
  "isActive": true
}

Error Responses

StatusDescription
409Route code already exists