Skip to content

Create Roles

Creates the specified Roles.

Verb PUT
Endpoint {base-url}/roles/
Max Page Size N/A

Request Body

{
  "body": [
    {
      "organizationId": 2,
      "name": "create test",
      "description": "create test description"
    }
  ]
}

Note

All changes in this request are atomic. If any item fails, the entire batch is rolled back and no changes are made.

Returns

On Success

The IDs of the created roles.

Response Body

[
  6
]

On Error

HTTP Code Error Code Definition
403 DATA_ACCESS_VIOLATION One or more of the specified organizationId values is an organization you do not have access to.
422 VALIDATION_ERROR A required field (organizationId, name) is missing or invalid.
422 VALIDATION_ERROR name exceeds 50 characters, or description exceeds 200 characters.