Изменить настройки бота

PATCH
/api/bot/config

Применяет одно или несколько изменений настроек, адресованных по path. Принимаются только пути, которые возвращает GET /api/bot/config/schema.

  • Все изменения проверяются относительно одного снимка состояния; если хотя бы одно невалидно, весь запрос отклоняется с 400 и ничего не записывается.
  • Изменение, у которого новое значение совпадает с текущим, исключается из diff и никогда не отмечается как применённое.
  • Путь типа text, который сейчас хранит несколько вариантов (например, несколько приветствий), отклоняется с 400, а не схлопывается в одну строку.
  • При повторной отправке одного и того же path учитывается последнее вхождение.

Каждое применённое изменение также пишет событие бота bot_setting_update.

Authorization

ApiKeyAuth
Authorization<token>

API-ключ интеграции со страницы бота Settings → API Keys, передаётся как есть, без префикса Bearer.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/bot/config" \  -H "Content-Type: application/json" \  -d '{    "dryRun": true,    "changes": [      {        "path": "templates.greeting.initial",        "value": "Здравствуйте!"      },      {        "path": "filters.ignore.patterns",        "values": [          "спам",          "реклама"        ]      }    ]  }'
{  "applied": true,  "changes": [    {      "path": "string",      "oldValue": null,      "newValue": null    }  ]}