> ## 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-Nutzungslimit einer Gruppe setzen

> Setze das Extra-Nutzungslimit, das für jedes Mitglied einer Gruppe gilt

Lies Gruppen und setze ein Extra-Nutzungslimit für jedes Mitglied einer Gruppe. Das Limit ist kein gemeinsamer Topf. 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 fügt keine Gruppenmitglieder hinzu und entfernt keine.

> [!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/groups/{groupId}/extra-usage-limit
```

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

## Extra-Nutzungslimit setzen

`PUT /groups/{groupId}/extra-usage-limit` nimmt das Limit direkt entgegen.

```json theme={null}
{ "type": "limited", "amount": 200 }
```

`{ "type": "unlimited" }` entfernt die Zahlenobergrenze. Ein begrenzter Betrag darf null sein. Dieser Wert akzeptiert weder `inherit` noch `none`.

Für jedes Mitglied mit `inherit` ist das Extra-Nutzungslimit der höhere Wert aus Plan-Standard und diesem Gruppenlimit. Ein explizites Limit des Mitglieds gewinnt trotzdem. Ein unbegrenztes Gruppenlimit hebt das Workspace-Limit nicht auf und überschreibt ausgeschaltete Extra-Nutzung nicht. Unter [Extra-Nutzung: Nutzer abrufen](https://docs.langdock.com/de/developer/billing-api/get-included-user.md) steht, wie die effektive Quelle gewählt wird.

SCIM-verwaltete Gruppen akzeptieren diese Änderung. Die Mitgliedschaft bleibt beim Identity Provider.

Die Antwort ist das Gruppenobjekt.

> [!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.