Файлы группы

Метод и конечная точка

GET /groups.files

Описание

Возвращает список файлов, загруженных в приватную группу.

Параметры

Перечень параметров представлен в таблице.

Название	Обязательный	Тип данных	Описание
roomId	нет*	string	Идентификатор группы
roomName	нет*	string	Название группы
offset	нет	number	Смещение для пагинации
count	нет	number	Количество результатов на страницу
sort	нет	string	Поле для сортировки
fields	нет	string	JSON-строка с полями для включения
query	нет	string	JSON-строка с условиями фильтрации

* Должен быть указан один из параметров: roomId или roomName.

Запрос

curl -X 'GET' \
  'https://im-<ENV>.<DEFAULT_DOMAIN>/api/v1/groups.files?roomId=<ROOM_ID>&offset=0&count=20' \
  -H 'accept: application/json' \
  -H 'X-User-Id: <USER_ID>' \
  -H 'x-auth-token: <AUTH_TOKEN>'

Где:

• <ENV> — окружение, на котором выполняется запрос;
• <DEFAULT_DOMAIN> — домен сервера Squadus;
• <USER_ID> — идентификатор пользователя, от имени которого выполняется запрос;
• <AUTH_TOKEN> — токен аутентификации пользователя;
• <ROOM_ID> — идентификатор группы.

Ответ

200 — Successfully get private channel files — Список файлов. Пример вывода:

{
  "success": true,
  "count": 3,
  "offset": 0,
  "total": 3,
  "files": [
    {
      "_id": "file456",
      "name": "report.docx",
      "size": 2048000,
      "type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "userId": "7w9BMr9r78W4RNe8x",
      "uploadedAt": "2026-06-24T10:00:00.000Z",
      "url": "/file-upload/file456/report.docx"
    }
  ]
}