Change Account Status (Admin)

POST/web/v1/system/accounts/admin/status JWT

Required Gateway Headers

All API requests require gateway headers. See Required Headers for the complete list. In local/test environments, you must also include Cloudflare simulation headers (CF-Connecting-IP, Cf-Ray, cf-ipcountry).

Changes the status of a user account (e.g., activate, suspend, deactivate). This is an admin operation requiring workspace-level user write permission.

Required Headers

Header	Example Value	Description
Content-Type	application/json	Request content type
Accept	application/json	Expected response type
X-Client-Hash		Client device fingerprint
Accept-Language	en, zh, zh-Hant, ja, vi	Response language (default: en)
Authorization	Bearer	JWT access token

Request Parameters

Name	Type	Required	In	Description
workspaceId	String	Required	path	Workspace business ID
userBizId	String	Required	path	User account business ID
request	Object	Required	body	AccountStatusChangeRequest object (see request body schema)

Success Response

Success 200

{
  "version": "2.0.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "userBizId": "usr_abc123",
    "email": "user@example.com",
    "displayName": "John Doe",
    "status": "SUSPENDED"
  }
}

Error Responses

Unauthorized 401

{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}

Notes

• Requires workspace:user:write permission.
• Valid status transitions depend on the current account state.