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

# Remove a device

> Remove a device slot from the server. This also logs it out of WhatsApp and clears its session and chat data. To log out while keeping the slot, use the logout endpoint instead.



## OpenAPI

````yaml /openapi.yml delete /devices/{device_id}
openapi: 3.0.0
info:
  title: WhatsApp API MultiDevice
  version: 9.7.0
  description: |
    This API is used for sending whatsapp via API.

    The web dashboard is a separate project (gowa-ui); the server downloads its
    latest release asset and serves it at `/` (or returns a JSON banner when
    APP_UI_ENABLED=false).

    Device scoping:
    - Send `X-Device-Id` on all device-scoped REST calls.
    - WebSocket: connect to `/ws?device_id=<id>`.
    - WebSocket auth (when basic auth is enabled): browsers cannot set an
      Authorization header on WebSocket connections, so also pass
      `&authorization=<base64(user:pass)>` in the query string. Use TLS in
      production since the credential is visible in the URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Initial Connection to Whatsapp server
  - name: device
    description: Device management for multi-device support
  - name: user
    description: Getting information
  - name: send
    description: Send Message (Text/Image/File/Video).
  - name: message
    description: Message manipulation (revoke/react/update).
  - name: call
    description: Call management (reject incoming calls)
  - name: chat
    description: Chat conversations and messaging
  - name: group
    description: Group setting
  - name: newsletter
    description: newsletter setting
  - name: chatwoot
    description: Chatwoot integration for customer support
paths:
  /devices/{device_id}:
    delete:
      tags:
        - device
      summary: Remove a device
      description: >-
        Remove a device slot from the server. This also logs it out of WhatsApp
        and clears its session and chat data. To log out while keeping the slot,
        use the logout endpoint instead.
      operationId: removeDevice
      parameters:
        - name: device_id
          in: path
          required: true
          schema:
            type: string
          description: Device ID
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
        '404':
          description: Device not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  schemas:
    GenericResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: string
          example: null
    ErrorNotFound:
      type: object
      properties:
        code:
          type: string
          example: 404
          description: HTTP Status Code
        message:
          type: string
          example: Chat not found
          description: Detail error message
        results:
          type: object
          example: null
          description: additional data
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: Detail error message
        results:
          type: object
          example: null
          description: additional data
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Remove participants from group](https://gowa-docs.mintlify.site/api-reference/group/remove-participants-from-group.md)
- [Logout device](https://gowa-docs.mintlify.site/api-reference/device/logout-device.md)
- [Delete a device's Chatwoot config](https://gowa-docs.mintlify.site/api-reference/chatwoot/delete-a-devices-chatwoot-config.md)
- [Logout the active device (keeps the device slot)](https://gowa-docs.mintlify.site/api-reference/app/logout-the-active-device-keeps-the-device-slot.md)
- [Set group topic](https://gowa-docs.mintlify.site/api-reference/group/set-group-topic.md)


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