Skip to main content

Create a role

POST /api/roles creates a role resource

Required scope: scopes:manage:all

Request Body — REQUIRED
role object
id string
name string
scopes object[]
id string
name string
public boolean
Responses
200
Schema — OPTIONAL
data object — OPTIONAL
id string — OPTIONAL
name string — OPTIONAL
scopes object[] — OPTIONAL
id string — OPTIONAL
name string — OPTIONAL
public boolean — OPTIONAL
201
Schema — OPTIONAL
data object — OPTIONAL
id string — OPTIONAL
name string — OPTIONAL
scopes object[] — OPTIONAL
id string — OPTIONAL
name string — OPTIONAL
public boolean — OPTIONAL
400

Bad request.

Schema — OPTIONAL
errors object — OPTIONAL
401

The client is unauthorized to access this resource.

Schema — OPTIONAL
code string
message string
403

The client is forbidden to access this resource.

Schema — OPTIONAL
code string
message string
422

The request payload is invalid.

Schema — OPTIONAL
errors object — OPTIONAL