Skip to main content
PATCH
Aktualisiert eine der eigenen benutzerdefinierten Rollen des Kontos auf dem Management-API-Host (api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
integer
erforderlich
Die id der Rolle.
Sowohl PUT als auch PATCH werden unterstützt (PUT für einen vollständigen Ersatz, PATCH für eine Teilaktualisierung) und akzeptieren dieselben name/permissions-Felder wie bei Eine benutzerdefinierte Rolle erstellen.

Systemrollen können hier nicht bearbeitet werden

Nur die eigenen benutzerdefinierten Rollen des Kontos (is_custom: true) sind über diesen Endpunkt schreibbar — eine pk, die zu einer Systemrolle (oder der benutzerdefinierten Rolle eines anderen Kontos) gehört, liefert 404, genau wie eine, die gar nicht existiert.

Siehe auch

Autorisierungen

Authorization
string
header
erforderlich

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Pfadparameter

pk
integer
erforderlich

Body

application/json
name
string
permissions
integer[]

Antwort

Role updated.