Skip to main content

CreateRole creates a new custom role.

POST 
/api/v1/auth/roles

Parameters​

  • name: Required, role name (unique in organization)
  • description: Optional, role description
  • permission_ids: Optional, initial permissions

Response​

Returns created role with permissions.

Errors​

  • ALREADY_EXISTS: Role name already in use
  • PERMISSION_DENIED: Caller lacks roles:write permission

Request​

Responses​

A successful response.