Connections

Set Connection Write Policy

Choose how a live connection and RoboSystems share the books. 'qb_authoritative', the default, makes QuickBooks the book of record: RoboSystems-originated entries (manual JEs, schedule drafts) publish to QuickBooks when executed or at close. 'shadow' keeps QuickBooks the book of record and writes nothing to it: the close posts nothing locally either, its drafts become shadowed expectations compared with what QuickBooks holds, and its gates are recorded as findings. 'native' is not a choice here: it is what disconnecting or severing leaves, books kept in RoboSystems with no connection to write to. This is the explicit operator opt-in for writing to your books of record.

put/v1/graphs/{graph_id}/connections/{connection_id}/write-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/v1/graphs/{graph_id}/connections/{connection_id}/write-policy
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required
connection_idstring required

Unique connection identifier

Request body

write_policy'qb_authoritative' | 'shadow' required

'qb_authoritative' = QuickBooks authoritative, entries publish to QB; 'shadow' = QuickBooks authoritative and RoboSystems only observes: nothing is written to QuickBooks, the close posts nothing locally, its drafts become shadowed expectations and its gates are findings. 'native', books kept in RoboSystems with no write-back, is what disconnecting or severing leaves, not a choice for a live connection.

Response

Successful Response

connection_idstring required

Unique connection identifier

providerstring required

Connection provider type

entity_idstring nullable

Entity identifier

statusstring required

Connection status

write_policystring nullable

Source-of-truth write policy: 'native' (RoboSystems is authoritative; no outbound write-back) or 'qb_authoritative' (QuickBooks is authoritative; RoboSystems-originated entries publish to QB). Set via the write-policy endpoint.

source_namestring nullable

External-provider registered source slug — the value the integration stamps on the events it emits. Null for platform providers.

metadataobject required

Provider-specific metadata

Changes

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