Skip to main content
GET
List assignable roles
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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Antwort

Assignable roles

roles
object[]
erforderlich

System roles first (member, editor, admin), then live custom roles from oldest to newest. Deleted custom roles are omitted.