Zum Hauptinhalt springen
Liste aktive menschliche Mitglieder, ändere einen Plan und setze das Extra-Nutzungslimit. Beträge sind Euro. Die Aufrufe laufen über den BILLING_API Scope des Workspace-API-Schlüssels. Schreibzugriffe laufen als der Service Account, dem der Schlüssel gehört. Diese API lädt niemanden ein und deaktiviert niemanden. Dafür nutzt du die User Management API.
Diese Routen gelten, wenn GET /billing/v1/mode den Modus ai-models-included liefert. Ein Dedicated Deployment liefert immer bring-your-own-keys, auch wenn Langdock die Modellschlüssel verwaltet. Der andere Modus antwortet mit 409 und code BILLING_MODE_MISMATCH.

​
Basis-URL

​
Voraussetzungen

  • API-Schlüssel mit dem Scope BILLING_API
  • Der Besitzer ist ein Service Account, der nicht gelöscht ist und eine aktive Admin-Mitgliedschaft hat
  • USER_MANAGEMENT_API am selben Schlüssel, wenn du email, name oder einen E-Mail-Filter brauchst

​
Pläne in einem Rutsch ändern

POST /users/plan/bulk setzt einen Plan für 1 bis 500 Mitglieder-IDs.
Doppelte IDs zählen einmal. Ist eine ID kein aktives menschliches Mitglied des Workspace, antwortet der Aufruf mit 400, listet diese IDs in details.userIds und ändert nichts. Mitglieder, die den Plan schon haben, stehen in alreadyOnPlanUserIds und bleiben unverändert. Jedes Mitglied, das auf einen Plan ohne freien Seat wechselt, fügt einen berechneten Seat hinzu. Die Seat-Änderung wird gespeichert, bevor das Abo-Update an Stripe geht. Nutzungslimit-Anfragen folgen denselben Regeln wie ein einzelner Planwechsel: business_max schließt verknüpfte offene Anfragen, business schließt keine. Dieser Aufruf nimmt kein usageRequestId entgegen.
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.