Set Connection Write Policy

put/v1/graphs/{graph_id}/connections/{connection_id}/write-policy

Opt a connection into or out of outbound write-back. 'qb_authoritative' makes QuickBooks the source of truth — RoboSystems-originated entries (manual JEs, schedule drafts) publish to QuickBooks when executed or at close. 'native' keeps RoboSystems authoritative with no write-back. This is the explicit operator opt-in for writing to your books of record.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`graph_id`required	string	Graph Id
`connection_id`required	string	Unique connection identifier

Request body

Required, application/json.

Field Type Description

Field	Type	Description
`write_policy`required	string	'native' = RoboSystems authoritative, no write-back; 'qb_authoritative' = QuickBooks authoritative, entries publish to QB. One of: `native`, `qb_authoritative`

write_policyrequired

string

'native' = RoboSystems authoritative, no write-back; 'qb_authoritative' = QuickBooks authoritative, entries publish to QB.

One of: native, qb_authoritative

Example request

curl

curl -X PUT "https://api.robosystems.ai/v1/graphs/{graph_id}/connections/{connection_id}/write-policy" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "write_policy": "native"
}'

Responses

200 Successful Response

Field	Type	Description
`connection_id`required	string	Unique connection identifier
`provider`required	string	Connection provider type
`entity_id`optional	string	Entity identifier
`status`required	string	Connection status
`created_at`required	string (date-time) \| string	Creation timestamp
`updated_at`optional	string (date-time) \| string	Last update timestamp
`last_sync`optional	string (date-time) \| string	Last sync timestamp
`write_policy`optional	string	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_name`optional	string	External-provider registered source slug — the value the integration stamps on the events it emits. Null for platform providers.
`metadata`required	object	Provider-specific metadata

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error