RoboLedger: Report Distribution

Block Source Graph

Bars a graph from sharing reports into this one. Subsequent share-report calls naming this graph fail for this target with an explicit error — blocked senders are told, not silently dropped. Idempotent: re-blocking preserves the original blocked_at. Set purge to also delete every report already shared in from that source, along with its fact sets and facts; reports this graph authored are never touched.

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/block-source-graph

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/block-source-graph
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

source_graph_idstring required

Graph ID to block. Read it off the source_graph_id provenance field of a report that was shared to you.

reasonstring nullable

Free-form note for your own records. Never disclosed to the sender.

purgeboolean

Also delete every report already shared in from this source, with their fact sets and facts. Reports you authored are never touched.

Example request

{
  "source_graph_id": "kg1a2b3c4d5e6f7a8b9c"
}

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.