---
title: "Delete a message"
method: DELETE
path: "/messenger/v1/messages/{id}"
tags: ["messages"]
---

# Delete a message

`DELETE /messenger/v1/messages/{id}`

Deletes a single message from a chat. Only the message author or chat administrators can delete messages.

## Path parameters

- `id` string, required

## Response `200`

The deleted message

- MessageResponseDto
  - `id` string — Message id
  - `timestamp` number — Timestamp of message
  - `message` string, required — Message text
  - `type` 'MESSAGE' | 'AUDIO' | 'VIDEO' | 'GIF' | 'SYSTEM' — Message type
  - `chatId` string, required — Chat id
  - `readBy` number[] — Members ids
  - `externalLine` ExternalLineResponseDto, required
    - `id` string, required — External line id
    - `name` string, required — External line name
    - `icon` string, required — External line icon
    - `externalId` string, required — External line external id
    - `timestamp` number, required — External line timestamp
    - `portal` string, required — External line portal
    - `phoneNumber` string, required — External line phone number
  - `attachedFiles` AttachedFile[] — Attached files
    - `id` object, required — Attached file id
    - `entityId` string, required — Attached file entity id
    - `entityType` string, required — Attached file entity type
    - `lastModified` number, required — Attached file created date
    - `originalFilename` string, required — Attached file original filename
    - `size` string, required — Attached file size
    - `url` string, required — Attached file url
  - `relations` MessageRelation[] — Relations
    - `action` 'create' | 'update' | 'delete', required — Action
    - `service` 'crm', required — Service
    - `entity` 'lead' | 'contact' | 'deal', required — Entity
    - `name` string, required — Entity id
    - `pictureUrl` string, required — Entity picture url
    - `entityId` string, required — Entity id
  - `externalAuthorId` string — External author id
  - `externalId` string — External id
  - `ref` Reference
    - `chatId` string, required — Chat id
    - `authorId` number, required — Author id
    - `messageId` string, required — Message id
  - `meta` MessageMeta
    - `entity` string, required — Entity name
    - `type` string, required — Entity type
    - `accountName` string, required — Account name
    - `accountImage` string, required — Account image url
    - `body` MetaBody[], required — Body entity
      - `text` string, required — Text post or stories or whatever
      - `attachedFiles` string[], required — Attached files url
      - `url` string, required — Post or stories url

---

[API](https://skmtc.net/uspacy/apis/messenger-service-2.md) · [All operations](https://skmtc.net/uspacy/apis/messenger-service-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uspacy/messenger-service-2/versions/699626a9e425/schema)