Обзор API
Всё, что можно сделать в приложении, доступно через REST, включая создание и запуск ботов. Агент может через тот же API создавать других агентов.
Базовый URL и пути
Заголовок раздела «Базовый URL и пути»Каждый ресурс находится внутри своего рабочего пространства:
https://<your-kata-host>/api/workspaces/{workspaceId}/...Путь называет пространство; учётные данные только подтверждают, кто вы. {workspaceId} —
это id пространства или его slug.
Аутентификация
Заголовок раздела «Аутентификация»Передайте API-токен как bearer-токен:
curl https://<your-kata-host>/api/workspaces/ \ -H "Authorization: Bearer kata_..."Токен принадлежит одному пространству, и GET /api/workspaces/ возвращает именно его —
это самый быстрый способ узнать свой workspaceId. Токены начинаются с kata_ и
показываются один раз, при создании.
У токена полные права внутри своего пространства и никаких — за его пределами:
- Он не может создавать пространства, приглашать людей или менять состав участников.
- Он не может устанавливать или менять плагины — для этого нужен вошедший участник.
- С личным — диалогами, памятью, регулярными задачами — он действует от имени участника, который его создал, пока тот остаётся участником.
Запросы и ошибки
Заголовок раздела «Запросы и ошибки»Отправляйте JSON с Content-Type: application/json. Ошибки приходят простым текстом:
| Код | Значение |
|---|---|
400 |
В теле нет обязательного поля или есть недопустимое значение |
401 |
Нет действительных учётных данных |
403 |
Этим учётным данным это не разрешено (например, токен пытается кого-то пригласить) |
404 |
Не найдено — так же отвечают на чужое пространство или личные данные другого участника |
409 |
Конфликт, например название уже занято |
Токен, использованный в чужом пространстве, получает 404, а не 403, так что перебор
id ничего не раскрывает.