Delete Connection
delete
/v1/graphs/{graph_id}/connections/{connection_id}Part of Connections.
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.
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Path parameters
| Name | Type | Description |
|---|---|---|
graph_idrequired | string | Graph Id |
connection_idrequired | string | Connection identifier |
Query parameters
| Name | Type | Description |
|---|---|---|
dispositionoptional | string | `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. One of: Default: |
Example request
curl
curl -X DELETE "https://api.robosystems.ai/v1/graphs/{graph_id}/connections/{connection_id}" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY"Responses
200 Successful Response
| Field | Type | Description |
|---|---|---|
successoptional | boolean | Indicates the operation completed successfully Default: |
messagerequired | string | Human-readable success message |
dataoptional | object | Optional additional data related to the operation |
| 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 |