Zum Hauptinhalt springen
POST
Set plans for 1 to 500 users
Liste aktive menschliche Mitglieder, ändere einen Plan und setze das Extra-Usage-Budget über dem enthaltenen Kontingent. Beträge sind US-Dollar. 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.

Basis-URL

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

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, kommt 400 mit diesen IDs in details.userIds und es ändert sich nichts. Mitglieder, die den Plan schon haben, stehen in alreadyOnPlanUserIds und bleiben unverändert. Für Nutzungsanfragen gelten dieselben Regeln wie beim einzelnen Planwechsel: power_user schließt verknüpfte offene Anfragen, standard schließt keine.
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
userIds
string<uuid>[]
erforderlich
Required array length: 1 - 500 elements
plan
enum<string>
erforderlich
Verfügbare Optionen:
standard,
power_user

Antwort

Successful response.

plan
enum<string>
erforderlich
Verfügbare Optionen:
standard,
power_user
updatedUserIds
string<uuid>[]
erforderlich
alreadyOnPlanUserIds
string<uuid>[]
erforderlich