# Update user moderation state

Changes the moderation state of a user (e.g., ACTIVE, SUSPENDED, LIMITED). This affects what actions the user can perform on the platform. When suspending a user, their content may be hidden and followers on remote servers are notified. When unsuspending, the user's content is restored and remote servers are updated. Administrators cannot change their own state. Changes are logged for audit purposes and can be linked to moderation reports.

RBAC: requires Users.Manage

Endpoint: POST /api/v1/admin/user/change-state
Version: 1.0
Security: 

## Request fields (application/json):

  - `newState` (string, required)
    New moderation state for the user(s).
    Enum: "REGULAR", "SENSITIVE", "LIMITED", "SUSPENDED"

  - `reportId` (string,null)
    Optional report ID if this action is in response to a moderation report.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `reason` (string,null)
    Optional reason for the state change. Limited to 120 characters. Logged in audit trail.
    Example: "Violation of community guidelines - spam behavior"

  - `userId` (string, required)
    User ID to change state for. Must be a valid USER type TypeId.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation