Cancel Manufacturing Order

POST 
/api/manufacturing/manufacturing-orders/:id/cancel

Cancel a manufacturing order. Transitions any non-closed status → Cancelled and releases any inventory reservations.

Required body fields:

• reason_code (string, required) — must be one of the 5 allowed values:
  • plan_changed — Plan changed
  • materials_unavailable — Materials unavailable
  • customer_cancellation — Customer cancellation
  • equipment_issue — Equipment issue
  • other — Other

Optional body fields:

• notes (string, nullable, max 2000) — Free-text reason explanation
• reason_notes (string, nullable, max 2000) — Alias for notes — accepted for API consistency. If notes is absent and reason_notes is provided, it is copied into notes during validation. Sending both means notes wins.

Returns 422 if reason_code is missing or not in the allowed list. Authentication: Bearer token required.

Required scope: manufacturing:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Unprocessable Entity

Response Headers

Content-Type

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.