> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extra-Nutzung: Pläne in einem Rutsch setzen

> Setze einen Business- oder Business-Max-Plan für bis zu 500 Mitglieder in einem Aufruf

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](https://docs.langdock.com/de/developer/user-management-api/user-management-overview.md).

> [!NOTE]
>
> 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

```
https://api.langdock.com/billing/v1/ai-models-included/users/plan/bulk
```

## 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.

```json theme={null}
{
  "userIds": [
    "11111111-1111-4111-8111-111111111111",
    "55555555-5555-4555-8555-555555555555"
  ],
  "plan": "business_max"
}
```

```json theme={null}
{
  "plan": "business_max",
  "updatedUserIds": ["11111111-1111-4111-8111-111111111111"],
  "alreadyOnPlanUserIds": ["55555555-5555-4555-8555-555555555555"]
}
```

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.

> [!NOTE]
>
> 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](https://docs.langdock.com/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.