Проекты и ключи

Проект — единица тенантности castbase. В проекте живут:

  • каналы (подключённые аккаунты соцсетей);
  • медиа и посты;
  • сетка расписания (недельные слоты);
  • API-ключи;
  • тариф и лимиты (постов в месяц, каналов).

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

Создание проекта

Только в кабинете: «Создать проект» → название и часовой пояс (по умолчанию Europe/Moscow). Часовой пояс влияет на то, как читается publish_at без указания зоны и слоты сетки расписания. Через REST проекты не создаются: POST /v1/projects не существует, а ключ всегда привязан к уже созданному проекту.

Какой проект у вашего ключа — скажет GET /v1/project:

{
  "id": "01a1ab14-9628-7e3c-9a39-1d2f6f0c8b44",
  "name": "Мой бренд",
  "slug": "moy-brend",
  "timezone": "Europe/Moscow",
  "created_at": "2026-11-05T09:00:00+00:00"
}

API-ключи

Раздел «API-ключи» в проекте:

  1. «Выпустить ключ» — дайте ему имя (кто им пользуется).
  2. Скопируйте ключ: он показывается один раз. Рядом сразу показаны готовые строки подключения для Claude Code и Codex с подставленным ключом (подробнее).
  3. «Отозвать» — ключ перестаёт работать сразу. Отозванный ключ возвращает 401.

В списке видны префикс, дата создания и время последнего использования: по нему легко найти забытые ключи.

Лимиты проекта

Лимиты тарифа действуют на проект: число постов в месяц и число каналов. Текущий расход — GET /v1/usage, подробности — в разделе Лимиты.