API Reference
DraftLast reviewed 2026-06-23Supersede an instrument's financial terms
POST/api/v1/instruments/:id/supersede
Deactivates the original and creates a corrected successor with a fresh UUID. Blocked (409) when a confirmed/settling/settled/accounted deal references the instrument.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
Successor created; original superseded
Successor details fail schema validation
Authentication required
Insufficient scope — requires instruments:supersede
Instrument not found
Instrument INACTIVE, or a live deal references it