Withdraw a lowered approval rule
Withdraws the lowering pending on the rule — its proposer or any org:manage holder — with an optional reason for the proposer; the count in force stands. Answers the rule; nothing pending is 409 NOTHING_PENDING.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
The record’s id — a positive 32-bit integer the platform minted.
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.
Required on every entity write: the ETag the read minted, quoted or bare — the version this write was computed against — or * to write unconditionally on purpose, except on a notification endpoint’s approval, which refuses * 400 INVALID_IF_MATCH. Absent is 428 PRECONDITION_REQUIRED; a weak validator 400 INVALID_IF_MATCH; a stale value 412 VERSION_CONFLICT (CONFIG_SEQ_CONFLICT on an algo’s config write) with currentVersion and a fresh ETag: re-read, reapply, retry. A * write overwrites every field from your copy, a colleague’s amend since your read included.
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
Why the proposal is withdrawn, for its maker; empty-not-null. Kept on the record as lastWithdrawalReason until the next proposal. At most 256 bytes; longer refuses INVALID_FIELD. Optional in this body: absent reads as "".
Response
The approval rule as the platform now holds it after the write — the same row the read serves, with the answering change’s position, the row’s ETag and, on a replayed key, Idempotent-Replay.
Who approved the row’s last proposal and when, in approval order — grown by each approval and kept on the concluded row as its record until the next proposal or a withdrawal clears it; empty until the first approval. The proposal concludes at the approval that meets the organisation’s count for the family as it stands then; pendingTransition says whether one is pending. a repeating group served as an array of objects, in the group’s own order; empty = no entries, never null
What the row’s last proposal proposed, kept once it concluded: the pending transition the conclusion cleared, as the register wrote it; NONE while it pends, or where none was. So the concluded row says what concluded, however its status has moved on since. NONE is the unset sentinel: outputs only — as input the field is required, and explicit NONE refuses 400. A consumer READING this field treats an unknown name as NONE, never as an error; as input an unknown name refuses 400 — the parse is strict
Approvals a proposal in the family needs: 0 (the default) = the maker’s own write concludes it, 1 = one other user’s approval, up to 4 — account addresses included since v16, their verifications being the approvals. uint8: an integer 0..255
The family the rule governs; one rule per organisation and family. UNKNOWN is the unset sentinel: outputs only — as input the field is required, and explicit UNKNOWN refuses 400. A consumer READING this field treats an unknown name as UNKNOWN, never as an error; as input an unknown name refuses 400 — the parse is strict
The position as a decimal string — the last change this member had applied, orders, balance readings and algo instances included.
Why the last proposal was withdrawn, as the withdrawer stated it; empty-not-null, and empty when a raise or restatement replaced it.
Owner-stamped.
AMEND while a lowering of the count waits for a second org:manage holder; NONE otherwise. NONE is the unset sentinel: outputs only — as input the field is required, and explicit NONE refuses 400. A consumer READING this field treats an unknown name as NONE, never as an error; as input an unknown name refuses 400 — the parse is strict
The maker’s note on the pending proposal, for its approvers; empty-not-null. At most 256 bytes; longer refuses INVALID_FIELD.
Platform time the row’s last proposal concluded; 0 while it is pending, or when the row never carried one. A write the organisation’s count let through at once concludes in the maker’s own fact: equal to proposedAtNs. int64 as a decimal JSON string
Who concluded the row’s last proposal: the approver whose approval met the organisation’s count, or the maker when the count was 0 and the write concluded at once; null while it is pending, or when the row never carried one. an actor: an object {kind, id}; null where none is stated
When an API key made the row’s last proposal, the member the key’s secret had last been answered to as it proposed — its last rotator then, else its issuer — kept on the concluded row with proposedBy; null when a member made the proposal, or the row never carried one. The proposal counts as this member’s and the key’s issuer’s, whoever rotates the key afterwards: neither may approve it (SELF_APPROVAL). an actor: an object {kind, id}; null where none is stated
Platform time of that withdrawal; 0 when none was. The three fields and lastWithdrawalReason stand until the row’s next write: a new lowering replaces them, and a raise or restatement made with nothing pending clears them with the rest of the record. int64 as a decimal JSON string
Who made the last proposal that was withdrawn; null when none was. an actor: an object {kind, id}; null where none is stated
Who withdrew it — the proposer, a holder returning it, or the holder whose raise or restatement replaced it; null when none was. an actor: an object {kind, id}; null where none is stated
Platform time the row’s last proposal was made, kept on the concluded row; 0 when the row never carried one. int64 as a decimal JSON string
Who made the row’s last proposal — kept on the concluded row as its record; null when the row never carried one (a row a connector or the platform landed). pendingTransition says whether that proposal is still pending. an actor: an object {kind, id}; null where none is stated