> ## 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: Agent-Budget ändern

> Setze das monatliche Euro-Budget eines Agenten und wann es gilt

Lies und ändere monatliche Agent-Budgets in Euro. Nutze für diesen Workspace-Modus das Präfix `ai-models-included`.

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.

> [!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/agents/{agentId}
```

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

## Budget ändern

`PATCH /agents/{agentId}` akzeptiert `budget`, `budgetMode` oder beides. Schick mindestens eines.

```bash theme={null}
curl -X PATCH https://api.langdock.com/billing/v1/ai-models-included/agents/33333333-3333-4333-8333-333333333333 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"budget":{"type":"limited","amount":40},"budgetMode":"always"}'
```

`budget` ist ein monatlicher Betrag in Euro:

* `{ "type": "limited", "amount": 40 }` setzt eine Obergrenze. Der Betrag muss größer als null sein.
* `{ "type": "unlimited" }` behält ein eigenes Budget ohne Zahlenobergrenze. Die Ausgaben können trotzdem gemeldet werden. Das ist nicht dasselbe wie `none`.
* `{ "type": "none" }` entfernt das eigene Agent-Budget. Der Agent folgt dann den Limits von Workspace und Mitglied.

`budgetMode` legt fest, wann dieses Budget gilt:

* `always` (**Immer**) zählt die Nutzung sofort gegen das Agent-Budget, auch API-Aufrufe, und verbraucht das Kontingent des Mitglieds nicht.
* `on_limit_hit` (**Nach Nutzerlimits**) zählt die Nutzung zuerst gegen die Limits des Mitglieds. Erst wenn das Mitglied ein persönliches Limit erreicht, zählt die Nutzung gegen das Agent-Budget.

Das Budget wird nur durchgesetzt, solange die Extra-Nutzung an ist. Ist sie aus, bleibt das gespeicherte Budget erhalten, gilt aber nicht, und die Ausgaben bleiben bei null. Ein aktives Agent-Budget folgt weiterhin dem Extra-Nutzungslimit des Workspace aus [Extra-Nutzung: Einstellungen abrufen](https://docs.langdock.com/de/developer/billing-api/get-included-settings.md). Das Budget zu entfernen schaltet dieses Limit nicht aus.

Die Antwort ist das Agent-Objekt mit `budgetPeriodSpend` auf `null`. Lies den Agenten danach erneut, um die Ausgaben zu bekommen.

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