Skip to main content
DELETE
Cancel an order

Authorizations

Authorization
string
header
required

Optional developer API key: Authorization: Bearer pp_live_… (or pp_test_… for a sandbox-only key). Omitting it is a supported way to call every route. A key that is sent and does not verify is refused with 401 rather than treated as anonymous, so a typo fails loudly instead of quietly losing the restriction you meant to apply. Enabled per deployment via SCOPED_API_KEYS.

Headers

X-Capability-Token
string
required

Signed cancel token returned by POST /v1/orders for this order, as capability.cancel_token. Valid for 7 days. Both capability tokens carry the ppc_ prefix — they are told apart by the action they were signed for, not by their prefix.

Pattern: ^ppc_

Path Parameters

id
string
required

Order id, e.g. ord_1a2b3c4d5e6f7a8b (sandbox orders are ord_test_...).

Response

The canceled order

status
string
required
Allowed value: "ok"
order
object
required
Last modified on September 17, 2026