---
title: "Получить доступные чаты"
method: GET
path: "/api/v1/chat/conversations"
tags: ["Chat"]
---

# Получить доступные чаты

`GET /api/v1/chat/conversations`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/chat/conversations`
- 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`)

Возвращает чаты, доступные текущему пользователю.

## Query parameters

- `cursor` string
- `limit` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Страница чатов текущего участника

- ChatConversationPage
  - `items` ChatConversation[], required
    - `id` string, uuid, required
    - `type` 'direct' | 'group' | 'system', required
    - `status` 'active' | 'archived', required
    - `title` string, required
    - `description` string, required
    - `last_seq` integer, required
    - `last_message_id` string, uuid, required
    - `preview` ChatMessage
      - `id` string, uuid, required
      - `conversation_id` string, uuid, required
      - `seq` integer, required
      - `sender_user_id` integer, nullable, required
      - `kind` 'text' | 'system' | 'application' | 'file', required
      - `body` string, required
      - `mentions` ChatMessageMention[], required
        - `user_id` integer, required
        - `display_name` string, required
      - `client_message_id` string, uuid, required
      - `created_at` string, date-time, required
      - `attachments` ChatAttachment[], required
        - `id` string, uuid, required
        - `original_name` string, required
        - `content_type` 'audio/mp4' | 'audio/webm' | 'audio/ogg' | 'video/mp4' | 'video/quicktime', required
        - `size_bytes` integer, required
        - `sha256_hex` string, required
        - `media_kind` 'voice' | 'video_circle', required
        - `duration_ms` integer, required
        - `content_url` string, required
      - `reply_to_message_id` string, uuid, nullable
      - `forwarded_from_message_id` string, uuid, nullable: Пересланное: исходное сообщение. Нет у обычных сообщений
      - `forwarded_from_user_id` integer: Пересланное: автор оригинала — участник кабинета (ERP-1964, «Переслано от …»). При пересылке пересланного — тот, кто написал первым. Нет у обычных и у старых пересланных сообщений
      - `forwarded_from_name` string: Пересланное: подпись автора оригинала, когда участника нет в справочнике людей, — имя под ответом поддержки или название исходной беседы. Нет у обычных и у старых пересланных сообщений
      - `reply_quote` string: Цитата части исходного сообщения; поля нет, когда ответ на сообщение целиком, исходное удалено или недоступно
      - `deleted_at` string, date-time, nullable: Надгробие: сообщение удалено у всех. Тела, вложений, упоминаний и реакций у него нет; показывать его в ленте не нужно
    - `last_message_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `capabilities` ChatConversationCapabilities
      - `canRead` boolean, required
      - `canWrite` boolean, required
      - `canManageMembers` boolean, required
      - `canUpload` boolean, required
      - `canReact` boolean, required
      - `canPin` boolean, required
      - `canMarkRead` boolean, required
      - `canMarkUnread` boolean, required
      - `canMention` boolean, required
      - `canSetNotificationMode` boolean, required
      - `canSendVoice` boolean: Можно записать голосовое или видеокружок и переслать такое сюда. В чатах задач и поддержки — нет: там только текст, файлы и снимки экрана
    - `unread_count` integer, required
    - `first_unread_seq` integer, nullable, required
    - `manual_unread_seq` integer, nullable, required
    - `notification_mode` string, required
    - `notification_muted_until` string, date-time, nullable: До какого момента беседа молчит, если звук выключен на время: пока срок не вышел, notification_mode = muted. После срока поле пустое, а режим снова прежний
    - `notification_mode_after_mute` 'all' | 'mentions' | 'null', nullable: Какой режим вернётся, когда выйдет срок «без звука»; есть только пока срок идёт. По нему «Включить звук» возвращает прежний выбор
    - `mention_count` integer, required
    - `origin` string
    - `origin_ref` string, uuid
    - `last_read_seq` integer
    - `others_read_seq` integer
    - `has_avatar` boolean
    - `avatar_url` string
    - `peer_user_id` integer, nullable
    - `peer_avatar_url` string
  - `next_cursor` string

## Other responses

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

---

[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)