Setze eine Anwendungs-API-Berechtigung

PUT /v1/applications/{application_id}/api-grants/{api_id} · Berechtigung applications:write

Ersetzt vollständig die Scopes, die eine Anwendung für eine API anfordern darf. Eine Anwendung kann Genehmigungen für höchstens 50 APIs haben.

Anfrage

Parameter In Beschreibung
application_id path Anwendungs-ID (app_…).
api_id path API-ID (api_…).

Body

Feld Typ Erforderlich Beschreibung
scopes string[] ja Zulässige Scopes (resource:action); jeder muss auf der API definiert sein. Maximal 1000.
default_scopes string[] nein Scopes, die standardmäßig gewährt werden; eine Teilmenge von scopes.

Antwort

200 OK mit der Berechtigung.

{
  "application_id": "app_6f8d0cjgbmf0gtn2rg6pscp3cg",
  "api_id": "api_0000000000000000000000001z",
  "scopes": ["orders:read", "orders:write"],
  "default_scopes": ["orders:read"],
  "created_at": "2026-10-05T10:00:01Z",
  "updated_at": "2026-10-05T10:00:01Z"
}

Fehler

HTTP code Wann
401 unauthenticated Der Schlüssel fehlt, ist ungültig oder wurde widerrufen.
403 insufficient_permissions Der Schlüssel hat nicht die erforderliche Berechtigung.
404 not_found Die Anwendung oder die Berechtigung existiert nicht in dieser Umgebung.
422 validation_failed Ein Scope ist missgestaltet oder nicht auf der API definiert, oder default_scopes ist keine Teilmenge von scopes.
403 quota_exceeded Die Anwendung hält bereits Genehmigungen für 50 APIs.
400 unknown_field Der Body hat ein Feld, das nicht Teil des Schemas ist.

Beispiel

curl -X PUT https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg/api-grants/api_0000000000000000000000001z \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scopes":["orders:read","orders:write"],"default_scopes":["orders:read"]}'