KintsugiKintsugi

Delete an unfinished apideck connection

DELETE/connections/apideck/{conn_id}

Remove a connection left over from a Vault flow that was cancelled or failed before activation. Only an inactive or connection_error Apideck connection that holds no data is removed, permanently: no archived row, note or audit entry is kept. Returns 409 if the connection is active (for example the activate call succeeded but its response was lost) or already holds data; nothing is changed, so it is safe to call again after a failed or uncertain activate. Returns 404 if the connection does not exist, is not an Apideck-backed connection, is archived, or belongs to an organization your credential cannot access. A multi-org credential must send an Organization-Id, Connection-Id or Entity-Id selector, or gets a 400. To disconnect a working connection, use DELETE /connections/{connId}.

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.

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