Zum Hauptinhalt springen
Mit diesem Endpunkt listest du die Systemrollen und die benutzerdefinierten Rollen auf, die du mit Nutzerrolle ändern zuweisen kannst. Namen benutzerdefinierter Rollen sind nicht eindeutig. Nimm beim Zuweisen die id. Der Aufruf ist über den USER_MANAGEMENT_API Scope des Workspace-API-Schlüssels autorisiert. Er läuft nicht als die Person, die den Schlüssel erstellt hat, und funktioniert weiter, wenn dieser Admin den Workspace verlässt.

​
Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

​
Voraussetzungen

  • API-Schlüssel mit dem Scope USER_MANAGEMENT_API
  • Der API-Schlüssel muss von einem Workspace-Admin erstellt worden sein

​
Verhalten

  • Zuerst kommen die Systemrollen, in dieser Reihenfolge: member, editor, admin. kind ist system. name ist Member, Editor oder Admin. description ist leer. id ist dieser kleingeschriebene Rollenname.
  • Danach folgen die benutzerdefinierten Rollen, die älteste zuerst. kind ist custom. Gelöschte benutzerdefinierte Rollen fehlen.
  • Jede Rolle hat id, kind, name und description. Berechtigungseinstellungen sind nicht enthalten.
  • Der Aufruf nimmt keine Parameter.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.