# Request creation of a new tour

Endpoint: POST /v1/tours
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `date` (string, required)
    Date on which the tour is / will be driven. Must not be in the past

  - `assignment` (string, required)
    Vehicle / route / driver identifier. This value is used to look up jobs in Data Gateway

  - `depot` (string, required)
    Depot identifier

  - `depotIsDestination` (boolean)
    Whether to use depot address as the destination for the tour.

## Response 200 fields (application/json):

  - `data` (object)
    Output from tour creation

  - `data.tourId` (string)

## 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 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)