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

# Delete Instance

> Delete a WhatsApp instance from your Wachat account. The instance must be logged out before deletion. If the instance is still connected, this endpoint returns 409 Conflict.



## OpenAPI

````yaml DELETE /instance/delete
openapi: 3.0.3
info:
  title: Wachat Enterprise API
  description: >
    Welcome to the official Wachat API reference. Wachat provides
    developer-friendly, ultra-reliable infrastructure to scale your WhatsApp
    communications programmatically.


    Easily deploy automated messaging pipelines, orchestrate interactive
    customer engagement patterns, verify phone numbers instantly, and control
    containerized WhatsApp instances via a secure, production-grade REST
    architecture.
  version: 1.0.0
servers:
  - url: https://app.wachat.net/api/v1
    description: Live Production Gateway
security:
  - bearerAuth: []
paths:
  /instance/delete:
    delete:
      tags:
        - Session Lifecycle Infrastructure
      summary: Delete WhatsApp Instance
      description: >-
        Delete a WhatsApp instance from your Wachat account. The instance must
        be logged out before deletion. If the instance is still connected, this
        endpoint returns 409 Conflict.
      parameters:
        - in: query
          name: instanceName
          required: true
          schema:
            type: string
          description: Final unique instance name returned by Wachat.
          example: t1_mq9r2jov_jakarta_store
      responses:
        '200':
          description: Instance deleted successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Instance deleted successfully.
                  instance:
                    type: object
                    properties:
                      id:
                        type: integer
                        example: 26
                      instanceName:
                        type: string
                        example: t1_mq9r2jov_jakarta_store
                      displayName:
                        type: string
                        nullable: true
                        example: jakarta_store
                  connectionState:
                    type: string
                    description: Last connection state detected before deletion.
                    example: close
                  instanceDeleted:
                    type: boolean
                    description: Whether the instance delete request succeeded.
                    example: true
                  instanceMissing:
                    type: boolean
                    description: >-
                      True when the instance was already missing from the Wachat
                      API.
                    example: false
        '400':
          description: Missing instanceName query parameter or unsupported integration.
        '401':
          description: Missing or invalid API key.
        '403':
          description: Subscription restriction prevented instance deletion.
        '404':
          description: Instance not found for this API key.
        '409':
          description: Instance is still connected or not safely logged out.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Instance must be logged out before deletion.
                  reason:
                    type: string
                    example: instance_still_connected
                  connectionState:
                    type: string
                    example: open
        '502':
          description: Could not verify state or delete the instance.
        '504':
          description: Wachat API request timed out.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authenticate your integration payloads by injecting your premium secure
        Wachat Account API Private Secret Key inside standard Authorization
        Bearer header vectors.

````