Delete a chain policy
Proposes deleting the policy for good (chain-policies:propose); /approve concludes it.
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
A note for the approvers of this proposal; empty-not-null. At most 256 bytes; longer refuses INVALID_FIELD. Optional in this body: absent reads as "".
Response
The chain policy 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
≠ UNKNOWN on a policy row. 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
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
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.
Owner-stamped.
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.
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 row’s version — monotonic per record, bumped on every change; served as the ETag and taken by If-Match. int64 as a decimal JSON string
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
The asset the venue charges an on-chain transfer’s fee in — the one maxFeeAmount is stated in; 0 = the moved asset.
FALSE = chain disabled for this asset: an unstated chain moves nothing. a boolean; absent reads false
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 next proposal replaces them. 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, or a checker returning it; null when none was. an actor: an object {kind, id}; null where none is stated
The fee allowance an on-chain transfer of this asset over this chain reserves beside its amount, in the asset feeAssetId names, and the ceiling a venue’s quoted fee is refused above; 0 = no allowance — the transfer reserves its amount alone and no quoted fee is refused. money (a Decimal on the wire: a scaled integer with its own scale), served as an exact decimal string at the value’s own scale — every fractional digit that scale states, trailing zeros included; never raw; null when the 0 sentinel means unset
0 = no bound. money (a Decimal on the wire: a scaled integer with its own scale), served as an exact decimal string at the value’s own scale — every fractional digit that scale states, trailing zeros included; never raw; null when the 0 sentinel means unset
The settle gate: the confirmation depth at which an on-chain transfer counts as settled rather than in transit; 0 = not stated, and a transfer never settles (the strict reading).
0 = no bound. money (a Decimal on the wire: a scaled integer with its own scale), served as an exact decimal string at the value’s own scale — every fractional digit that scale states, trailing zeros included; never raw; null when the 0 sentinel means unset
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
The obligation’s value-date offset (value date = the envelope time plus this); 0 = due immediately, so breaches surface at once (the noisy-safe reading). int64 as a decimal JSON string