# GET /api/v1/mentoring/sessions

Встречи с ментором.

| Поле | Значение |
| --- | --- |
| URL | `GET https://aos.edgelab.space/api/v1/mentoring/sessions` |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | `mentoring:read` |
| operationId | `mentoringSessions` |

## Описание

Встречи с ментором. Параметры `limit?`, `cursor?`. Детали элемента: `startsAt`, `kind` (`call` или `consultation`), `durationSeconds` (или null), `status`, `summary`, `transcriptStatus` и nullable `trackVersionId`. Если есть, приходят также `title` (название встречи, 1–120 символов), `brief` (короткое описание, 1–400 символов), `hostName` (имя ведущего, 1–64 символа) и `recordingUrl` (ссылка на запись, HTTPS, только `kinescope.io`); если их нет, поля отсутствуют.

**Лимиты:** API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

```bash
curl -sS "https://aos.edgelab.space/api/v1/mentoring/sessions?limit=20" \
  -H "Authorization: Bearer $AOS_API_KEY"
```

## Параметры

| Имя | Где | Обязательно | Тип и ограничения |
| --- | --- | --- | --- |
| `cursor` | query | нет | `string`, длина ≤ 2048 |
| `limit` | query | нет | `integer`, 1–100 |

## Ответы по контракту

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [MentoringSessions](/docs/schemas#mentoringsessions) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED, INSUFFICIENT_SCOPE, MENTORING_NOT_AVAILABLE, NOT_FOUND, VALIDATION_FAILED |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `mentoringSessions`.
