Routes
Create Route
Create a new route/territory.
POST /api/routes
Create a new route for territory management.
Auth: Required — MANAGE_ROUTES permission
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
code | string | Yes | Unique code per tenant |
name | string | Yes | Route 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"
}'import axios from 'axios';
const response = await axios.post(
'https://api.reten.ai/api/routes',
{
code: 'ZONE-NORTH',
name: 'North Zone',
},
{
headers: {
Authorization: 'Bearer <token>',
'x-tenant-id': '<tenant-id>',
},
}
);Response 201 Created
{
"id": "dd0e8400-e29b-41d4-a716-446655440000",
"code": "ZONE-NORTH",
"name": "North Zone",
"isActive": true
}Error Responses
| Status | Description |
|---|---|
409 | Route code already exists |