Skip to main content
POST
Change a member's system role
Mit diesem Endpunkt änderst du die Workspace-Systemrolle eines aktiven menschlichen Mitglieds per E-Mail. Sende member, editor oder admin. Custom Roles gehören nicht zu diesem Endpunkt. 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

  • Kein aktives menschliches Mitglied? Gibt 404 zurück (unbekannte E-Mail, eingeladen, deaktiviert, Service Account oder anderer Workspace).
  • Letzter verbleibender Admin? Gibt 400 mit code: "BAD_REQUEST" zurück.
  • Dieselbe Rolle erneut zu setzen, gibt 200 zurück.
  • Der E-Mail-Abgleich ist unabhängig von Groß- und Kleinschreibung. Rollenwerte sind kleingeschrieben: member, editor, admin. ADMIN gibt 400 zurück.
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"

Body

application/json
email
string<email>
erforderlich

Email address of the active workspace member

Beispiel:

"user@example.com"

role
enum<string>
erforderlich

Workspace system role. Values are lowercase.

Verfügbare Optionen:
member,
editor,
admin
Beispiel:

"editor"

Antwort

Role updated successfully

status
enum<string>
erforderlich

Always "success" when the role is updated

Verfügbare Optionen:
success
Beispiel:

"success"

email
string<email>
erforderlich

Email address of the updated member

Beispiel:

"user@example.com"

role
enum<string>
erforderlich

System role after the update

Verfügbare Optionen:
member,
editor,
admin
Beispiel:

"editor"