Skip to content
Products
/
/
/Job

Job

Operations on the job level

Operations

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": {}
}