Update order status

PATCH 
/v1/orders/:id/status

Changes the status of an order and returns the updated order. Orders only move forward: sending a status earlier than the current one leaves the order unchanged, and skipping ahead applies the statuses in between. To cancel an order use POST /v1/orders/{id}/cancel.

Unlike the endpoints that change what an order contains, this one works for orders from any channel: advancing an order the merchant is already fulfilling is an operational action, whoever took it.

Required scope: orders:write

Request

Responses

200

The updated order.

401

Unauthenticated — the request is missing a credential, or the Bearer token / API key is invalid, expired, or revoked.

403

Insufficient scope — the credential is authenticated but lacks a scope the endpoint requires.

404

Not found — no resource matches the id in the path (or it belongs to a different company).

422

Validation failed — the request body failed schema validation. errors[] lists every offending field.