Skip to main content
POST
Create Role

Authorizations

Authorization
string
header
required

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

Body

application/vnd.api+json

Schema for client-submitted role creation.

is_system is intentionally absent — system roles are seeded, not minted via the API. Unknown fields are forbidden (extra="forbid") so callers receive a 422 rather than a silent discard on typos, which mirrors PermissionAssignRequest and makes the API surface more honest.

name
string
required
slug
string
required
team_id
string | null

Response

Successful Response

data
JsonApiResource[RoleAttributes] · object
required
included
any[] | null
meta
Meta · object | null