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

> Liste Agenten mit monatlichem Budget, Budget-Modus und Ausgaben in Euro

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

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

`limit` ist standardmäßig 50 und höchstens 250. Gib `cursor` aus `nextCursor` zurück.

Wenn die Ausgaben pro Nutzer ausgeblendet sind, fehlen nicht geteilte Agenten in der Liste. Einen solchen Agenten zu lesen oder zu ändern gibt `404` zurück und ändert nichts. Geteilte Agenten bleiben in der Liste, mit `budgetPeriodSpend` auf `null`.

Ein gesetztes Agent-Budget wird nur durchgesetzt, solange die Extra-Nutzung an ist. Siehe [Extra-Nutzung: Agent-Budget ändern](https://docs.langdock.com/de/developer/billing-api/update-included-agent-budget.md).

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