---
title: "Bulk Change Points"
method: POST
path: "/v1/points/{system}/"
tags: ["points"]
---

# Bulk Change Points

`POST /v1/points/{system}/`

Bulk change points of multiple users at once.

Takes up to 200 users per request and counts as a single request against your rate limits, so this is the cheapest way to keep a large server in sync. Users whose change failed come back in `failed_users`, the rest still went through.

## Path parameters

- `system` string, required

## Request body

- BulkChangeRequest
  - `changes` UserPointChangeRequest[], required
    - `user` integer, required
    - `mode` 'set' | 'edit', required
    - `amount` integer, required

## Response `200`

Successful Response

- BulkChangeResponse
  - `failed_users` integer[], required

## Other responses

- `401` — Unauthorized. You can't access this point system.
- `422` — Validation Error
- `429` — Out of requests. `X-RateLimit-Bucket` says which limit you hit and `Retry-After` how many seconds to wait. This request was not counted against you.

---

[API](https://skmtc.dev/monni/apis/fastapi.md) · [All operations](https://skmtc.dev/monni/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monni/fastapi/revisions/0321cc5200a6/schema)