Skip to main content

Cancel Fulfillment Order

POST 
/api/fulfillment-orders/:fulfillmentOrder/cancel

Cancels the FO, releases its line budgets back to the parent SOLs (so a different FO can pick them up), and optionally records a rejection reason. Sets status=cancelled + cancelled_at.

Mutability gate. Rejected if the FO is already terminal (status=closed/cancelled) OR if request_status is currently in-flight with the provider (submitting, cancellation_requested). Use the cancel-request flow in Stage 2 to cancel an in-flight FO.

Body fields:

  • reason (nullable, string, max 1000) — stored on rejection_reason for audit.

Request​

Responses​

Successful response