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