# Keycloak Roles (by ID) API

**Canonical:** https://apis.io/apis/keycloak/keycloak-roles-by-id-api/  
**Provider:** Keycloak — https://apis.io/providers/keycloak/  
**Documentation:** https://www.keycloak.org/docs-api/latest/rest-api/

Keycloak Roles (by ID) API is one of 23 APIs that [Keycloak](https://apis.io/providers/keycloak/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Roles (by ID). The published artifact set on APIs.io includes an OpenAPI specification.

The Roles (by ID) API from Keycloak — 5 operation(s) for roles (by id).

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/realms/{realm}/roles-by-id/{role-id}` | Get a specific role's representation |
| PUT | `/admin/realms/{realm}/roles-by-id/{role-id}` | Update the role |
| DELETE | `/admin/realms/{realm}/roles-by-id/{role-id}` | Delete the role |
| GET | `/admin/realms/{realm}/roles-by-id/{role-id}/composites` | Get role's children Returns a set of role's children provided the role is a… |
| POST | `/admin/realms/{realm}/roles-by-id/{role-id}/composites` | Make the role a composite role by associating some child roles |
| DELETE | `/admin/realms/{realm}/roles-by-id/{role-id}/composites` | Remove a set of roles from the role's composite |
| GET | `/admin/realms/{realm}/roles-by-id/{role-id}/composites/clients/{clientUuid}` | Get client-level roles for the client that are in the role's composite |
| GET | `/admin/realms/{realm}/roles-by-id/{role-id}/composites/realm` | Get realm-level roles that are in the role's composite |
| GET | `/admin/realms/{realm}/roles-by-id/{role-id}/management/permissions` | Return object stating whether role Authorization permissions have been… |
| PUT | `/admin/realms/{realm}/roles-by-id/{role-id}/management/permissions` | Return object stating whether role Authorization permissions have been… |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/keycloak/openapi/keycloak-roles-by-id-api-openapi.yml

## Other Keycloak APIs (12)

- [Keycloak Clients API](https://apis.io/apis/keycloak/keycloak-clients-api/)
- [Keycloak Groups API](https://apis.io/apis/keycloak/keycloak-groups-api/)
- [Keycloak Identity Providers API](https://apis.io/apis/keycloak/keycloak-identity-providers-api/)
- [Keycloak Realms API](https://apis.io/apis/keycloak/keycloak-realms-api/)
- [Keycloak Roles API](https://apis.io/apis/keycloak/keycloak-roles-api/)
- [Keycloak Users API](https://apis.io/apis/keycloak/keycloak-users-api/)
- [Keycloak Admin API](https://apis.io/apis/keycloak/keycloak-admin-api/)
- [Keycloak Attack Detection API](https://apis.io/apis/keycloak/keycloak-attack-detection-api/)
- [Keycloak Authentication Management API](https://apis.io/apis/keycloak/keycloak-authentication-management-api/)
- [Keycloak Client Attribute Certificate API](https://apis.io/apis/keycloak/keycloak-client-attribute-certificate-api/)
- [Keycloak Client Initial Access API](https://apis.io/apis/keycloak/keycloak-client-initial-access-api/)
- [Keycloak Client Registration Policy API](https://apis.io/apis/keycloak/keycloak-client-registration-policy-api/)

## Tags

Roles (by ID)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/keycloak/keycloak-roles-by-id-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/keycloak/.