---
title: "Delete Connection"
method: DELETE
path: "/v1/graphs/{graph_id}/connections/{connection_id}"
tags: ["Connections"]
---

# Delete Connection

`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

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.

## Path parameters

- `graph_id` string, required
- `connection_id` string, 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 `200`

Successful Response

- SuccessResponse: Standard success response for operations without specific return data.
  - `success` boolean: Indicates the operation completed successfully
  - `message` string, required: Human-readable success message
  - `data` object, nullable: Optional additional data related to the operation

## Other responses

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

---

[API](https://skmtc.dev/robosystems/apis/robosystems-api.md) · [All operations](https://skmtc.dev/robosystems/apis/robosystems-api/llms.txt) · [OpenAPI document](https://skmtc.dev/robosystems/apis/robosystems-api/revisions/28ffd375c457?raw)