Orders

Run order action

Cancels the order or blocks the buyer, in a job.

POST/v1/orders/{orderId}/actions

Coming soon

This route is not in the API yet. This page shows what it will do. Fields, examples and the playground arrive when it ships.

Runs an action on the marketplace. The body has type: cancel (with reason, restock and an optional note) or block_buyer. It answers 202 with an order.action job; the order changes when the marketplace confirms and order.updated (or order.cancelled) arrives.

cancel moves the order to cancelled and releases the stock reservation under the order policy. If the marketplace does not support the action, the answer is 422 CAPABILITY_UNSUPPORTED, and no job is created.