Skip to main content
DELETE
Disconnect an accounting integration
Deactivates one accounting connection. This is a soft-disconnect: the row stays in place with is_active set to false and still appears in List Accounting Connections with is_active: false; only active connections take part in the sync sweep. Nothing already posted to the accounting provider is touched. Reconnecting the same provider later — through Initiate Accounting OAuth for QuickBooks and Xero, or Connect Token-Based Accounting Provider for NetSuite and Tally — finds this row, refreshes its credentials, resets sync_status to idle, clears last_error, and reactivates it, so the connection id is stable across a disconnect/reconnect. The connection must belong to the calling workspace; a connection owned by another workspace is reported as not found rather than forbidden.

Path Parameters

Example Request

Response

The response is a bare status object, not a {data} envelope.

Errors

Errors use the standard envelope — see Errors.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Path Parameters

id
string<uuid>
required

Response

Connection removed.

status
string
Allowed value: "disconnected"