Skip to main content
DELETE
/
connections
/
{connection_id}
Disconnect and remove a connection
curl --request DELETE \
  --url https://api-sandbox.ledgersyncappv2.com/v3/connections/{connection_id} \
  --header 'Authorization: Bearer <token>'
{
  "error": {
    "code": "unknown_api_key",
    "message": "The API key you presented doesn't match any active key.",
    "type": "auth_error",
    "doc_url": "https://portal.ledgersyncappv2.com/errors/unknown_api_key",
    "category": "AUTH_ERROR",
    "is_user_actionable": true,
    "source_diagnostic_code": "FIN-103",
    "param": "client.email",
    "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
    "errors": [
      {
        "param": "client.email",
        "message": "must be a valid email address",
        "code": "invalid_email"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Pass your secret key in the Authorization header as a Bearer token: Authorization: Bearer sk_test_... (sandbox) or Bearer sk_live_... (production).

Keys are created in the developer portal and the plaintext secret is shown exactly once at creation. Treat them like passwords — never embed them in mobile apps or front-end code.

Path Parameters

connection_id
string
required

Canonical Connection id of the form con_<SOURCE>_<bankAccountId> (e.g. con_FINICITY_41294, con_MX_1224, con_FDE_5009). Only the canonical shape is accepted here. The placeholder UUID id returned by POST /v3/clients/{id}/connections (con_<uuid>, e.g. con_01HXYZ8A6N7K2W9PQ4T5Z3V6E0) is not a valid value — calls with it return 400 with missing source separator. See the lifecycle prose at the top of this document for the full id-format contract.

Example:

"con_FINICITY_41294"

Response

Connection removed.