API Reference

DraftLast reviewed 2026-06-23

Transition deal status

PATCH 
/api/v1/deals/:id/status

Moves a deal to the requested target status if the transition is permitted.

Request

Responses

200

Transition applied

403

Insufficient scope for this transition

404

Deal not found

422

Transition not defined in state machine