Skip to main content
PATCH
Update Button

Authorizations

X-API-Key
string
header
required

Path Parameters

button_id
string
required

Body

application/json

Запрос на обновление отдельной кнопки.

text
Text · object | null

Новые локализованные тексты

icon
string | null

Эмодзи/иконка кнопки

Maximum string length: 10
enabled
boolean | null

Включить/выключить

visibility
enum<string> | null

Новая видимость

Available options:
all,
admins,
moderators,
subscribers
conditions
ButtonConditions · object | null

Новые условия показа

action
string | null

Новый action (callback_data или URL)

dynamic_text
boolean | null

Текст содержит плейсхолдеры

open_mode
enum<string> | null

Режим открытия: callback или direct

Available options:
callback,
direct
webapp_url
string | null

URL для Mini App при open_mode=direct

description
string | null

Описание кнопки

Maximum string length: 200
sort_order
integer | null

Порядок сортировки

Response

Successful Response

Конфигурация отдельной кнопки.

type
enum<string>
required

Тип кнопки

Available options:
builtin,
url,
mini_app,
callback
text
Text · object
required

Локализованные тексты кнопки: {lang_code: text}

action
string
required

callback_data или URL в зависимости от типа

builtin_id
string | null

ID встроенной кнопки (для type=builtin)

icon
string | null

Эмодзи/иконка кнопки (отдельно от текста)

Maximum string length: 10
enabled
boolean
default:true

Кнопка активна

visibility
enum<string>
default:all

Видимость кнопки

Available options:
all,
admins,
moderators,
subscribers
conditions
ButtonConditions · object | null

Дополнительные условия показа

dynamic_text
boolean
default:false

Текст содержит плейсхолдеры ({balance}, {username} и т.д.)

open_mode
enum<string>
default:callback

Режим открытия: callback (через бота) или direct (сразу Mini App)

Available options:
callback,
direct
webapp_url
string | null

URL для Mini App при open_mode=direct

description
string | null

Описание кнопки для админ-панели

Maximum string length: 200
sort_order
integer | null

Порядок сортировки (для отображения в админке)