

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен `platform-api2.max.ru` вместо `platform-api.max.ru`. Также убедитесь, что добавили сертификат Минцифры в список доверенных

Редактирует сообщения и посты, отправленные ботом

  #### Ограничения

- Есть особенности редактирования сообщений в диалогах с ботом, связанные со сроком давности:

    - сообщения с кнопками [`inline_keyboard`](/docs-api#Как%20добавить%20кнопки) редактируются независимо от срока давности

    - остальные сообщения редактируются, если они отправлены менее 7 суток назад

- В групповых чатах и каналах любые сообщения редактируются независимо от срока давности

- Можно редактировать не более двух сообщений в секунду в одном диалоге, групповом чате или канале. При превышении этого лимита сообщения следует ставить в очередь или делать задержку перед редактированием

#### Пример запроса:

curl -X PUT "https://platform-api2.max.ru/messages?message_id=message_id" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Изменённый текст"
}'

## Авторизация

> Передача токена через query-параметры больше не поддерживается — используйте заголовок `Authorization: `

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на [платформе](https://business.max.ru/self) в разделе **Чат-боты**. Выберите необходимого бота и нажмите **⋮** → **Настройки** → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в [мини-приложении «MAX для бизнеса»](https://max.ru/business_bot?startapp), получить токен можно там же или в [боте «MAX для бизнеса»](https://max.ru/business_bot) с помощью команды **Получить токен**

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом.
Токен может быть отозван за нарушение Правил платформы

## Параметры

от `1` символа

ID редактируемого сообщения

## Тело запроса

до `4000` символов
Вложения сообщения. Если поле пустое или равно `null`, изменений не произойдет. Если массив пуст, все вложения будут удалены

Данные для прикрепления изображения (все поля являются взаимоисключающими). Вместе с изображениями можно прикрепить видеофайлы (`type: video`) и одно вложение с кнопками (`type: inline_keyboard`). Общее количество вложений не должно превышать общее ограничение — 12. Подробнее — [в примерах](/docs-api#Примеры%20с%20видео,%20изображением,%20файлом)

от `1` символа

Любой внешний URL изображения, которое вы хотите прикрепить
Токен существующего вложения
Токены, полученные после загрузки изображений

Ссылка на сообщение в чате или пост в канале. Ссылки на комментарии к постам в каналах не поддержаны

Возможные значения в enum: `"forward"` `"reply"`

Тип связанного сообщения:
  - `"reply"` — ответ на сообщение или комментарий в чате или канале
- `"forward"` — пересланное сообщение в чате или канале

 **Для комментариев поддерживается только тип `reply`**
ID исходного сообщения

По умолчанию: `true`

Если `false`, участники чата не получат push-уведомления. Для каналов необходимо отправлять запрос с `notify = true` или без этого поля, т.к. каналы не подразумевают отправку постов без push-уведомлений
Возможные значения в enum: `"markdown"` `"html"`

Разметка текста сообщения. Подробнее — в разделе [Форматирование](/docs-api#Форматирование%20текста%20в%20сообщениях)

## Результат

`true`, если запрос был успешным, `false` — в противном случае
Сообщение об ошибке

## Коды ответов

| Код | Описание |
| --- | --- |
| `200` | Успешный или неуспешный результат |
| `401` | Ошибка авторизации. Токен `access_token` указан некорректно или недействителен |
| `500` | Внутренняя ошибка сервера |

