> For the complete documentation index, see [llms.txt](https://docs.skillzrun.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skillzrun.com/administruvannya/robota-z-api/masove-onovlennya-balansu-monet.md).

# Масове оновлення балансу монет

Метод зовнішнього API змінює баланс монет одразу для кількох користувачів. Його можна застосовувати для бонусів за акції, компенсацій або синхронізації із зовнішньою системою лояльності.

## Метод і авторизація

* **Метод:** `PATCH /external/api/user_balance/`
* **Авторизація:** заголовок `x-api-key` із ключем компанії.

API-ключ створюють у налаштуваннях компанії на вкладці **«API-ключі»**. [Як створити ключ](https://docs.skillzrun.com/administruvannya/robota-z-api).

## Параметри тіла запиту

| Поле      | Значення                                                                   |
| --------- | -------------------------------------------------------------------------- |
| `userIds` | Масив ID користувачів, яким потрібно змінити баланс.                       |
| `amount`  | Величина зміни у монетах: додатне число нараховує монети, від'ємне списує. |
| `note`    | Коментар до зміни балансу.                                                 |

Перед запуском масового списання перевірте знак і величину `amount`, а також перелік `userIds`. Актуальну схему запиту, відповіді та можливі помилки дивіться в [Swagger-документації SkillzRun](https://api.skillzrun.com/external/api/swagger/static/index.html#/). Доступ до Swagger видає підтримка.