POST
/
v1
/
permissions.createRole

To use this endpoint, your root key must have the rbac.*.create_role permission.

Changelog

DateChanges
Jul 08 2024Introduced endpoint

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

The unique name of your role.

Required string length: 3 - 256
description
string

Explain what this role does. This is just for your team, your users will not see this.

Required string length: 3 - 256

Response

200 - application/json
roleId
string
required

The id of the role. This is used internally