v1

latestOpenAPI 3.0.32026-07-24148824715.6 KB
Users

Bulk assign user roles

Set the roles for a list of users in an account.

You need the "Assign roles in account" permission to use this endpoint.

put/v2/users/roles/bulk

Request body

account_identifierstring uuid

The unique identifier of the account.

role_identifiersstring[] required

List of role identifiers.

user_identifiersstring[] required

List of user identifiers.

Example request

{
  "account_identifier": "00000000-0000-0000-0000-000000000000",
  "role_identifiers": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "user_identifiers": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Response

OK

Example response

{
  "results": [
    {
      "errors": [
        {
          "details": "Failed to connect with database",
          "message": "DATABASE_ERROR"
        }
      ],
      "success": true,
      "user_identifier": "00000000-0000-0000-0000-000000000000"
    }
  ]
}