Initialize Account (Admin)

POST/web/v1/workspaces/{workspaceId}/users/admin/accounts/init JWT

Initializes a new user account within the workspace. This is a tenant-only admin operation for creating accounts with pre-configured settings.

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
request	Object	Required	body	AccountInitRequest object (see request body schema)

Success Response

Success 200

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

Error Responses

Unauthorized 401

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

Notes

• Only available in the tenant portal (10010102).
• Requires workspace:user:write permission.
• Creates a new account with pre-configured settings within the workspace.