Integrations

Disconnect a connection

POST
/integrations/connections/{connection_id}/disconnect

Disconnect one of the caller's connections: revokes the provider authorization, pauses import sources that use it and detaches its webhook subscriptions. The connection stays listed until integrations.connections.delete.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Path Parameters

connection_id*string

Resource identifier: connection_id.

Formatuuid

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128
Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/integrations/connections/123e4567-e89b-42d3-a456-426614174000/disconnect" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000"
{  "id": "123e4567-e89b-42d3-a456-426614174000",  "provider_key": "klaviyo",  "auth_scheme": "example",  "label": "Customer documents",  "external_identity": "example",  "public_config": {},  "status": "ACTIVE",  "enabled": false,  "safe_error_code": "example",  "test_summary": {},  "provider_contract_digest": "example",  "last_tested_at": "example",  "created_at": "example",  "updated_at": "example",  "setup_required": false,  "offered_operations": [],  "scope": {}}