Publish a route

post/routes

Share a new trade route with the partner network.

Request Body

required

application/json

namestringrequired

regionstringrequired

waypointsarray of stringrequired

Responses

201Route published

application/json

idstring (uuid)

namestring

regionstring

waypointsarray of string

distance_kminteger

published_bystring

created_atstring (date-time)

Request

curl -X POST 'https://partners.cameltrading.example/v2/routes' \
  -H 'Authorization: Bearer <your-token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "region": "string",
  "waypoints": [
    "string"
  ]
}'

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Northern Silk Road",
  "region": "northern",
  "waypoints": [
    "oasis-north-1",
    "oasis-north-3"
  ],
  "distance_km": 480,
  "published_by": "partner_acme",
  "created_at": "2024-01-15T10:30:00Z"
}