Skip to content

Create a new role. Then optionally add scopes by using the Update Role Scopes API. No scopes are added by default.
Stable

Request

Learn more about Creating Custom Roles.

Security
apiKey
Bodyapplication/jsonrequired
namestring
descriptionstring
cURL
curl -i -X POST \
  https://develop-api.esper.io/_mock/openapi/authz2/v1/roles/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string"
  }'

Responses

Request Succeded

Bodyapplication/json
idstring
namestring
descriptionstring
role_typeinteger
Response
{
  "id": "string",
  "name": "string",
  "description": "string",
  "role_type": 0
}