---
title: "🔒 Удаление сообщения из чата автором или администратором."
method: GET
path: "/chat/message/delete"
tags: ["Chat: Messages"]
---

# 🔒 Удаление сообщения из чата автором или администратором.

`GET /chat/message/delete`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/chat/message/delete`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

Удаление сообщения из чата автором или администратором.

**Access:** `authorized` (10 ) · **allowNullCompany:** true · **Scope:** `write`

**Allows:** `chat:message-delete` (все обязательны; ресурс — `<тип>ID` / `ID` из запроса, `user:*` — `userID` или сам пользователь)

### TypeScript (copy-paste)

**`GET /chat/message/delete`**

<details open><summary><b>Params</b></summary>

```typescript
export interface ChatMessageDeleteParams {
  ID: string
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type ChatMessageDeleteResponse = IServerResponse<ChatMessage>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Query parameters

- `ID` string, uuid, required

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Response `200`

OK — `IServerResponse<ChatMessage>`

- object
  - `code` integer, required
  - `data` ChatMessage, required: Entity `ChatMessage` (table: ChatMessage )
    - `chatID` string, uuid, required
    - `ID` string, uuid, required
    - `authorUID` string, uuid, required
    - `authorType` 'user' | 'agent' | 'system', required: `User` = "user", `Agent` = "agent", `System` = "system"
    - `type` 'regular' | 'event' | 'template', required: `Regular` = "regular", `Event` = "event", `Template` = "template"
    - `text` string, required
    - `attachments` unknown[], nullable
      - unknown
    - `dayKey` integer, required: Day key (YYYYMMDD or internal day index)
    - `dt` string, date-time, required
    - `editedDT` string, date-time, nullable
    - `replied` object, nullable
      - `ID` string, uuid, required
      - `text` string, required
      - `authorUID` string, uuid, required
      - `attachmentFID` string, uuid, nullable
      - `attachmentCount` integer, nullable
    - `mentioned` object, nullable
    - `reactions` object, nullable
    - `viewed` object, nullable
    - `meta` object, nullable
      - `apiTokenID` string, uuid, nullable
      - `event` object, nullable
        - `type` 'chat_title_changed' | 'chat_logo_changed' | 'chat_member_added' | 'chat_member_removed' | 'chat_member_joined' | 'chat_member_left', required: `ChatTitleChanged` = "chat_title_changed", `ChatLogoChanged` = "chat_logo_changed", `ChatMemberAdded` = "chat_member_added", `ChatMemberRemoved` = "chat_member_removed", `ChatMemberJoined` = "chat_member_joined", `ChatMemberLeft` = "chat_member_left"
        - `newTitle` string, nullable
        - `targetUID` string, uuid, nullable
      - `forwarded` object, nullable
        - `chatID` string, uuid, required
        - `messageID` string, uuid, nullable
        - `chatTitle` string, nullable
        - `chatLogoUrl` string, nullable
        - `authorUID` string, uuid, required
        - `dt` string, date-time, nullable
        - `entType` 'project' | 'product' | 'module' | 'component' | 'version' | 'feature' | 'task' | 'bug': `project` = "project", `product` = "product", `module` = "module", `component` = "component", `version` = "version", `feature` = "feature", `task` = "task", `bug` = "bug"
        - `productID` string, uuid, nullable
    - `isDeleted` boolean
    - `deletedTS` integer, nullable: Unix timestamp in milliseconds
    - `deletedUID` string, uuid, nullable
    - `updTS` integer, required: Unix timestamp in milliseconds
    - `updUID` string, required
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest / Validation — неверные params/body/headers
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed: Privilege chat:message-delete required (author or chat administrator)
- `404`: NotFound: Chat message with specified ID does not exist
- `406`: TimeResync — расхождение rts с сервером
- `422`: UnprocessableContent: Non-admin user cannot delete messages older than 60 minutes

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)