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

# ACU-Obergrenzen pro Nutzer

> ACU-Limitüberschreibungen pro Nutzer über die Service-Schlüssel-API lesen und festlegen.

<Info>
  Diese Dokumentation gilt für die Federal Deployments von Devin. [Zurück zur Devin-Dokumentation](/de/get-started/devin-intro)
</Info>

Lesen und verwalten Sie ACU-Obergrenzenüberschreibungen pro Nutzer. Eine Nutzerüberschreibung hat Vorrang vor Team- und Gruppenlimits – siehe [ACU-Limits](/de/federal/acu-limits) für Informationen dazu, wie das wirksame Limit ermittelt wird. Diese Endpunkte sind nur in mandantenfähigen Federal Deployments verfügbar. Für Lesevorgänge verwenden sie **Teams Read-Only**, für Schreibvorgänge **Teams Update**.

Beide Endpunkte wählen den Nutzer über ein `user`-Objekt aus, das genau eines der folgenden Elemente enthält:

<ParamField body="user.email" type="string">
  Die E-Mail-Adresse des Nutzers.
</ParamField>

<ParamField body="user.user_id" type="string">
  Die stabile ID des Nutzers, wie sie von der API zurückgegeben wird, zum Beispiel in Zeilen für [Gruppenmitglieder](/de/federal/api/group-management#list-group-members) oder den [ACU-Verbrauch](/de/federal/api/acu-consumption).
</ParamField>

Auf Gruppen beschränkte Service-Schlüssel können nur aktuelle Member der ihnen zugewiesenen Gruppe auswählen; für andere Nutzer wird `not_found` zurückgegeben. Informationen zu Authentifizierung und Fehlern finden Sie in der [API-Übersicht](/de/federal/api/overview).

Das von beiden Endpunkten zurückgegebene Obergrenzenobjekt:

| Feld                         | Beschreibung                                                                                                                                                                           |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                    | Die stabile ID des Nutzers.                                                                                                                                                            |
| `email`                      | Die E-Mail-Adresse des Nutzers.                                                                                                                                                        |
| `configured_cycle_acu_limit` | Die direkte Überschreibung pro Nutzer, falls eine festgelegt ist. Ein Wert von `0` bedeutet, dass der Nutzer blockiert ist. Wird weggelassen, wenn keine Überschreibung vorhanden ist. |
| `effective_cycle_acu_limit`  | Die für den Nutzer tatsächlich durchgesetzte Obergrenze, nachdem die Überschreibung mit Team- und Gruppenlimits kombiniert wurde. Wird weggelassen, wenn kein Limit gilt.              |

***

<div id="get-a-users-acu-cap">
  ## ACU-Obergrenze eines Nutzers abrufen
</div>

```
POST /api/v1/GetUserAcuCap
```

```bash theme={null}
curl -X POST https://<your-server>/api/v1/GetUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"}
  }'
```

```json theme={null}
{
  "cap": {
    "userId": "user_abc",
    "email": "dev@agency.gov",
    "configuredCycleAcuLimit": 25,
    "effectiveCycleAcuLimit": 25
  }
}
```

<div id="set-or-clear-a-users-acu-cap">
  ## ACU-Obergrenze eines Nutzers festlegen oder aufheben
</div>

```
POST /api/v1/UpdateUserAcuCap
```

Genau einer der folgenden Werte muss angegeben werden:

<ParamField body="set_cycle_acu_limit" type="number">
  Legt das ACU-Limit des Nutzers pro Zyklus fest. Der Wert darf nicht negativ sein; `0` verhindert, dass der Nutzer ACUs verbraucht.
</ParamField>

<ParamField body="clear_cycle_acu_limit" type="boolean">
  Entfernt das individuelle Limit des Nutzers, sodass die Limits für Teams und Gruppen wieder gelten.
</ParamField>

```bash theme={null}
curl -X POST https://<your-server>/api/v1/UpdateUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"},
    "set_cycle_acu_limit": 25
  }'
```

Die Antwort enthält das aktualisierte `cap`-Objekt.

<Note>
  Eine Nutzerüberschreibung von `0` **sperrt** den Nutzer. Die API für Service-Schlüssel-Gruppen akzeptiert keine Gruppenobergrenze von null: `set_cycle_acu_limit` muss positiv sein, und `clear_cycle_acu_limit` entfernt die Gruppenüberschreibung. Die separate Operation für Gruppenlimits im Portal behandelt `0` als Aufhebung. Siehe [Null- und nicht gesetzte Werte](/de/federal/acu-limits#zero-and-unset-values).
</Note>