integrations
Disconnect
Disconnect the account connected by the requesting user.
Marks the stored installation revoked, and best-effort asks the
provider to kill the token on its own side via
integration.revoke_remote. That call is wrapped here too, on top
of each adapter’s own best-effort handling — a third-party
integration that doesn’t honor the “never raise” contract on
revoke_remote still must not block the local disconnect.
Path Parameters
- provider (str): Key of a registered OAuth provider (see GET /api/v1/integrations/status).
Query Parameters
- account_id (Optional[str]): Connection to use (from GET /api/v1/integrations/{provider}/connections); the newest one is used when omitted. An id that is not the caller’s returns 404 and never falls back to another connection; a blank id returns 422.
- delete_data (bool): When true, the integration’s dataset is deleted after the connection is revoked. A provider that exposes no deletable dataset returns 400 before anything is revoked; a deletion that fails after the disconnect returns 502, unless the deletion itself answered with an HTTP error, whose status is kept. Ignored when account_id is omitted and the caller has no connection. Defaults to False.
DELETE
Disconnect
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Successful Response