Approve a manual execution
Adds one approval to a pending manual execution (risk:approve, a person); not by the maker (403 SELF_APPROVAL), nor twice (409 ALREADY_APPROVED). The approval that meets the organisation’s risk count records it as an execution, unless one under its reference has arrived since (409 REFERENCE_TAKEN, left pending). Takes no If-Match. Answers the manual execution.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
The manual execution’s id — a positive 64-bit integer as decimal digits.
Headers
Required on every write: a URL-safe string of 1 to 64 characters from [A-Za-z0-9._~-] (a UUID fits), scoped to you. It names one operation on one record, ever: a retry replays the stored outcome (Idempotent-Replay: true) or attaches to the live one, and reuse on another record refuses 409 IDEMPOTENCY_KEY_REUSED. Missing or malformed, 400.
Your own id for the request: 8 to 128 of [A-Za-z0-9._-]. It becomes the request’s id and is echoed on the response. A value off that grammar is replaced with a fresh id, never refused.
Query parameters
A position you hold — an X-Immix-Global-Sequence you read, or a 202’s commandGlobalSequence: this member answers only once it has folded the platform’s stream through it, waiting up to its deadline, then 503 PROJECTION_BEHIND with Retry-After. Within that stream a read is never older than what you have seen; drop your positions after an announced stream cut. A retry stating its 202’s position attaches to or replays that operation while the journal holds its key, never publishing twice. Stated once: one to nineteen digits, at most 9223372036854775807; else 400 MALFORMED_REQUEST.
Request
Response
The manual execution as the platform now holds it after the write — the same row the read serves, with the answering change’s position, its ETag and, on a replayed key, Idempotent-Replay.
The manual execution’s id, a 64-bit integer as decimal digits.
Its version as a decimal string: 1 when drafted, one more for each approval and for the withdrawal; its ETag.
The account the trade is booked to (GET /accounts).
The instrument traded, as POST /orders names it by instrumentId, listed at the account’s venue.
The account’s side of the trade. The value set is append-only: read an unknown value as UNKNOWN.
Whether the account made or took liquidity, when known; UNKNOWN otherwise.
money (an exact decimal string at the scale it was drafted at): the quantity traded, in the instrument’s own unit (contracts for a swap).
money (an exact decimal string at the scale it was drafted at): the price traded at.
money (an exact decimal string at the scale it was drafted at): the fee charged in feeAssetId, negative for a rebate; null when none was drafted.
The asset the fee is in; null when none was drafted.
When it traded at the venue or counterparty, epoch nanoseconds — the execution’s fillTsNs and venueTsNs.
Why it was booked by hand. The value set is append-only: read an unknown value as UNKNOWN.
The venue’s trade id, or the counterparty’s or desk’s reference: the execution’s venueTradeId, which a reconciliation matches.
PENDING_APPROVAL: drafted, booking nothing until approved. RECORDED: booked as the execution executionId names. WITHDRAWN: withdrawn, never booked. The value set is append-only: read an unknown value as UNKNOWN.
The maker — an actor, always a member’s: only members write risk.
Who approved it and when, in approval order; empty until the first approval. It is recorded when they number the organisation’s risk rule in force at that approval, and at least one (GET /approval-rules?family=RISK).
When it was recorded, epoch nanoseconds; null until then.
The execution it was recorded as (GET /executions/{id}); null until then.
Who withdrew it; null unless withdrawn.
Who produced this version, never null: the maker on the draft, an approver on an approval, the withdrawer on the withdrawal.
Why it was withdrawn; empty unless withdrawn.
The position as a decimal string — the last change this member had applied, orders, balance readings and algo instances included.