> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Disconnect a channel

> 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`.



## OpenAPI

````yaml /openapi.json delete /channels/{channelId}
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /channels/{channelId}:
    delete:
      tags:
        - Channels
      summary: Disconnect a channel
      description: >-
        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`.
      operationId: disconnect_channel
      parameters:
        - name: channelId
          in: path
          required: true
          description: >-
            Stored channel.id from list_channels or get_channel. Provider page,
            phone, account and WABA IDs are not this ID.
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
      responses:
        '200':
          description: Disconnect a channel
          content:
            application/json:
              schema:
                type: object
                properties:
                  disconnected:
                    type: boolean
                  channelId:
                    type: string
                additionalProperties: false
                required:
                  - disconnected
                  - channelId
        default:
          $ref: '#/components/responses/Error'
      security:
        - bearerAuth: []
components:
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.