---
title: "Update User Credits Request"
method: PUT
path: "/backoffice/users/{user_id}/monthly_credit_allowance"
tags: ["Backoffice"]
---

# Update User Credits Request

`PUT /backoffice/users/{user_id}/monthly_credit_allowance`

Update User Credits Allowance
This endpoint is used to increase or decrease the monthly credit allowance for a user.
It is used to give users free credits every month.
Note: if the user upgrades or downgrades, the credit allowance will be reset to the default value.

## Path parameters

- `user_id` string, required

## Request body

- UpdateMonthlyCreditAllowance — Update Monthly Credit Allowance
  - `amount` integer, required

## Response `200`

User credit allowance updated successfully

- AgentExecutionCredits
  - `user_id` string, required
  - `total_executions` integer, required
  - `allowed_monthly_executions` integer, required
  - `active_reserved_executions` integer
  - `available_executions` integer
  - `reset_datetime` string, date-time, required
  - `last_reset_datetime` string, date-time

## Other responses

- `404` — User not found
- `422` — Validation Error
- `500` — Internal server error

## Changes

- **2026-09-04** `fc441a13cd1f` — 1 info
  - the `last_reset_datetime` response's property default value changed from `2026-09-02T17:11:08.982413Z` to `2026-09-03T22:34:56.434476Z` for the status `200`
- **2026-09-03** `85693f776a5f` — 1 info
  - the `last_reset_datetime` response's property default value changed from `2026-09-01T16:24:32.921110Z` to `2026-09-02T17:11:08.982413Z` for the status `200`
- **2026-09-02** `d43ec641b160` — 1 info
  - the `last_reset_datetime` response's property default value changed from `2026-09-01T16:24:32.999961Z` to `2026-09-01T16:24:32.921110Z` for the status `200`
- **2026-09-01** `a56cd4cee44b` — 1 info
  - the `last_reset_datetime` response's property default value changed from `2026-08-31T04:45:55.841384Z` to `2026-09-01T16:24:32.999961Z` for the status `200`
- **2026-08-31** `098e6ed38169` — 1 info
  - the `last_reset_datetime` response's property default value changed from `2026-08-30T04:37:05.670278Z` to `2026-08-31T04:45:55.841384Z` for the status `200`

[Full history](https://skmtc.dev/toolhouse/apis/toolhouse-api/changes/backoffice/users/:user_id/monthly_credit_allowance/put.md)

---

[API](https://skmtc.dev/toolhouse/apis/toolhouse-api.md) · [All operations](https://skmtc.dev/toolhouse/apis/toolhouse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/toolhouse/toolhouse-api/revisions/fc441a13cd1f/schema)