> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exode.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Группа

> Структура объекта группы (group) в Exode API

Объект `group` описывает учебную или продуктовую группу: участников, правила доступа, расписание и настройки
коммуникаций.

<Info>
  Списочный метод [`group/list/raw`](/ru/exode-api/school/group/list) возвращает компактную проекцию
  (`groupId`, `name`, `courseId`, `courseName`). Ниже описана полная публичная структура объекта `group`.
</Info>

## Поля `group`

### Основные

<ResponseField name="id" type="integer" required>ID группы.</ResponseField>
<ResponseField name="uuid" type="string" required>UUID группы.</ResponseField>
<ResponseField name="name" type="string" required>Название группы.</ResponseField>
<ResponseField name="space" type="enum" required>Пространство группы: `Education`.</ResponseField>
<ResponseField name="order" type="integer | null">Порядок сортировки.</ResponseField>
<ResponseField name="maxMembers" type="integer | null">Максимальное число участников.</ResponseField>

### Ограничения и настройки

<ResponseField name="communication" type="object" required>
  Настройки коммуникаций (Telegram-канал, групповой чат, режимы подключения).
</ResponseField>

<ResponseField name="accessLimitation" type="object" required>
  Ограничения доступа: тип старта, общая дата старта, длительность и т.п.
</ResponseField>

<ResponseField name="scheduleLimitation" type="object" required>
  Ограничения по расписанию (окна доступа по дням/часам, ограничения по датам).
</ResponseField>

<ResponseField name="contentLimitation" type="object" required>
  Ограничения по контенту (правила доступа к урокам, зависимости от заданий).
</ResponseField>

### Telegram

<ResponseField name="isTgConnected" type="boolean | null">Есть ли активная связь группы с Telegram.</ResponseField>

<ResponseField name="tgConnectionMode" type="enum | null">
  Режим подключения Telegram: `Disconnected`, `Connected`, `Required`.
</ResponseField>

### Системные поля аудита

<ResponseField name="createdAt" type="string" required>Дата создания (ISO 8601).</ResponseField>
<ResponseField name="updatedAt" type="string" required>Дата обновления (ISO 8601).</ResponseField>
<ResponseField name="archivedAt" type="string | null">Дата архивации или `null`.</ResponseField>

## Пример объекта `group`

```json theme={null}
{
  "id": 101,
  "uuid": "8b8b2b0e-6a27-4c3c-b5a5-9f4f0e3f1c01",
  "name": "Группа 7А — Математика",
  "space": "Education",
  "order": 10,
  "maxMembers": 30,
  "isTgConnected": false,
  "tgConnectionMode": "Disconnected",
  "createdAt": "2025-01-10T09:00:00Z",
  "updatedAt": "2025-01-15T12:30:00Z",
  "archivedAt": null,
  "communication": {
    "tgChannelId": null,
    "tgGroupChatId": null
  },
  "accessLimitation": {
    "active": true,
    "startPointType": "CommonDate"
  },
  "scheduleLimitation": {
    "active": false
  },
  "contentLimitation": {
    "active": false
  }
}
```

## Связанные объекты

* Участники группы — объекты [`groupMember`](./group-member).