Skip to main content
POST
Create a new role
Creates a new custom role for an organization with specified policies and actors.

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

organizationId
string<uuid>
requerido

ID of the requested organization.

Cuerpo

application/json
name
string
requerido

Name of the role

actors
string[]
requerido

List of actor resource IDs to assign to this role (e.g., ["user/uuid", "apiKey/uuid"])

policies
object[]
requerido

List of policies to create for this role

Respuesta

Successful response

status
number

HTTP status code.

Ejemplo:

200

requestId
string<uuid>

Unique id assigned to every request. UUIDv4

result
object
Última modificación el 24 de julio de 2026