Теги баз знаний рабочего пространства: список, создание, переименование, удаление, привязка к базе знаний и отвязка. Теги базы знаний приходят в её поле tags, а список баз знаний можно отфильтровать по тегам — параметром tag_id списка баз знаний.

Объект Tag

Поле	Тип	Описание
`id`	string	Идентификатор тега
`name`	string	Название, от 1 до 50 символов
`knowledge_base_count`	integer	Сколько баз знаний отмечено тегом

Список тегов

GET /v1/tags

200 — все теги баз знаний пространства, без разбиения на страницы:

{
  "items": [
    {"id": "9e4a1c6b-2d85-4f37-a0b9-6c3e8d1f5a20", "name": "Юридический отдел", "knowledge_base_count": 3}
  ]
}

Создание тега

POST /v1/tags

Тело запроса

Поле	Тип	Обязательное	Описание
`name`	string	да	Название, от 1 до 50 символов, уникальное в пространстве

Ответ

201 — объект Tag.

Переименование тега

PATCH /v1/tags/{tag_id}

Тело запроса

Поле	Тип	Описание
`name`	string	Новое название, от 1 до 50 символов

Ответ

200 — объект Tag.

Удаление тега

DELETE /v1/tags/{tag_id}

204 — без тела. Если тега нет, ответ тоже 204.

Привязка тега к базе знаний

PUT /v1/knowledge-bases/{knowledge_base_id}/tags/{tag_id}

204 — без тела. Повторная привязка ничего не меняет.

curl -X PUT https://api.evo-ai.ru/v1/knowledge-bases/3a9d5e27-8c14-4b6f-a0e2-7d1c9b5f3e82/tags/9e4a1c6b-2d85-4f37-a0b9-6c3e8d1f5a20 \
  -H "Authorization: Bearer evo_kb_..."

Отвязка тега от базы знаний

DELETE /v1/knowledge-bases/{knowledge_base_id}/tags/{tag_id}

204 — без тела. Если тег не был привязан, ответ тоже 204.

Ошибки

HTTP	Код	Когда
`400`	`tag_name_taken`	Тег с таким названием в пространстве уже есть
`404`	`tag_not_found`	Тега нет
`404`	`knowledge_base_not_found`	Базы знаний нет или она недоступна ключу

Фрагменты

Ошибки