# Amend Delivery

Amend a delivery's details before it has been dispatched to a carrier. Once a delivery has been assigned a consignment number (i.e. booked with a provider), it can no longer be amended via this endpoint.

Amending automatically re-quotes the delivery with available providers and recalculates SLA windows based on any updated timing.

***

## Endpoint

```
PATCH {{domain}}/{{tenant_id}}/deliveries/{{delivery_id}}/amend
```

**Authentication:** Bearer token required via the `Authorization` header.

***

## Request Payload

`ready_for_pickup_at` is required. All other fields are optional — only include the fields you want to change. All delivery fields can be amended, including `parcels`, `line_items`, `delivery_type`, and `reference`.

```json title="PATCH /{{tenant_id}}/deliveries/{{delivery_id}}/amend"
{
    "ready_for_pickup_at": "2026-02-05T10:00:00+11:00",
    "special_instructions": "Leave at side door",
    "reference": "ORDER-98765",
    "delivery_type": "fast",
    "address": {
        "address": "10 Smith Street",
        "city": "Collingwood",
        "state": "VIC",
        "post_code": "3066",
        "country": "AU"
    },
    "customer": {
        "first_name": "Jane",
        "last_name": "Doe",
        "phone": "0411000000",
        "email": "jane@doe.com"
    },
    "line_items": [
        {
            "code": "sku-code-001",
            "name": "SKU Item Name #001",
            "price_cents": 999,
            "quantity": 2
        }
    ],
    "parcels": [
        {
            "reference": "PARCEL_001",
            "length_cm": 20,
            "width_cm": 40,
            "height_cm": 60,
            "weight_kg": 1,
            "quantity": 1,
            "type": "carton"
        }
    ]
}
```

## Amendable Fields

| Field                  | Required | Description                                                                                                 |
| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------- |
| `ready_for_pickup_at`  | **Yes**  | The updated time the order will be ready for carrier collection. Triggers re-quoting and SLA recalculation. |
| `special_instructions` | No       | Updated delivery instructions for the driver.                                                               |
| `reference`            | No       | Your internal order or shipment reference.                                                                  |
| `delivery_type`        | No       | The requested service level — e.g. `fast`, `flexible`, `standard`, `express`.                               |
| `address`              | No       | The updated delivery destination. Triggers re-quoting with the new address.                                 |
| `customer`             | No       | Updated recipient contact details.                                                                          |
| `line_items`           | No       | The full updated list of line items. Replaces the existing `line_items` array.                              |
| `parcels`              | No       | The full updated list of parcels. Replaces the existing `parcels` array.                                    |

<Warning>
  Amendments are only possible before a consignment number has been assigned. Attempting to amend a booked delivery will return an error.
</Warning>