Open Inventory / Docs
EndpunkteAccess controlApiAccessRolesKey

Delete an access role

Die API läuft auf deiner Anwendungsinstanz. Schemas und Feldnamen stammen unverändert aus der OpenAPI-Spezifikation. Browsergebundene Aufrufe benötigen eine Sitzung auf der Instanz.

DELETE
/api/access/roles/{key}

Requires an authenticated browser session with the roles.manage permission. Built-in roles and roles assigned to users cannot be deleted; deleting a role also deletes its conditional inventory rules.

Authentifizierung

adminSession
cookieauthjs.session-token<token>

Authenticated Auth.js browser session cookie; each operation declares its required permission. Not restricted to administrators. HTTPS deployments use the secure-prefixed cookie variant.

Pfadparameter

key*string

Stable role key.

Muster^[a-z][a-z0-9_-]{0,63}$
Länge1 <= length <= 64

Header-Parameter

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Antwortinhalt

Role and its conditional inventory rules deleted

Beispielanfrage
curl -X DELETE 'https://example.com/api/access/roles/editor'
Beispielantwort
Leer