---
title: "Reconnect a Slack installation of a customer-provided app"
method: POST
path: "/v1/integrations/slack/installations/{installation_id}/reconnect"
tags: ["integrations"]
---

# Reconnect a Slack installation of a customer-provided app

`POST /v1/integrations/slack/installations/{installation_id}/reconnect`

Replace a Slack installation's tokens, keeping its store.

The tokens must belong to the Slack user, or for a workspace bot the workspace, already connected to the
installation.

## Path parameters

- `installation_id` string, uuid, required — Slack installation ID

## Request body

- SlackManualReconnectBody — Request body for reconnecting a Slack installation of a customer-provided app with fresh tokens.
  - `bot_token` string, required — Slack bot user OAuth token (xoxb-…)
  - `user_token` string, nullable — Slack user OAuth token (xoxp-…), required for a personal installation
  - `signing_secret` string, required — Slack app signing secret

## Response `200`

The reconnected Slack installation

- IntegrationInstallationResponse — Integration installation response.
  - `data` IntegrationInstallation, required — Service-level representation of an installed provider integration.
    - `id` string, required — The integration installation ID
    - `created_at` string, date-time, required — The creation time
    - `updated_at` string, date-time, required — The last update time
    - `organization_id` string, required — The organization ID
    - `provider` string, required — The integration provider identifier
    - `external_account_id` string, required — The provider workspace/account ID
    - `external_account_name` string, nullable, required — The provider workspace/account name
    - `installed_by_user_id` string, nullable, required — The Mixedbread user who installed the provider
    - `status` string, required — The installation status
    - `scopes` string[], nullable, required — Granted provider scopes
    - `metadata` object, required — Provider-specific metadata

## Other responses

- `404` — No installation of this provider with this id in the organization
- `422` — The request failed validation, or the credentials it carries were rejected or belong to a different account than the installation's

## Changes

- **2026-09-26** `9c6c72afde2d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/slack/installations/:installation_id/reconnect/post.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)