KintsugiKintsugi

Delete a connection

DELETE/connections/{conn_id}

Archive a connection: it stops appearing on every read immediately, and its transactions, products, and customers are archived on a best-effort basis (a partial failure is logged, not surfaced to you). Returns 404 if the connection does not exist, belongs to an organization your credential cannot access, or was already deleted; a second delete is not an idempotent no-op, so repeating it cannot be used to discover that the connection ever existed. A multi-org credential must send an Organization-Id, Connection-Id or Entity-Id selector, or gets a 400. Returns 409 with code connection_has_filed_history when the connection owns filed (locked) transaction history; contact support rather than retrying. Returns 503 if tearing down the connection's webhook subscription fails; retrying may succeed. A Saleor connection has its tax collection turned off before the archive. If the store still has Kintsugi's tax setup after that, the request returns 503; retrying may succeed.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

conn_idstringRequired

The unique identifier of the connection.

Response

204

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
DELETE /connections/{conn_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/connections/{conn_id}
Response
{
"code": "missing_target_selector",
"message": "Provide one of Organization-Id, Connection-Id, or Entity-Id.",
"requestId": "req_8f3k2mNpQr7Ls",
"errors": []
}
Delete a connection (2026-07-21) | Kintsugi API Reference