---
title: "Set User Points"
method: PUT
path: "/v1/points/{system}/{user_id}/"
tags: ["points"]
---

# Set User Points

`PUT /v1/points/{system}/{user_id}/`

## Request

- Base URL: `https://api.monni.fyi` (the document declares no server; this is the origin it was published from)
- URL: `https://api.monni.fyi/v1/points/{system}/{user_id}/`
- Auth: API key in header `X-API-Key`

Set points of a user for a specific system to a given amount.

## Path parameters

- `system` string, required
- `user_id` integer, required

## Query parameters

- `amount` integer, required

## Response `200`

Successful Response

- UserPointChange
  - `system` string, required
  - `before` integer, required
  - `after` 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.

## Changes

- **2026-09-24** `2ec565e413a7`: 1 info
  - the `error` response's property default value changed from `It seems you can't access this point system` to `This API key can't access this point system.` for the status `401`
- **2026-09-16** `83ac8f547df8`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/monni/apis/monni-api/changes/v1/points/:system/:user_id/put.md)

---

[API](https://skmtc.dev/monni/apis/monni-api.md) - [All operations](https://skmtc.dev/monni/apis/monni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monni/apis/monni-api/revisions/a35aef40d880?raw)