Создаёт тег. Тег — это способ держать состав чатов сам собой: его привязывают к беседе или каналу, и все, у кого этот тег есть, оказываются там автоматически.
Сотрудников в тег добавляют не здесь, а в карточке каждого — PUTРедактирование сотрудника с полем list_tags. Свежий тег создаётся пустым, с users_count: 0. К чату его привязывает метод POSTДобавление тегов.
Название уникально в пространстве без учёта регистра и не может содержать @. Пустое название или название из одних пробелов отвечает 400 с кодом blank. Занятое название отвечает 400 с кодом taken, а 409 приходит, только если такой же тег создали одновременно с запросом. Создавать теги могут владелец пространства и администратор, боту метод недоступен.
Тело запроса
application/jsongroup_tag
object
*name
string
*Название тега
Пример:
Новое название тегаДлина:
<= 255 символовОтвет
201Created
The request has succeeded and a new resource has been created as a result.
data
object
*Тег
id
integer, (int32)
*Идентификатор тега
Пример:
9111name
string
*Название тега
Пример:
DesignДлина:
<= 255 символовusers_count
integer, (int32)
*Количество сотрудников, которые имеют этот тег
Пример:
6