Apply changes to statuses of jobs

Request

Updates the status of one of more jobs, so that these changes can be reflected upon the tour instantly. This is only an auxiliary way for providing Bettermile with job updates, while the main job updates are still to be transmitted over the connector.

Security

ApiKeyAuth

Path

tourIdstring, (uuid)required

Unique tour identifier (generated by Better Route backend)

Example:3fa85f64-5717-4562-b3fc-2c963f66afa6

Bodyapplication/jsonrequired

statusChangesArray of objects, [ 1 .. 150 ] items(JobStatusChange)

List of job status changes to be applied (only 1 status change per job is allowed)

Example:

[
  {
    "jobId": "c1a4e572-89ab-4cde-8f01-234567890abc",
    "state": "PROCESSED",
    "timestamp": "2026-07-29T09:15:00Z",
    "outcome": "SUCCESS",
    "description": "Delivered to neighbor",
    "coords": { … }
  }
]

curl -i -X POST \
  https://dev.routes.bettermile.com/v1/tours/3fa85f64-5717-4562-b3fc-2c963f66afa6/jobs/statuses \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "statusChanges": [
      {
        "jobId": "c1a4e572-89ab-4cde-8f01-234567890abc",
        "state": "PROCESSED",
        "timestamp": "2026-07-29T09:15:00Z",
        "outcome": "SUCCESS",
        "description": "Delivered to neighbor",
        "coords": {
          "lat": 52.52,
          "lon": 13.405
        }
      }
    ]
  }'

Responses

Changes to statuses of jobs have been successfully applied

Bodyapplication/json

dataobject

Example:

{}

Response

{
  "data": {}
}