---
title: "Disconnect a connected account"
method: DELETE
path: "/v1/integrations/installations/{installation_id}"
tags: ["integrations"]
---

# Disconnect a connected account

`DELETE /v1/integrations/installations/{installation_id}`

Disconnect the account and stop its syncs. The store and what is already in it remain.

The provider grant is revoked as well: always for Slack, and for Google unless another
installation of the same Google account was authorized through the same OAuth client.

## Path parameters

- `installation_id` string, uuid, required — Installation ID, as returned when the account connected

## Response `200`

The disconnected account

- ConnectorInstallationResponse — Response containing one connected account.
  - `data` ConnectorInstallation, required — A connected account and the store it feeds, described the same way for every connector.
    - `installation_id` string, required — Installation ID
    - `provider` 'google_drive' | 'gmail' | 'slack' | 'granola', required — Connector provider
    - `status` string, required — Installation status
    - `account` ConnectorAccount, required — The third-party account an installation is authorized as.
      - `id` string, required — Provider-side account identifier (email, user ID, or team ID)
      - `name` string, nullable — Human-readable account name
      - `email` string, nullable — Account email, when the provider exposes one
      - `workspace` string, nullable — Workspace or organization the account belongs to, for providers that have one
    - `store_id` string, nullable — Store the installation ingests into
    - `store_name` string, nullable — Name of that store
    - `sync` ConnectorInstallationSync — Account-level sync facts: how many resources are in error, and the last failure of an account-wide job.
      - `failed_resource_count` integer — Resources whose last sync job failed
      - `last_error` string, nullable — Last failure of a job covering the whole account, such as a changes sync
      - `last_error_operation` string, nullable — Which account-wide job failed
      - `last_error_at` string, date-time, nullable — When it failed

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-07** `1a6549d3e64d` — 1 info
  - added the optional property `data/sync` to the response with the `200` status
- **2026-09-05** `ea8d85b8caca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/installations/:installation_id/delete.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/9c6c72afde2d?raw)