Umgebungsrolle abrufen

GET /v1/roles/{role_id} · Berechtigung roles:read

Gibt die Rolle zurück. Die Antwort enthält ein ETag zur Verwendung mit If-Match.

Anfrage

Feld	Typ	Pflicht	Beschreibung
`role_id`	path	ja	Rollen-ID (`rol_…`).

Kein Anfragekörper.

Antwort

200 OK mit der Rolle.

{
  "id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
  "organization_id": null,
  "key": "support",
  "name": "Support",
  "description": "",
  "is_privileged": false,
  "assignable_in_self_service": true,
  "permission_ids": [],
  "created_at": "2026-10-12T09:31:00.123456Z",
  "updated_at": "2026-10-12T09:31:00.123456Z",
  "version": 1
}

Fehler

HTTP	code	Wann
404	`not_found`	Die Rolle existiert in dieser Umgebung nicht oder gehört zu einer Organisation.
401	`unauthenticated`	Die Anmeldeinformation fehlt, ist ungültig oder widerrufen.
403	`insufficient_permissions`	Die Anmeldeinformation hat nicht die erforderliche Berechtigung.
429	`rate_limited`	Das Ratenlimit wurde überschritten; nach der Dauer von `Retry-After` erneut versuchen.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der Dauer von `Retry-After` erneut versuchen.

Beispiel

curl -i "https://api.eu.keenauth.com/v1/roles/rol_01j9xr7s1t2w6x8y0z2a4b6c8e" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"