Изменение токена бота

PUT/bots/{id}/tokens/{token_id}

Меняет имя или права токена. Новые права действуют сразу: перевыпускать токен не нужно, его значение остаётся прежним. Права заменяются переданным списком целиком.

Работать с токенами бота могут только его создатель и администратор пространства, если настройки бота открывают администраторам доступ к редактированию. Владельцу чата с ботом метод отвечает 403, даже когда остальные настройки бота ему открыты.

Параметры пути

Идентификатор бота

Пример:1738816

Идентификатор токена

Пример:4827

Тело запроса

application/json

Новое имя токена

Пример:Сервер уведомлений

Длина:

<= 255 символов

Новые права токена. Список заменяется целиком и действует сразу, перевыпускать токен не нужно.

Пример:["messages:create","chats:read"]

Ответ

200OK

The request has succeeded.

Токен бота

Идентификатор токена

Пример:4827

Токен в маскированном виде (видны первые 8 и последние 4 символа). Полное значение приходит один раз: при выпуске и перевыпуске токена.

Пример:cH5kR9mN...x7Qp

Имя токена. null у токена, выпущенного без имени.

Пример:Сервер уведомлений

Идентификатор бота, которому принадлежит токен

Пример:1738816

Права токена

Пример:["messages:create","chats:read"]

Дата и время выпуска токена (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ

Пример:2025-01-15T10:30:00.000Z

Дата отзыва токена. Всегда null: отозванные токены в ответ не попадают.

Пример:null

Время жизни токена в секундах. У токенов бота null: они бессрочные.

Пример:null

Дата последнего использования токена. null, пока по токену не было ни одного запроса. Обновляется не чаще раза в час, поэтому может отставать.

Пример:2025-02-24T14:20:00.000Z

Дата авторизации. У токенов бота null.

Пример:null