Skip to main content
PATCH
Error

Autorizações

Authorization
string
header
obrigatório

Bearer authentication. Send Authorization: Bearer .

Parâmetros de caminho

id
string
obrigatório

Role ID

Corpo

application/json

Role Update Input

RoleUpdateInput payload

description
string

Role's description. Use a pointer to distinguish "not sent" (nil) from "clear it" (pointer to "").

Exemplo:

"An updated description"

displayName
string

Role's display name.

Exemplo:

"Updated Editor"

isEnabled
boolean

Whether the role is enabled.

Exemplo:

true

Resposta

OK

RoleResponse payload

createdAt
string
Exemplo:

"2026-06-24T10:00:00.000Z"

description
string
Exemplo:

"A custom editor role"

groups
string[]
id
string
Exemplo:

"custom-editor"

isEnabled
boolean
Exemplo:

true

isSystem
boolean

Whether the role is a platform-managed system role, immutable through this API. Never omitempty: false must travel so a consumer does not read a missing key as "not a system role".

Exemplo:

false

name
string
Exemplo:

"Custom Editor"

roles
string[]
users
string[]