---
title: "Update delivery"
method: PATCH
path: "/deliveries/{id}"
tags: ["deliveries"]
---

# Update delivery

`PATCH /deliveries/{id}`

## Request

- Base URL: `https://api.vepathos.com`
- URL: `https://api.vepathos.com/deliveries/{id}`
- Auth: API key in header `Authorization`

Send only the fields to change.

## Path parameters

- `id` integer, required

## Request body

- DeliveryUpdate
  - `destination` string, nullable: Stop location. Coordinates in ISO 6709 decimal degrees, latitude then longitude with signs, e.g. `+40.7128-74.0060`.
  - `method` 'DELIVERY' | 'PICKUP' | 'SIGNATURE'
  - `schedules` string[], nullable: Time windows. RFC 5545 VEVENT: `DTSTART` plus `DTEND` or `DURATION`, optionally `RRULE`. Join lines with `\n`.
  - `width` integer, nullable: Package width, in `length_unit`. Integer.
  - `height` integer, nullable: Package height, in `length_unit`. Integer.
  - `depth` integer, nullable: Package depth, in `length_unit`. Integer.
  - `length_unit` 'CENTIMETER' | 'METER' | 'KILOMETER' | 'INCH' | 'FEET' | 'MILE'
  - `volume` integer, nullable: Package volume, in `volume_unit`. Integer.
  - `volume_unit` 'CUBIC_CENTIMETER' | 'CUBIC_METER' | 'LITER' | 'CUBIC_INCH' | 'CUBIC_FEET' | 'GALLON'
  - `weight` integer, nullable: Package weight, in `weight_unit`. Integer; use `GRAMS` for fractional kilograms.
  - `weight_unit` 'GRAMS' | 'KILOGRAMS' | 'OUNCES' | 'POUNDS'
  - `packaging` 'BOX' | 'ENVELOPE' | 'BAG' | 'CARTON' | 'PALLET' | 'SHRINK_WRAP'
  - `handling` SpecialHandling[], nullable
  - `value_cents` integer, nullable: Declared value in minor units (`5000` is 50.00).
  - `value_currency` string, nullable: ISO 4217 currency code.
  - `extra` unknown
  - `milestone_id` string, nullable: Milestone the package leaves from.

## Response `200`

The updated delivery.

- DeliveryResponse
  - `destination` string, required: Stop location. Coordinates in ISO 6709 decimal degrees, latitude then longitude with signs, e.g. `+40.7128-74.0060`.
  - `method` 'DELIVERY' | 'PICKUP' | 'SIGNATURE'
  - `schedules` string[], nullable: Time windows. RFC 5545 VEVENT: `DTSTART` plus `DTEND` or `DURATION`, optionally `RRULE`. Join lines with `\n`.
  - `width` integer, nullable: Package width, in `length_unit`. Integer.
  - `height` integer, nullable: Package height, in `length_unit`. Integer.
  - `depth` integer, nullable: Package depth, in `length_unit`. Integer.
  - `length_unit` 'CENTIMETER' | 'METER' | 'KILOMETER' | 'INCH' | 'FEET' | 'MILE'
  - `volume` integer, nullable: Package volume, in `volume_unit`. Integer.
  - `volume_unit` 'CUBIC_CENTIMETER' | 'CUBIC_METER' | 'LITER' | 'CUBIC_INCH' | 'CUBIC_FEET' | 'GALLON'
  - `weight` integer, nullable: Package weight, in `weight_unit`. Integer; use `GRAMS` for fractional kilograms.
  - `weight_unit` 'GRAMS' | 'KILOGRAMS' | 'OUNCES' | 'POUNDS'
  - `packaging` 'BOX' | 'ENVELOPE' | 'BAG' | 'CARTON' | 'PALLET' | 'SHRINK_WRAP'
  - `handling` SpecialHandling[], nullable
  - `value_cents` integer, nullable: Declared value in minor units (`5000` is 50.00).
  - `value_currency` string, nullable: ISO 4217 currency code.
  - `extra` unknown
  - `id` union, required
    - string
    - integer
  - `milestone` MilestoneResponse, required
    - `name` string, required: Display name.
    - `location` string, required: Coordinates in ISO 6709 decimal degrees, latitude then longitude with signs, e.g. `+40.7128-74.0060`.
    - `category` 'DEPOT' | 'DISTRIBUTION_CENTER' | 'LOADING_POINT' | 'WAREHOUSE' | 'TRANSFER_POINT'
    - `id` union, required
      - string
      - integer
  - `arrival_time` union: Estimated arrival in minutes after midnight, including the route start from `config.schedule.start_at`. Present on deliveries inside plan routes.
    - number
    - string

## Other responses

- `401`: Missing, expired or invalid access token.
- `404`: The resource does not exist in your account.
- `422`: The body or a parameter does not match the schema.

---

[API](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api.md) · [All operations](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api/revisions/00caa1ca62d9?raw)