Connections

Delete Connection

Removes the connection and revokes credentials. Imported data is preserved in the graph. Requires admin role. disposition=sever (QuickBooks only) is the cutover to native books: the chart QuickBooks created becomes the tenant's own and QuickBooks can never resume over it; the default disconnect keeps the connection reconnectable.

delete/v1/graphs/{graph_id}/connections/{connection_id}

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

Path parameters

graph_idstring required
connection_idstring required

Connection identifier

Query parameters

disposition'disconnect' | 'sever'

disconnect (default): soft-delete; a later re-OAuth to the same realm revives the connection. sever: the native-accounting cutover — QuickBooks only; the chart it created is stamped native-owned, write_policy drops to native, and the connection is never revived.

Response

Successful Response

successboolean

Indicates the operation completed successfully

messagestring required

Human-readable success message

dataobject nullable

Optional additional data related to the operation

Example response

{
  "data": {
    "deleted_count": 1
  },
  "message": "Resource deleted successfully",
  "success": true
}

Changes

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