Skip to content

Get role

GET
/api/v1/roles/{name}

Returns a single role by its uppercase name.

name
required
string

Uppercase role name

Role found

object
name
string
permissions
Array<string>
builtIn
required
boolean
userCount
required
integer format: int64

Unauthorized

object
error
object
code
string
message
string
status
required
integer format: int32

Forbidden

object
error
object
code
string
message
string
status
required
integer format: int32

Role not found

object
error
object
code
string
message
string
status
required
integer format: int32