> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Budgets

> Erfahren Sie, wie Enterprise-Budgets einen ACU-Limit-Baum bilden, wie Sie monatliche Zeitfenster und Nutzerebenen pro Budget festlegen und wie Sie Budgets über die API verwalten.

Mit Budgets begrenzen Sie die ACU-Nutzung entsprechend der Organisationsstruktur Ihres Unternehmens: ein Limit für das gesamte Konto, gemeinsame Pools für Teams oder Projekte und Limits pro Benutzer innerhalb der einzelnen Pools.

## Beispielhafte Anwendungsfälle

### Abteilungen mit beauftragten Administratoren

Acme Corp hat 10 Abteilungen. Jede Abteilungsleitung verwaltet die Limits ihrer Organisationen. Die zentrale IT legt das Gesamtlimit jeder Abteilung fest. Dieses Beispiel zeigt zwei davon.

Alice, die Enterprise-Administratorin, erstellt unter dem Account-Budget für jede Abteilung ein eigenes Budget. Jedes davon teilt sie mit dem zuständigen Abteilungsadministrator. Jeder Abteilungsadministrator erstellt wiederum für jede seiner Organisationen ein Budget.

![Account-Budget von 100,000 ACU mit Engineering bei 30,000 ACU, darunter Payments und Search, sowie Marketing bei 5,000 ACU.](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/budget-departments.svg?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=bfecc16bdf0286471712d39161e2567c)

Abteilungsbudgets unter dem Account-Budget

* Bob, der Administrator der Abteilung Engineering, kann für jedes Budget unter Engineering Limits und temporäre Limits festlegen. Zum Beispiel kann er Payments für eine arbeitsintensive Woche ein temporäres Limit von 6,000 ACU zuweisen.
* Bob kann das Limit von 30,000 ACU für Engineering nicht erhöhen. Das kann nur Alice.
* Die Nutzung in allen Engineering-Organisationen wird auf das Limit von 30,000 ACU angerechnet, auch wenn die Organisationsbudgets zusammen mehr ergeben.

![Seite „Budgets“ aus Sicht eines Abteilungsadministrators](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-tree.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cd8d27a58bfeb28446df8597ac4c2dc1)

Die Seite „Budgets“ aus Sicht eines Abteilungsadministrators, mit gesperrtem Account-Budget

![Limit eines untergeordneten Budgets erhöhen](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-edit-child.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=1c1c05e9681f2e62a5b95b344f476a41)

Ein Abteilungsadministrator erhöht das Limit eines untergeordneten Budgets

![Limit des Abteilungsbudgets ist schreibgeschützt](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-own-limit.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=55c58f67119cb0af4c2f17d1db5d1f0a)

Ein Abteilungsadministrator kann das Limit des Abteilungsbudgets nicht ändern

### Ein Projektbudget mit höheren Nutzer-Limits

Jeder Entwickler erhält 200 ACUs pro Monat. Für die Migrationsinitiative stellt Acme Corp zusätzlich 5,000 ACUs bereit und gewährt den Projektbeteiligten ein höheres Kontingent.

Belassen Sie die Developer-tools-Organisationen in einem Budget „Developer tools“ mit einer Standardstufe von 200 ACU. Erstellen Sie ein Budget „Migration initiative“ mit einem Limit von 5,000 ACU. Ordnen Sie diesem Budget die Organisation des Projekts zu und legen Sie eine Standardstufe von 1,000 ACU fest. Beide Budgets sind dem Account-Budget untergeordnet.

![Developer tools mit 20,000 ACU und einer Standardstufe von 200 ACU sowie Migration initiative mit 5,000 ACU und einer Standardstufe von 1,000 ACU.](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/budget-project.svg?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cb189c909fb5c07095bd6d1f2c406cd6)

Die Budgets „Developer tools“ und „Migration initiative“ mit ihren Ebenen

* Carol, Entwicklerin im Projekt, kann in der Migration-Organisation bis zu 1,000 ACUs nutzen, in den Developer-tools-Organisationen bis zu 200 ACUs.
* Das gesamte Projekt kann pro Monat nie mehr als 5,000 ACUs verbrauchen.

![Budgetauswahl unter „Meine Analysen“](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/my-analytics-multi-budget.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cf5fd4ca8608b542fec5484fb003985c)

Budgetauswahl unter „Meine Analysen“ mit mehreren Budgets

## So funktionieren Budgets

### Budget-Baum

Jedes Enterprise-Konto hat genau einen Budget-Baum. Der Root bildet das **Account budget**, darunter liegen untergeordnete Budgets. Ein Baum kann bis zu drei Ebenen tief sein.

Ein Budget kann eine oder mehrere Organisationen enthalten. Jede Organisation gehört zu genau einem Budget. Neue Organisationen werden dem Account budget zugeordnet.

Zum Beispiel legt Acme Corp für sein Account budget ein Limit von 100,000 ACU fest. Engineering teilt seinen Pool auf drei untergeordnete Budgets auf.

![Account budget mit 100,000 ACU, darunter Engineering mit 40,000 ACU und seinen drei untergeordneten Budgets sowie Developer tools mit 20,000 ACU und drei Ebenen für Nutzerlimits.](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/budget-tree.svg?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=923ef86ef029390214dbdd478d4f9328)

Budget-Baum mit Budgets und Ebenen für Nutzerlimits

Ebenen sind Limits pro Nutzer innerhalb eines Budgets, keine eigenständigen Budgets.

![Budget-Baum mit Auslastung pro Budget](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/tree.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=70ff5c75cc82a29a77669afc77de160f)

Budget-Baum mit Auslastung pro Budget (Beispieldaten)

### Budget-Limits

Ein Budget-Limit begrenzt die gemeinsame ACU-Nutzung der Organisationen des Budgets und der Organisationen in seinen untergeordneten Budgets innerhalb eines monatlichen Zeitfensters. Ein `null`-Limit bedeutet unbegrenzt.

* **Die Nutzung wird auf jedes übergeordnete Budget angerechnet.** Die Nutzung in einem untergeordneten Budget wird auch auf dessen übergeordnetes Budget und auf das Account-Budget angerechnet.
* **Ein ausgeschöpftes übergeordnetes Budget blockiert seine untergeordneten Budgets.** Sobald ein Budget auf dem Pfad aufgebraucht ist, wird die Nutzung in diesem Zweig gestoppt.
* **Die Limits untergeordneter Budgets können in Summe das Limit des übergeordneten Budgets übersteigen.** Das Limit des übergeordneten Budgets begrenzt trotzdem ihre gemeinsame Nutzung.
* **Auch ein Budget ohne Limit wird durch seine übergeordneten Budgets begrenzt.**

Ein Budget, das mit genau einer Organisation verknüpft ist, teilt sein Limit mit dieser Organisation. Auch die veralteten [Endpunkte für ACU-Limits auf Organisationsebene](https://docs.devinenterprise.com/de/admin/billing/org-acu-limits#organization-endpoints) legen dieses Limit fest. Alternativ können Sie den unten beschriebenen [Update-Endpunkt](#update-a-budget) verwenden.

### Was passiert, wenn ein Budget aufgebraucht ist

Ist ein Budget aufgebraucht, wird die Nutzung für die zugehörigen Organisationen gestoppt. Das gilt auch, wenn ein übergeordnetes Budget aufgebraucht ist. Die Nutzung ist im nächsten Zeitfenster wieder möglich oder sobald ein Administrator das Limit erhöht oder ein temporäres Limit festlegt.

* **Devin-Sitzungen:** Neue Sitzungen können nicht gestartet werden, und laufende Sitzungen wechseln in den Ruhezustand. Nutzer sehen die Meldung „Increase your organization's usage limit.“
* **Devin CLI und lokaler Agent in Desktop:** Anfragen werden blockiert. Nutzer sehen die Meldung „Your organization has reached its monthly usage limit. Ask an account admin to raise it, or wait for the limit to reset next month.“
* **Devin Review:** Neue Reviews werden blockiert.

![Composer-Banner: Nutzungslimit erreicht](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/cloud-limit-reached.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=b4183e12594ad3d8d84eb223dc6d1246)

Composer-Banner bei aufgebrauchtem Budget

### Monatliches Zeitfenster

Budget-Limits, Nutzer-Limits und temporäre Limits werden zu Beginn jedes monatlichen Zeitfensters zurückgesetzt. Jedes Zeitfenster beginnt am Starttag Ihrer Abrechnungsphase und entspricht daher nicht unbedingt dem Kalendermonat.

Beginnt die Abrechnungsphase zum Beispiel am 15., laufen die Zeitfenster vom 15. Oktober bis 14. November, dann vom 15. November bis 14. Dezember.

Ein **temporäres Limit** ersetzt das Budget-Limit für den Rest des aktuellen Zeitfensters. Im nächsten Zeitfenster gilt wieder das dauerhafte Limit. Eine temporäre Nutzerüberschreibung läuft am Ende des aktuellen Zeitfensters ab.

![Marketing-Budget mit einem temporären Limit](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/limits-temporary.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=8a19713130eef30fae3153e10400f77d)

Ein temporäres Limit erhöht das Marketing-Budget nur für dieses Zeitfenster auf 6,000 ACUs

### Nutzerlimits in einem Budget

Nutzerlimits begrenzen, wie viel eine einzelne Person innerhalb eines monatlichen Zeitfensters verbrauchen kann. Jedes Budget mit einer verknüpften Organisation hat eigene Nutzerlimits, die ausschließlich innerhalb dieses Budgets gelten.

* **Ebenen.** Jedes Budget hat eigene Ebenen und genau eine Standardstufe. Eine Ebene legt das monatliche ACU-Limit für ihre Mitglieder fest.
* **IdP-Gruppenzuordnungen.** Ordnen Sie eine Gruppe aus Ihrem Identity Provider einer Ebene zu. Mitglieder der Gruppe werden dann dieser Ebene zugewiesen.
* **Überschreibungen.** Legen Sie für einen einzelnen Nutzer ein dauerhaftes oder befristetes Limit fest.
* **Anfragerichtlinien.** Jede Ebene legt fest, wie Anfragen zur Limiterhöhung behandelt werden. `unconditional` und `conditional` genehmigen Anfragen bis zum `max_limit` der Ebene. `manual` leitet Anfragen zur Prüfung an einen Administrator weiter.
* **Geltungsbereich.** Für ein Nutzerlimit zählt nur die Nutzung des Nutzers in den Organisationen dieses Budgets.
* **Kopieren und löschen.** Kopieren Sie Ebenen aus einem anderen Budget oder aus dem Konto. Sie können auch IdP-Gruppenzuordnungen, Zuweisungen und Überschreibungen kopieren. Um neu zu beginnen, löschen Sie alle Ebenen in einem Budget.

> [!WARNING]
>
> Ein Nutzerlimit für ein übergeordnetes Budget gilt nicht für dessen untergeordnete Budgets. Wenn Engineering zum Beispiel selbst ebenfalls eine Organisation enthält, begrenzt ein Nutzerlimit von 300 ACU für Engineering nicht die Nutzung eines Nutzers in Payments oder Search.

![Dialog „Nutzungsrichtlinien kopieren“](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/copy-policies.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cc1c5fce8d56e535d8502eab0501729b)

Dialog „Nutzungsrichtlinien kopieren“ mit Developer tools als Quelle

### Wer ein Budget verwalten kann

Enterprise-Admins verwalten Budgets in **Enterprise Settings** unter **Budgets**. Sie verwalten den gesamten Baum, einschließlich des Account-Budgets.

* **Delegation.** Ein Enterprise-Administrator kann ein Budget auf der Registerkarte „Manage access“ für eine Person oder Gruppe freigeben. Ein beauftragter Administrator kann darunter Budgets erstellen sowie Limits und temporäre Limits für diese untergeordneten Budgets festlegen. Die Delegation muss separat aktiviert werden; wenden Sie sich dazu an Ihr Kundenbetreuungsteam.
* **Ein beauftragter Administrator kann das Limit des freigegebenen Budgets selbst nicht erhöhen.** Das kann nur ein Administrator, der das übergeordnete Budget verwaltet.
* **Mitglieder** sehen ihre eigene Nutzung und ihr Limit unter „Meine Analysen“.

![Registerkarte „Manage access“ des Engineering-Budgets](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-access.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=58dc7d60892a7eba7a56297055dacd8f)

Registerkarte „Manage access“ des Engineering-Budgets mit Bob als Manager

## Häufig gestellte Fragen

> [accordion] Können Organisationsadministratoren das ACU-Limit einer Organisation festlegen?
>
> Nein. ACU-Limits für Organisationen legen Enterprise-Admins fest. Wenn ein Team seine Limits selbst verwalten soll, geben Sie ein Budget für den Administrator des Teams frei.

> [accordion] Warum gibt der Org-Limit-Endpunkt 409 zurück?
>
> Sobald Budget-Limits für Ihr Unternehmen erzwungen werden, gibt der Org-Limit-Endpunkt HTTP `409` zurück, wenn die Organisation ihr Budget mit anderen Organisationen teilt oder direkt dem Account-Budget zugeordnet ist. Die Fehlermeldung lautet: „This organization has no limit of its own. Set the limit on its budget.“ Wenn sich zum Beispiel Globex, Initech und Umbrella ein Budget teilen, gibt ein Schreibzugriff auf das Limit von Globex `409` zurück.

> [accordion] Wann werden Limits zurückgesetzt?
>
> Zu Beginn jedes monatlichen Zeitfensters. Das Zeitfenster beginnt am Starttag Ihrer Abrechnungsphase.

> [accordion] Kann eine Organisation zu zwei Budgets gehören?
>
> Nein. Jede Organisation gehört zu genau einem Budget. Ein Budget kann jedoch mehrere Organisationen umfassen.

## Budgets mit der V3-API verwalten

Alle Anfragen werden mit einem Enterprise-**Service-User-Token** authentifiziert. Aufrufende benötigen die Kontoberechtigung **ManageAcuLimits** oder [delegierten Zugriff](#who-can-manage-a-budget) auf das Budget. Verwenden Sie `https://api.devin.ai` als Base URL. In der [V3-API-Übersicht](https://docs.devinenterprise.com/de/api-reference/v3/overview.md) finden Sie Hinweise zur Authentifizierung und zu Service-Benutzern.

Budgetbezogene Collection-Endpunkte erwarten das Budget im Pfad: `/v3beta1/enterprise/usage-policies/budgets/{budget_id}/...`. Endpunkte, die eine einzelne Ebene oder Anfrage adressieren (`/tiers/{tier_id}`, `/requests/{request_id}`), beziehen das Budget aus der Ebene bzw. Anfrage und nutzen daher dieselben Pfade wie die kontoweiten Endpunkte.

### PATCH-Semantik

Für die `PATCH`-Endpunkte gilt:

* Ein weggelassenes Feld bleibt unverändert.
* Ein auf `null` gesetztes Feld wird gelöscht.
* Ein auf einen Wert gesetztes Feld wird erstellt oder aktualisiert.

## Budget-Endpunkte

### Budgets auflisten

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets
```

Gibt eine paginierte Liste aller aktiven und archivierten Budgets des Kontos zurück. Jedes Budget hat folgende Struktur:

```json theme={null}
{
  "budget_id": "budget-abc123",
  "name": "Engineering",
  "parent_budget_id": "budget-root",
  "org_ids": ["org-xyz789"],
  "status": "active",
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": null
}
```

* `budget_id`: der Bezeichner, der in budgetbezogenen Pfaden verwendet wird.
* `parent_budget_id`: das übergeordnete Budget; `null` beim Root-Budget des Kontos.
* `org_ids`: die mit diesem Budget verknüpften Organisationen. Ihre Nutzung wird auf dieses Budget angerechnet. Leer, wenn keine Organisation verknüpft ist.
* `status`: `active` oder `archived`.
* `cycle_acu_limit`: das Limit des Budgets für den ACU-Verbrauch, der ihm und seinen untergeordneten Budgets pro monatlichem Abrechnungszeitraum angerechnet wird; `null` bedeutet unbegrenzt.
* `temporary_cycle_acu_limit`: ein Limit, das `cycle_acu_limit` bis zum Ende des aktuellen monatlichen Abrechnungszeitraums überschreibt; `null`, wenn derzeit keines gilt.

### Ein Budget aktualisieren

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}
```

Partielles Update: Weggelassene Felder bleiben unverändert, und `null` löscht ein Limit. Mindestens ein Feld ist erforderlich.

* `parent_budget_id`: Verschiebt das Budget samt seinen Unterbudgets unter ein anderes aktives Budget. Das Root-Budget kann nicht verschoben werden, und Budgets lassen sich höchstens drei Ebenen tief verschachteln.
* `cycle_acu_limit`, `temporary_cycle_acu_limit`: Die Limits des Budgets, wie in der Antwort des List-Endpunkts.

**Request-Body — Limit und eine temporäre Erhöhung für diesen Monat festlegen**

```json theme={null}
{
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": 2500
}
```

**Request-Body – Limits entfernen**

```json theme={null}
{
  "cycle_acu_limit": null,
  "temporary_cycle_acu_limit": null
}
```

**Request-Body – Budget einem anderen Budget unterordnen**

```json theme={null}
{
  "parent_budget_id": "budget-platform"
}
```

Gibt das aktualisierte Budget zurück. Wird `temporary_cycle_acu_limit` erneut gesetzt, startet es für das aktuelle Zeitfenster neu. Bei einem Budget, das mit genau einer Organisation verknüpft ist, wird `cycle_acu_limit` außerdem zum ACU-Limit der Organisation.

## Ebenen-Endpunkte

### Ebenen auflisten

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

Gibt eine paginierte Liste der Ebenen des Budgets, sortiert nach Vorrang, zurück: Ebenen mit der höchsten `priority` zuerst, innerhalb derselben Priorität die neueste Ebene zuerst. Eine Ebene sieht wie folgt aus:

```json theme={null}
{
  "tier_id": "tier-abc123",
  "name": "Engineers",
  "is_default": true,
  "cycle_acu_limit": 500,
  "policy": "manual",
  "max_limit": null,
  "priority": 0,
  "member_count": 42,
  "created_at": 1735689600
}
```

* `is_default`: gibt an, ob dies die Standardebene des Budgets ist.
* `cycle_acu_limit`: das standardmäßige ACU-Limit pro Zyklus für jedes Mitglied; `null` bedeutet unbegrenzt.
* `policy`: legt fest, wie Anfragen zur Erhöhung des Limits für die Ebene behandelt werden – `unconditional` und `conditional` genehmigen bis zu `max_limit`, `manual` erfordert ein Review durch einen Administrator.
* `max_limit`: das maximale Limit, bis zu dem Anfragen zur Erhöhung des Limits genehmigt werden; bei `null` wird ohne Obergrenze genehmigt. Immer `null`, wenn `cycle_acu_limit` `null` ist.
* `priority`: bestimmt den Rang der Ebene unter den IdP-Gruppen zugeordneten Ebenen eines Nutzers – der höchste Wert hat Vorrang, bei Gleichstand entscheidet die neueste Ebene. Eine explizite Zuweisung eines Nutzers hat Vorrang vor dieser Rangfolge; die Standardebene wird nie in die Rangfolge einbezogen.
* `member_count`: die Anzahl der Nutzer, die sich aktuell in der Ebene befinden. Bei der Standardebene werden alle Budget-Mitglieder gezählt, die keiner anderen Ebene angehören.

### Ebene erstellen

```http theme={null}
POST /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

**Request-Body**

```json theme={null}
{
  "name": "Engineers",
  "cycle_acu_limit": 500,
  "policy": "manual"
}
```

Die erste Ebene eines Budgets wird automatisch zu dessen Standardstufe. Gibt HTTP `201` mit der erstellten Ebene zurück.

### Ebene abrufen

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

### Eine Ebene aktualisieren

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

Teilweises Update; nicht angegebene Felder bleiben unverändert.

```json theme={null}
{
  "name": "Engineering",
  "cycle_acu_limit": 750
}
```

### Ebene löschen

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

Gibt bei Erfolg HTTP `204` zurück. Die Standardstufe kann nicht gelöscht werden (machen Sie zuerst eine andere Ebene zur Standardstufe). Bevor eine Ebene gelöscht werden kann, müssen alle ihre Nutzer verschoben und sämtliche IdP-Gruppenzuordnungen zu dieser Ebene entfernt werden.

## Endpunkte für Ebenen-Nutzer

### Nutzer einer Ebene auflisten

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users
```

Gibt eine paginierte Liste der Nutzer dieser Ebene samt ihren ermittelten Limits zurück. Bei der Standardstufe umfasst sie alle Mitglieder des Budgets, die keiner anderen Ebene zugeordnet sind:

```json theme={null}
{
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "cycle_acu_limit_override": null,
  "temporary_cycle_acu_limit": 800,
  "effective_cycle_acu_limit": 800,
  "limit_source": "temporary_override",
  "membership": "explicit"
}
```

* `cycle_acu_limit_override`: die dauerhafte Überschreibung des Nutzers, sofern vorhanden.
* `temporary_cycle_acu_limit`: die temporäre Überschreibung des Nutzers; nur vorhanden, solange sie im aktuellen monatlichen Abrechnungszeitraum gilt.
* `effective_cycle_acu_limit`: das Limit, das derzeit für den Nutzer durchgesetzt wird; `null` bedeutet unbegrenzt.
* `limit_source`: Herkunft des effektiven Limits – `override` (dauerhaft), `temporary_override` oder `tier`.
* `membership`: Grund für die Zugehörigkeit des Nutzers zur Ebene – `explicit` (direkt zugewiesen), `idp_group` (über seine maßgebliche IdP-Gruppenzuordnung) oder `default` (Rückgriff auf die Standardstufe).

### Einen Nutzer einer Ebene zuweisen

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

Idempotent. Gibt bei Erfolg HTTP `204` zurück. Wird ein Nutzer aus einer anderen Ebene verschoben, wird jede benutzerspezifische Überschreibung gelöscht, sodass er zunächst das Limit der Zielebene erbt.

### Nutzer aus einer Ebene entfernen

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

Entfernt die explizite Ebenenzuweisung des Nutzers (einschließlich etwaiger Überschreibungen). Der Nutzer bezieht anschließend die seiner IdP-Gruppe zugeordnete Ebene, sofern vorhanden, andernfalls die Standardebene. Gibt bei Erfolg HTTP `204` zurück.

## Nutzer-Endpunkte

### Limits eines Nutzers abrufen

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

Gibt die ermittelte Ebene, die Limits und die ausstehende Anfrage des Nutzers innerhalb des Budgets zurück. Enthält die oben beschriebenen [Nutzerfelder der Ebene](#list-a-tiers-users) sowie:

```json theme={null}
{
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "tier_cycle_acu_limit": 500,
  "pending_request_id": null,
  "pending_request_cycle_acu_limit": null
}
```

* `tier_id` / `tier_name`: die Ebene, aus der sich das Limit des Nutzers ergibt (explizite Zuweisung, IdP-Gruppenzuordnung oder die Standardstufe); `null`, wenn das Budget keine Ebenen hat.
* `tier_cycle_acu_limit`: das eigene Limit der Ebene vor einer etwaigen Überschreibung; `null` bedeutet unbegrenzt.
* `pending_request_id` / `pending_request_cycle_acu_limit`: die ausstehende Anfrage des Nutzers zur Erhöhung des Limits und das darin angefragte Limit, sofern vorhanden.

### Überschreibung für einen Nutzer festlegen oder löschen

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

Nutzerbezogen: Das Ziel muss lediglich Mitglied des Budgets sein – es ist keine Ebene beteiligt, und die Ebenenzuweisung des Nutzers wird nie geändert.

**Request-Body – temporäre Überschreibung festlegen**

```json theme={null}
{
  "cycle_acu_limit": 800,
  "kind": "temporary"
}
```

`kind` ist beim Festlegen eines Werts erforderlich: `permanent` läuft nie ab, `temporary` läuft am Ende des aktuellen monatlichen Abrechnungszeitraums ab.

**Request-Body – alle Überschreibungen löschen**

```json theme={null}
{
  "cycle_acu_limit": null
}
```

Der Endpunkt gibt bei Erfolg HTTP `204` zurück.

## IdP-Gruppen-Endpunkte

Ordnen Sie eine IdP-Gruppe einer Ebene zu, damit deren Member diese Ebene automatisch erben. Zuordnungen werden live anhand der Gruppenmitgliedschaft ermittelt und ändern nie die explizite Ebenen-Zuweisung eines Nutzers – eine explizite Zuweisung hat immer Vorrang. Ist ein Nutzer Mitglied mehrerer zugeordneter Gruppen, gilt für ihn die am höchsten eingestufte zugeordnete Ebene (höchste `priority` der Ebene; bei Gleichstand entscheidet die neueste Ebene).

### IdP-Gruppenzuordnungen auflisten

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups
```

Gibt eine paginierte Liste der Zuordnungen von Gruppen zu Ebenen für das Budget zurück, sortiert vom ältesten zum neuesten Eintrag. Filtern Sie mit `?tier_id=`, um nur die Gruppen aufzulisten, die einer bestimmten Ebene zugeordnet sind:

```json theme={null}
{
  "idp_group_id": "grp_abc123",
  "idp_group_name": "Engineering",
  "tier_id": "tier-abc123"
}
```

### Zuordnung einer IdP-Gruppe abrufen

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

Gibt HTTP `404` zurück, wenn für die Gruppe im Budget keine Zuordnung vorhanden ist.

### Eine IdP-Gruppe einer Nutzungsstufe zuordnen

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

**Request-Body**

```json theme={null}
{
  "tier_id": "tier-abc123"
}
```

Idempotenter Upsert. Die Ebene muss zum Budget gehören. Eine Gruppe kann pro Budget höchstens einer Ebene zugeordnet sein. Wird eine bereits zugeordnete Gruppe erneut zugeordnet, wird sie daher in die angegebene Ebene verschoben.

### Zuordnung einer IdP-Gruppe aufheben

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

Gibt bei Erfolg HTTP `204` zurück. Die zugeordnete Ebene gilt dann nicht mehr für die Mitglieder der Gruppe; Nutzer ohne explizite Zuweisung und ohne andere zugeordnete Ebene fallen auf die Standardebene zurück.

## Endpunkte für Anfragen zur Erhöhung des Limits

Nutzer können ein höheres Limit pro Abrechnungszyklus anfragen. Was dann passiert, hängt von der `policy` der Ebene ab, der der anfragende Nutzer zugeordnet ist: Bei `unconditional` und `conditional` werden Anfragen bis zum `max_limit` der Ebene automatisch genehmigt, bei `manual` wird die Anfrage zurückgehalten, bis ein Administrator sie über diese Endpunkte prüft (Review).

### Anfragen zur Erhöhung des Limits auflisten

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/requests
```

Gibt eine paginierte Liste der Anträge für dieses Budget zurück, die sich mit `?status=` (`pending`, `approved`, `denied`, `expired`) und `?user_id=` filtern lässt:

```json theme={null}
{
  "request_id": 42,
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "current_cycle_acu_limit": 500,
  "requested_cycle_acu_limit": 800,
  "message": "Wrapping up a large migration this month",
  "status": "pending",
  "created_at": 1735689600,
  "reviewed_at": null,
  "reviewer": null
}
```

* `tier_id` / `tier_name`: die Ebene des Antragstellers innerhalb des Budgets; `null`, wenn das Budget keine Ebenen hat.
* `current_cycle_acu_limit`: das derzeit für den Antragsteller geltende Limit; `null` bedeutet unbegrenzt.
* `status`: `expired` bedeutet, dass die Anfrage zum Ende ihres Abrechnungszyklus noch offen war.
* `reviewer`: der Administrator, der die Anfrage geprüft hat; `null`, solange sie noch offen ist.

### Anfrage zur Erhöhung des Limits abrufen

```http theme={null}
GET /v3beta1/enterprise/usage-policies/requests/{request_id}
```

### Anfrage zur Erhöhung des Limits genehmigen

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/approve
```

Gewährt das angeforderte Limit als **temporäre Überschreibung**, die am Ende des aktuellen monatlichen Abrechnungszeitraums abläuft. Optional können Sie stattdessen ein anderes Limit gewähren:

```json theme={null}
{
  "cycle_acu_limit": 700
}
```

Gibt die aktualisierte Anfrage zurück. Gibt HTTP `409` zurück, wenn die Anfrage bereits geprüft wurde oder der Anfragende kein Konto-Member mehr ist.

### Anfrage zur Erhöhung des Limits ablehnen

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/deny
```

Gibt die aktualisierte Anfrage zurück oder HTTP `409`, falls die Anfrage bereits geprüft wurde.

## Beispiel-Arbeitsabläufe

### Ebenen eines Budgets einrichten

Suchen Sie das Budget, begrenzen Sie es auf 2.000 ACUs pro Monat und erstellen Sie dann eine Standardstufe, damit jedes Mitglied des Budgets eine monatliche Obergrenze von 500 ACU erhält:

```bash theme={null}
curl "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets" \
  -H "Authorization: Bearer <token>"

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 2000}'

curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Standard", "cycle_acu_limit": 500, "policy": "manual"}'
```

Ordnen Sie der Ebene eine IdP-Gruppe zu und gewähren Sie einem Nutzer für den Rest des Monats eine vorübergehende Erhöhung:

```bash theme={null}
curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/idp-groups/Engineering" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"tier_id": "tier-abc123"}'

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/users/user_abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 800, "kind": "temporary"}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.