# Delete a stop

Remove a stop from its order.

## Prerequisites

- An order keeps at least an origin and a destination, so the last two
  stops of an order cannot be removed
- A stop a load already covers cannot be removed; take it off the load
  first

Endpoint: DELETE /stops/{id}
Version: 1.1.0
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    Stop ID

## Response 401 fields (application/problem+json):

  - `type` (string, required)
    URI identifying the problem type
    Example: "https://api.mvmnt.io/problems/not-found"

  - `title` (string, required)
    Short summary of the problem type
    Example: "Not Found"

  - `status` (integer, required)
    HTTP status code
    Example: 404

  - `detail` (string)
    Explanation specific to this occurrence
    Example: "Customer not found: 550e8400-e29b-41d4-a716-446655440000"

  - `instance` (string)
    The request path that produced the problem
    Example: "/v1/customers/550e8400-e29b-41d4-a716-446655440000"

  - `code` (string)
    Machine-readable error code, when one applies

  - `errors` (array)
    Per-field problems, when the error concerns specific fields

  - `errors.field` (string, required)
    The field the message refers to
    Example: "/required"

  - `errors.message` (string, required)
    What is wrong with it
    Example: "missing property 'status'"

## Response 404 fields (application/problem+json):

  - `type` (string, required)
    URI identifying the problem type
    Example: "https://api.mvmnt.io/problems/not-found"

  - `title` (string, required)
    Short summary of the problem type
    Example: "Not Found"

  - `status` (integer, required)
    HTTP status code
    Example: 404

  - `detail` (string)
    Explanation specific to this occurrence
    Example: "Customer not found: 550e8400-e29b-41d4-a716-446655440000"

  - `instance` (string)
    The request path that produced the problem
    Example: "/v1/customers/550e8400-e29b-41d4-a716-446655440000"

  - `code` (string)
    Machine-readable error code, when one applies

  - `errors` (array)
    Per-field problems, when the error concerns specific fields

  - `errors.field` (string, required)
    The field the message refers to
    Example: "/required"

  - `errors.message` (string, required)
    What is wrong with it
    Example: "missing property 'status'"

## Response 409 fields (application/problem+json):

  - `type` (string, required)
    URI identifying the problem type
    Example: "https://api.mvmnt.io/problems/not-found"

  - `title` (string, required)
    Short summary of the problem type
    Example: "Not Found"

  - `status` (integer, required)
    HTTP status code
    Example: 404

  - `detail` (string)
    Explanation specific to this occurrence
    Example: "Customer not found: 550e8400-e29b-41d4-a716-446655440000"

  - `instance` (string)
    The request path that produced the problem
    Example: "/v1/customers/550e8400-e29b-41d4-a716-446655440000"

  - `code` (string)
    Machine-readable error code, when one applies

  - `errors` (array)
    Per-field problems, when the error concerns specific fields

  - `errors.field` (string, required)
    The field the message refers to
    Example: "/required"

  - `errors.message` (string, required)
    What is wrong with it
    Example: "missing property 'status'"

## Response 422 fields (application/problem+json):

  - `type` (string, required)
    URI identifying the problem type
    Example: "https://api.mvmnt.io/problems/not-found"

  - `title` (string, required)
    Short summary of the problem type
    Example: "Not Found"

  - `status` (integer, required)
    HTTP status code
    Example: 404

  - `detail` (string)
    Explanation specific to this occurrence
    Example: "Customer not found: 550e8400-e29b-41d4-a716-446655440000"

  - `instance` (string)
    The request path that produced the problem
    Example: "/v1/customers/550e8400-e29b-41d4-a716-446655440000"

  - `code` (string)
    Machine-readable error code, when one applies

  - `errors` (array, required)
    Per-field problems, when the error concerns specific fields

  - `errors.field` (string, required)
    The field the message refers to
    Example: "/required"

  - `errors.message` (string, required)
    What is wrong with it
    Example: "missing property 'status'"


## Response 204 fields