Realm Roles

Delete a realm role

Deletes the role and removes all its user and group assignments.

Required scope: realm-roles:write

delete/clusters/{cluster_id}/realms/{realm_name}/roles/{role_name}

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/clusters/{cluster_id}/realms/{realm_name}/roles/{role_name}
  • Auth: API key in header API-Key

Path parameters

cluster_idstring uuid required
realm_namestring required

Keycloak realm name (not ID). Must start with a letter; allows letters, digits, and hyphens.

Example:customer-portal
role_namestring required

Role name.

Example:admin

Headers

API-Version'2026-06-01.beta' required

Response

There is no content to send for this request, but the headers may be useful.

Changes

No recorded changes to this operation across all 1 revision of this API.