Перейти к содержимому

Обзор API

Всё, что можно сделать в приложении, доступно через REST, включая создание и запуск ботов. Агент может через тот же API создавать других агентов.

Каждый ресурс находится внутри своего рабочего пространства:

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 ничего не раскрывает.