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

> Deletes the message.

# Delete Message

For the complete error reference, see [Error Guide](/articles/error-guide).


## OpenAPI

````yaml delete /messages/{id}
openapi: 3.0.0
info:
  title: Chat APIs
  description: Manage messages, users, groups for a particular app using our Chat API.
  version: '3.0'
servers:
  - url: https://{appId}.api-{region}.cometchat.io/v3
    variables:
      appId:
        default: appId
        description: (Required) App ID
      region:
        enum:
          - us
          - eu
          - in
        default: us
        description: Select Region
security: []
tags:
  - name: API Keys
    description: The API keys are used to authorise the APIs
  - name: Roles
    description: The roles are used to give user access rights
  - name: Users
    description: The REST collection for users.
  - name: Auth Tokens
    description: The auth tokens are used to login end users using client SDKs.
  - name: Blocked Users
    description: The REST collections for blocked users.
  - name: Friends
    description: List,add and remove friends by passing UID in path variables
  - name: Groups
    description: The REST collections for groups.
  - name: Banned Users
    description: Ban and Unban user by passing other UID in path variables.
  - name: Group Members
    description: The REST collections for group members.
  - name: Messages
    description: The REST collections for messages.
  - name: Conversations
    description: The REST collections for conversations.
  - name: Restrict Features
    description: Allows Restricting Features
  - name: Metrics
    description: Allows accessing Data Metrics
  - name: Triggers
    description: Allows adding triggers to a webhook.
  - name: Webhooks
    description: Allows accessing Webhooks.
  - name: Notifications
    description: Allows configuring Notifications core.
paths:
  /messages/{id}:
    delete:
      tags:
        - Messages
      summary: Delete Message
      description: Deletes the message.
      operationId: delete-message
      parameters:
        - $ref: '#/components/parameters/onBehalfOf'
        - name: id
          in: path
          description: Id of the message whose details are to be deleted.
          required: true
          schema:
            type: string
          examples:
            string:
              summary: Message ID
              value: '100'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                permanent:
                  description: Deletes the message permanently.
                  type: boolean
              type: object
      responses:
        '200':
          description: Deleted Message
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                type: object
              example:
                data:
                  id: '402'
                  conversationId: cometchat-uid-1_user_cometchat-uid-2
                  sender: cometchat-uid-1
                  receiverType: user
                  receiver: cometchat-uid-2
                  category: action
                  type: message
                  data:
                    action: edited
                    entities:
                      by:
                        entity:
                          uid: cometchat-uid-1
                          name: Updated Name
                          status: offline
                          role: default
                          createdAt: 1639448370
                        entityType: user
                      for:
                        entity:
                          uid: cometchat-uid-2
                          name: George Alan
                          avatar: >-
                            https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-2.webp
                          status: offline
                          role: default
                          createdAt: 1639448370
                        entityType: user
                      'on':
                        entity:
                          id: '69'
                          conversationId: cometchat-uid-1_user_cometchat-uid-2
                          sender: cometchat-uid-1
                          receiverType: user
                          receiver: cometchat-uid-2
                          category: message
                          type: text
                          data:
                            text: hello spider
                            entities:
                              sender:
                                entity:
                                  uid: cometchat-uid-1
                                  name: Andrew Joseph
                                  role: default
                                  avatar: >-
                                    https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp
                                  status: offline
                                  createdAt: 1639448370
                                entityType: user
                              receiver:
                                entity:
                                  uid: cometchat-uid-2
                                  name: George Alan
                                  role: default
                                  avatar: >-
                                    https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-2.webp
                                  status: offline
                                  createdAt: 1639448370
                                  conversationId: cometchat-uid-1_user_cometchat-uid-2
                                entityType: user
                          sentAt: 1640171302
                          editedAt: 1641477338
                          editedBy: app_system
                          updatedAt: 1641477338
                          tags:
                            - t6
                        entityType: message
                  sentAt: 1641477338
                  updatedAt: 1641477338
      security:
        - apiKey: []
components:
  parameters:
    onBehalfOf:
      name: onBehalfOf
      in: header
      description: UID of the user on whose behalf the action is performed.
      schema:
        type: string
  securitySchemes:
    apiKey:
      type: apiKey
      description: API Key with fullAccess scope(i.e. Rest API Key from the Dashboard).
      name: apikey
      in: header

````