Change Account Status (Admin)

POST/web/v1/workspaces/{workspaceId}/users/admin/{userBizId}/statusJWT

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

Authentication

Auth Chain: WEB Chain — requires Authorization: Bearer <jwt> These headers are injected by the system (frontend does nothing): X-PORTAL-ACCESS-CODE (Nginx), X-Request-Id (Gateway)

Request Parameters

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

Success Response

Success200

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

Error Responses

Unauthorized401

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

Notes

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