Add Role Members

Adds one or more members to a specified role.

Use this endpoint to bind existing NineData accounts to a role from an external onboarding or access-control workflow. Obtain the roleId from List Roles and account IDs from Get Account List.

After the request succeeds, call List Role Members to verify that the accounts are bound to the role.

Request URL: /openapi/v1/role/member/add

Request Method: POST

Request Parameters

Parameter	Type	Required	Description	Example
roleId	String	Yes	Role ID. You can call List Roles to obtain it.	2394
accountIds	Array	Yes	List of account IDs to add. Multiple account IDs are supported in a single request. You can call Get Account List to obtain them.	["1708********6159", "1472********1784"]

Request Example

{
  "roleId": "2394",
  "accountIds": [
    "1708********6159",
    "1472********1784"
  ]
}

Response Parameters

Parameter	Type	Description	Example
success	Boolean	Whether the request is successful.	true
requestId	String	Request ID.	Wr1v5DRN-gmmmfTXnjihu0QCdjhd4CXP

Successful Invocation Example

{
  "success": true,
  "requestId": "Wr1v5DRN-gmmmfTXnjihu0QCdjhd4CXP"
}