Connections

Disconnect

Revokes a connection and deletes the credential on our side.

DELETE
/v1/connections/{id}

Disconnects the marketplace account: the connection becomes revoked with revokedReason: "client", and we delete the credential on our side. The response is 204, with no body.

We do not revoke the authorization the seller gave at the marketplace: it stays in their account there until they remove the access at the marketplace itself. We only stop using the connection and delete the credential.

Repeating the request on a connection already revoked also returns 204. To come back, the seller connects again through a new link session.

A seller with an active connection cannot be deleted. Disconnect their connections before calling DELETE /v1/sellers/{id}.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

id*string

Identifier of the resource, as returned by the API.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

The connection is revoked and its credential was deleted on our side. Repeating the call on a revoked connection also returns 204. No body.

curl -X DELETE "https://example.com/v1/connections/3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01"
Empty