RoboLedger: Ledger & Events

Set Reconciliation Policy

Change how much the close cares about one reconciliation: whether the period's close waits on it (required_for_close); its materiality, the difference up to which it still counts as reconciled; whether the close also waits for a sign-off (review_required); and whether the reviewer must be someone other than the person who ran the comparison (separate_reviewer, which can only be turned on while the graph has at least two members who can write; if it later has one, turn it off or add a member). For a statement reconciliation, statement_cycle says how often the statement is issued (monthly, quarterly or annual): a period is covered by the latest statement ending within the cycle that ends with it, so a quarterly statement still covers the months between statements. Omitted fields keep their value. The next refresh-reconciliations uses the new materiality; comparisons already recorded are not re-judged.

Idempotency: supply an Idempotency-Key header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.

post/extensions/roboledger/{graph_id}/operations/set-reconciliation-policy

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/extensions/roboledger/{graph_id}/operations/set-reconciliation-policy
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

structure_idstring required

The reconciliation block.

required_for_closeboolean nullable

Whether the period's close waits on it. Omit to keep.

materialitynumber nullable

A difference up to this amount still counts as reconciled. Omit to keep.

review_requiredboolean nullable

Whether the close also waits for a sign-off, not just for the two sides to reconcile. Omit to keep.

separate_reviewerboolean nullable

Whether the person who signs off must be someone other than the person who ran the comparison. It can only be turned on when the graph has at least two members who can write. Omit to keep.

statement_cycle'monthly' | 'quarterly' | 'annual' nullable

statement blocks only: how often the account's statement is issued. A period is covered by the latest statement ending within the cycle that ends with it, so a quarterly statement covers the two months before the next one. Omit to keep.

Response

Successful Response

operationstring required

Kebab-case operation name

operationIdstring required

op_-prefixed ULID for audit and SSE correlation

status'completed' | 'pending' | 'failed' required

Operation lifecycle state

atstring required

ISO-8601 UTC timestamp

createdBystring nullable

User ID that initiated the operation

idempotentReplayboolean

True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.

Changes

No recorded changes to this operation across all 1 revision of this API.