# Apply changes to statuses of jobs

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.

Endpoint: POST /v1/tours/{tourId}/jobs/statuses
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `tourId` (string, required)
    Unique tour identifier (generated by Better Route backend)

## Request fields (application/json):

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

  - `statusChanges.jobId` (string, required)
    Job identifier generated by the backend

  - `statusChanges.state` (string, required)
    Status of the job
    Enum: "PROCESSED", "UNPROCESSED", "UNKNOWN"

  - `statusChanges.timestamp` (string, required)
    Time at which this job status was changed (it should not be older than 1h)

  - `statusChanges.outcome` (any)
    Example: "SUCCESS"

  - `statusChanges.description` (string,null)
    Description for the status change

  - `statusChanges.coords` (any)

## Response 200 fields (application/json):

  - `data` (object)
    Example: {}

## Response 400 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)

## Response 401 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)

## Response 404 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)

## Response 500 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)