---
title: "Update Status"
method: POST
path: "/admin/users/{user_id}/status"
---

# Update Status

`POST /admin/users/{user_id}/status`

## Request

- Base URL: `https://api.twtapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.twtapi.com/admin/users/{user_id}/status`
- Auth: none declared

冻结/解冻用户（只允许 active 与 frozen 两种状态）。

白名单校验必须放在最前面：status 会直接写进 User.status 并被鉴权路径读取，
传入未定义的值会让用户既不算冻结也不算正常，属于非法状态防护。

副作用：写库（commit）+ 清该用户鉴权缓存（缓存里的 status 决定能否调用，
不清缓存会导致冻结不立即生效）。

## Path parameters

- `user_id` integer, required

## Request body

- AdminStatusUpdate: 管理员冻结/解冻账户。改完必须失效用户缓存，否则最长 5 分钟不生效。
  - `status` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twtapi/apis/twtapi-backend.md) · [All operations](https://skmtc.dev/twtapi/apis/twtapi-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/twtapi/apis/twtapi-backend/revisions/5295976febaf?raw)