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

> Setze das Extra-Nutzungslimit eines Mitglieds oder stell die Vorgabe von Plan und Gruppe wieder her

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/{userId}/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
* `USER_MANAGEMENT_API` am selben Schlüssel, wenn du `email`, `name` oder einen E-Mail-Filter brauchst

## Extra-Nutzungslimit setzen

`PUT /users/{userId}/extra-usage-limit` nimmt das Limit direkt entgegen. Es gibt kein Hüllenfeld.

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

`{ "type": "inherit" }` stellt die Vorgaben von Plan und Gruppe wieder her. `{ "type": "unlimited" }` entfernt die persönliche Obergrenze. Ein begrenzter Betrag darf null sein. Dieser Wert akzeptiert kein `none`.

Ein explizites Limit schlägt den Plan und jede Gruppe. Bei `inherit` gilt das höhere Limit aus Plan und Gruppe. Unter [Extra-Nutzung: Nutzer abrufen](https://docs.langdock.com/de/developer/billing-api/get-included-user.md) steht, wie `effective.source` gewählt wird. Ist die Extra-Nutzung aus, oder greift das Extra-Nutzungslimit des Workspace, gilt das auch über einem unbegrenzten persönlichen Limit.

War das effektive Limit begrenzt und ist das neue effektive Limit höher oder unbegrenzt, wird die offene Nutzungslimit-Anfrage des Mitglieds geschlossen. Dasselbe oder ein niedrigeres Limit lässt die Anfrage offen. Ohne `usageRequestId` wird das Limit gespeichert, auch wenn das Schließen der Anfrage fehlschlägt.

Übergib `usageRequestId` in der Query, um genau diese Anfrage im selben Schreibzugriff zu beantworten. Das Limit wird nur gespeichert, wenn die Anfrage zu diesem Mitglied gehört, noch offen ist und das effektive Limit wie oben steigt. Sonst wird nichts geschrieben. Fehlt die Anfrage oder gehört sie nicht zu diesem Mitglied, kommt `404` mit `code` `NOT_FOUND`. Ist sie nicht mehr offen, kommt `409` mit `code` `USAGE_REQUEST_NOT_PENDING`. Steigt das Kontingent nicht, kommt `409` mit `code` `USAGE_REQUEST_NOT_ANSWERED`. Die Anfrage bleibt offen.

Die Antwort ist das Mitgliedsobjekt mit `extraUsagePeriodSpend` auf `null`.

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