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

> Lies monatliches Budget, Budget-Modus und Ausgaben eines Agenten 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/{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

```json theme={null}
{
  "id": "33333333-3333-4333-8333-333333333333",
  "name": "Contract reviewer",
  "budget": { "type": "limited", "amount": 40 },
  "budgetMode": "always",
  "budgetPeriodSpend": 18.7
}
```

`name` kann `null` sein. `budgetPeriodSpend` ist `null`, wenn der Workspace die Ausgaben pro Nutzer ausblendet, und nach einem Schreibzugriff.

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 Budget wird nur durchgesetzt, solange die Extra-Nutzung an ist. Ist sie aus, gilt das gespeicherte Budget nicht und die Ausgaben bleiben bei 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.