Skip to main content
PATCH
Error

Autorizaciones

Authorization
string
header
requerido

Bearer authentication. Send Authorization: Bearer .

Parámetros de ruta

id
string
requerido

Role ID

Cuerpo

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 "").

Ejemplo:

"An updated description"

displayName
string

Role's display name.

Ejemplo:

"Updated Editor"

isEnabled
boolean

Whether the role is enabled.

Ejemplo:

true

Respuesta

OK

RoleResponse payload

createdAt
string
Ejemplo:

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

description
string
Ejemplo:

"A custom editor role"

groups
string[]
id
string
Ejemplo:

"custom-editor"

isEnabled
boolean
Ejemplo:

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".

Ejemplo:

false

name
string
Ejemplo:

"Custom Editor"

roles
string[]
users
string[]