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

# Пространства и минуты

> Где лежат записи, откуда списываются минуты и как проверить права.

Пространство объединяет записи, участников и тариф. У каждого аккаунта есть личное пространство. Командные появляются, когда вас приглашают коллеги. Почти все запросы к записям содержат `space_id`.

## Найти space\_id

```bash theme={null}
curl "https://api.aigenda.tech/api/spaces/?limit=50&offset=0" \
  -H "Authorization: Bearer <access>"
```

```json Ответ 200 (основные поля) theme={null}
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "is_main_space": true,
      "space": {
        "id": 1024,
        "name": "Личное пространство",
        "description": "Main space",
        "subscribe": {
          "offer": { "name": "PRO", "audio_limit": 72000 },
          "usage_count": 5400,
          "available_usage_count": 66600,
          "is_active": true,
          "end_date": "2026-11-17T00:00:00Z"
        }
      }
    },
    {
      "is_main_space": false,
      "space": { "id": 2048, "name": "Отдел продаж", "description": "Записи звонков с клиентами" }
    }
  ]
}
```

Личное пространство отмечено `is_main_space: true`. Его `space.id` и есть `space_id`.

## Минуты

Тариф и остаток лежат в `space.subscribe`. Все значения в **секундах**.

| Поле | Что значит |
| - | - |
| `offer.name` | Название тарифа |
| `offer.audio_limit` | Сколько секунд даёт тариф за период |
| `usage_count` | Сколько уже потрачено |
| `available_usage_count` | Сколько осталось |
| `end_date` | Когда закончится период |

Свежий остаток конкретного пространства отдаёт [`GET /api/spaces/{space_id}/`](/api-reference/spaces/get).

**Когда списываются минуты.** В момент запуска обработки, ровно на длительность записи в целых секундах (запись 71,8 с спишет 71 с). Загрузка без обработки минут не тратит. Если обработка упала, минуты вернутся сами через пару минут.

<Warning>
  Перед загрузкой проверьте, что остатка хватает на всю запись с запасом 5 минут. Запись длиннее остатка AiGenda не обработает.
</Warning>

## Права

В командном пространстве у вас может не быть права загружать записи. Проверьте его заранее:

```bash theme={null}
curl "https://api.aigenda.tech/api/spaces/1024/my_rights/" \
  -H "Authorization: Bearer <access>"
```

Загружать записи можно, если в ответе `write_access: true`. Полный список полей: [Права в пространстве](/api-reference/spaces/rights).

## Постраничный вывод

Списки (пространства, записи, корзина) отдаются страницами. Управляйте ими параметрами `limit` и `offset`. Ссылки `next` и `previous` в ответе приходят со схемой `http://`, поэтому собирайте адрес следующей страницы сами: `offset = offset + limit`, пока `offset < count`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.