Create Tenant Admin Init

POST/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/admin-init WEB

Initiates the tenant admin invitation flow for a given institution. Sends an invitation email to the specified administrator.

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

Path Parameters

Name	Type	Required	In	Description
workspaceId	string	Required	path	Workspace business ID
institutionBizId	string	Required	path	Institution business ID

Request Body

TenantAdminInitRequest:

Name	Type	Required	In	Description
email	string	Required	body	Admin email address (max 255 characters, must be valid email format)
name	string	Optional	body	Admin display name (2-126 characters)
phone	string	Optional	body	Admin phone number (E.164 format, max 25 characters)

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "institutionBizId": "inst_abc123",
    "email": "admin@example.com",
    "sessionId": "sess_xyz789",
    "expiresAt": "2026-03-22T00:00:00Z",
    "created": true,
    "emailSent": true
  }
}

Error Responses

Code	Description
4000	Validation error (invalid email format, name too short/long)
4010	Unauthorized (invalid or missing JWT token)
4040	Institution not found

Notes

• If a pending init record already exists for the same email, created will be false and the invitation email is resent.
• The sessionId can be used to track the initialization flow.
• The expiresAt field indicates when the session will expire.