---
title: "Update staff-managed account fields (custom donations, staff note)"
method: POST
path: "/v1/admin.updateAccount"
tags: ["admin"]
---

# Update staff-managed account fields (custom donations, staff note)

`POST /v1/admin.updateAccount`

## Request body

- V1AdminUpdateAccountRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `customDonations` integer, nullable — Staff-granted donation total in cents (PayPal, crypto, gifts). Absolute, not a delta: 2500 means the account shows $25.00 of custom donations. Send null to zero it out, omit to leave it alone.
  - `id` IDSearch
    - `accountId` integer — Account ID to search for
    - `steamId64` string — SteamID64 to search for
  - `note` string, nullable — Staff-only note on the account. Send null (or an empty string) to delete it, omit to leave it alone.
  - `vanity` VanitySearch
    - `type` 'steam' | 'internal', required — Which type of vanity to search for
    - `value` string, required — Vanity to search for

## Response `200`

OK

- V1AdminUpdateAccountResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `customDonations` integer, required — The staff-granted donation total in cents
  - `donations` integer, required — The Patreon-reported donation total in cents
  - `total` integer, required — The sum of both, which is what the donations leaderboard scores

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/revisions/593d89718daa/schema)
