---
title: "Disconnect a channel"
method: DELETE
path: "/channels/{channelId}"
tags: ["Channels"]
---

# Disconnect a channel

`DELETE /channels/{channelId}`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/channels/{channelId}`
- Auth: HTTP bearer

Use only for a requested disconnect of a discovered Instagram, Messenger, WhatsApp or TikTok channel. Reuses native local channel/binding removal and recovery; webchat disconnect is unsupported. Does not promise deletion of guest history or revocation of provider-wide OAuth grants. Repeating the same missing channel is a no-op; read list_channels after an uncertain result before reconnecting. A current business-admin-owned credential is required. Requires `channels:manage:write`.

## Path parameters

- `channelId` string, required

## Response `200`

Disconnect a channel

- object
  - `disconnected` boolean, required
  - `channelId` string, required

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)