Skip to main content
PATCH
Update a role
Updates an existing custom role. System roles cannot be updated. All fields are optional - only provided fields will be updated.

Autorisations

Authorization
string
header
requis

Use key ID and key secret obtained in ClickHouse Cloud console: https://clickhouse.com/docs/cloud/manage/openapi

Paramètres de chemin

organizationId
string<uuid>
requis

ID of the requested organization.

roleId
string<uuid>
requis

ID of the requested role.

Corps

application/json
name
string

New name for the role

actors
string[]

New list of actor resource IDs (replaces existing actors)

policies
object[]

New list of policies (replaces existing policies)

Réponse

Successful response

status
number

HTTP status code.

Exemple:

200

requestId
string<uuid>

Unique id assigned to every request. UUIDv4

result
object
Dernière modification le 24 juillet 2026