Berechtigungen benutzerdefinierter Organisationsrollen abrufen

GET /v1/org-custom-role-permissions · Berechtigung roles:read

Gibt die Berechtigungen zurück, die benutzerdefinierte Organisationsrollen in dieser Umgebung enthalten dürfen. Solange die Liste leer ist, kann keine Organisationsrolle erstellt werden. Das Lesen der Liste erfordert das Tarif-Feature nicht.

Anfrage

Feld Typ Pflicht Beschreibung

Kein Request-Body.

Antwort

200 OK mit der Liste.

{
  "permission_ids": [
    "perm_01j9xs0a2b4c6d8e0f2g4h6j8k",
    "perm_01j9xs0a2b4c6d8e0f2g4h6j8m"
  ]
}

Fehler

HTTP code Wann
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/org-custom-role-permissions" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"