---
title: "Получить вложения доступного чата"
method: GET
path: "/api/v1/chat/conversations/{id}/attachments"
tags: ["Chat"]
---

# Получить вложения доступного чата

`GET /api/v1/chat/conversations/{id}/attachments`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/chat/conversations/{id}/attachments`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Указатель вложений беседы. Отдаются только вложения из видимой участнику части истории;
для этого нужна capability скачивания файлов, а не просто чтение чата. Удалённые сообщения
и вложения, снятые антивирусом, не возвращаются ни списком, ни поиском.
Страница идёт от свежих к старым; следующая берётся непрозрачным `cursor` из `next_cursor`.

## Query parameters

- `media_kind` string
- `q` string
- `cursor` string
- `limit` integer

## Response `200`

Вложения чата

- ChatAttachmentPage
  - `items` ChatForwardedAttachment[], required
    - `id` string, uuid, required
    - `conversation_id` string, uuid, required
    - `message_id` string, uuid, nullable, required
    - `original_name` string, required
    - `content_type` string, required
    - `size_bytes` integer, required
    - `sha256_hex` string, required
    - `media_kind` 'voice' | 'video_circle' | 'image' | 'video' | 'file', required
    - `duration_ms` integer, nullable, required
    - `waveform` integer[], required
    - `status` 'quarantined' | 'ready' | 'failed' | 'deleted', required
    - `scan_status` 'pending' | 'clean' | 'infected' | 'unavailable' | 'skipped', required
    - `scan_error_code` string
    - `created_at` string, date-time, required
    - `content_url` string, required
  - `has_more` boolean, required: Следующая страница доказана прочитанной строкой за границей текущей, а не тем, что страница оказалась полной.
  - `next_cursor` string: Курсор следующей страницы; присутствует только вместе с has_more=true.

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)
