Direkte Rollen eines Benutzers abrufen

GET /v1/users/{user_id}/roles · Berechtigung users:read

Gibt die Umgebungsrollen zurück, die dem Benutzer direkt zugewiesen sind. Rollen aus Organisationsmitgliedschaften sind nicht enthalten; lesen Sie dafür die Mitgliedschaft.

Anfrage

Feld	Typ	Pflicht	Beschreibung
`user_id`	path	ja	Benutzer-ID (`usr_…`).

Kein Request-Body.

Antwort

200 OK mit den Rollen-IDs.

{
  "role_ids": [
    "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
  ]
}

Fehler

HTTP	code	Wann
404	`not_found`	Der Benutzer existiert in dieser Umgebung nicht.
401	`unauthenticated`	Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen.
403	`insufficient_permissions`	Dem Berechtigungsnachweis fehlt die erforderliche Berechtigung.
429	`rate_limited`	Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeit aus `Retry-After`.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Zeit aus `Retry-After`.

Beispiel

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