Docs

Update Order

PATCH /orders/{orderId}

PATCH/orders/{orderId}

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.

Updates all editable fields on an existing order, including status, notes, dates, and billing/delivery details.

Path Parameters

FieldTypeRequiredDescription
orderIdGuidRequiredThe ID of the order to update. Replace `{{orderId}}` in the URL.

Request Body

FieldTypeRequiredDescription
namestringRequiredOrder name.
statusstringRequiredOrder status (e.g. `"Draft"`, `"Submitted"`, `"Confirmed"`).
internalNotesstringOptionalInternal-facing notes.
externalNotesstringOptionalExternal/vendor-facing notes.
isDeliveryboolRequiredWhether this order requires delivery at the order level.
startDateTimeDateTimeRequiredOrder start date/time (ISO 8601).
endDateTimeDateTimeRequiredOrder end date/time (ISO 8601).
billingInformationBillingOptionalBilling contact and address. Pass `null` to clear.
billingInformation.namestringOptionalBilling contact name.
billingInformation.companystringOptionalCompany name.
billingInformation.emailstringOptionalEmail.
billingInformation.phonestringOptionalPhone.
billingInformation.addressstringOptionalStreet address.
billingInformation.citystringOptionalCity.
billingInformation.statestringOptionalState/province.
billingInformation.countrystringOptionalCountry.
billingInformation.postalCodestringOptionalPostal/ZIP code.
deliveryInformationDeliveryOptionalDelivery address. Same shape as `billingInformation`. Pass `null` if not applicable.

Response

Returns 200 OK with an empty body on success.