Zum Hauptinhalt springen
Mit diesem Endpunkt kannst du programmatisch einen oder mehrere Nutzer in deinen Workspace einladen. Das ist praktisch, um Onboarding-Abläufe, Partner-Integrationen oder die Massenbereitstellung von Nutzern zu automatisieren.

​
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

  • Bereits Mitglied? Wird übersprungen.
  • Hat eine ausstehende Beitrittsanfrage? Wird automatisch genehmigt.
  • Ungültige E-Mail-Domain? Wird in invalidEmails aufgeführt, lässt die Anfrage aber nicht fehlschlagen.
  • SAML deaktiviert? Die Einladungs-E-Mail enthält einen Magic Link für die passwortlose Anmeldung.
  • SAML aktiviert? Nutzer außerhalb deiner verifizierten Domains bekommen einen Magic Link, wenn Externe Authentifizierung erlauben aktiv ist.
Eine 200-Antwort kann trotzdem invalidEmails enthalten. Dies sind E-Mail-Adressen, die die Formatvalidierung bestanden haben, aber bei tieferen Prüfungen durchgefallen sind (z. B. nicht erreichbare Domain). Prüfe immer sowohl successfulInvites als auch invalidEmails in der Antwort.
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.