post/v1/reservations
All-or-nothing lock across every listing on both sides of a trade session — a side is not RESERVED until every listing in its set is locked; one unavailable listing fails the whole side. Called by trade-session-service when advancing ACCEPTED -> RESERVING. See docs/architecture/trade-session-state-machine.md "Multi-item trades".
Request body
| Field | Type | Required |
|---|
| tradeSessionId | string (uuid) | yes |
post/v1/reservations/release
Release every RESERVED reservation for a session back to ACTIVE — used on cancellation, expiry, or reservation/checkout failure. Only touches listings still RESERVED.
Request body
| Field | Type | Required |
|---|
| tradeSessionId | string (uuid) | yes |
Response (201)
| Field | Type | Required |
|---|
| released | integer | — |