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

# Nutzungskonfiguration einrichten

> Add-on‑Guthabenlimits pro Benutzer festlegen oder aufheben, mit der Möglichkeit, sie auf Team‑, Gruppen‑ oder Benutzerebene für die Enterprise‑Billing‑Verwaltung anzuwenden.

<div id="overview">
  ## Übersicht
</div>

Legen Sie nutzerspezifische Nutzungslimits für Add-on-Guthaben in Ihrer Organisation fest oder setzen Sie sie zurück. Limits werden immer pro Nutzer angewendet. Wenn Sie den Geltungsbereich auf ein Team oder eine Gruppe festlegen, wird das Limit für jeden Nutzer innerhalb dieses Teams bzw. dieser Gruppe individuell angewendet – es definiert kein gemeinsames Limit für das gesamte Team oder die gesamte Gruppe.

<div id="request">
  ## Anfrage
</div>

<ParamField body="service_key" type="string" required>
  Ihr Service-Schlüssel mit „Billing Write“-Berechtigungen
</ParamField>

<div id="credit-cap-configuration-choose-one">
  ### Konfiguration des Kreditlimits (eine Option wählen)
</div>

<ParamField body="clear_add_on_credit_cap" type="boolean">
  Auf `true` setzen, um das bestehende Add-on-Kreditlimit zurückzusetzen
</ParamField>

<ParamField body="set_add_on_credit_cap" type="integer">
  Ein neues Add-on-Kreditlimit festlegen (Ganzzahl)
</ParamField>

<Info>
  Sie müssen entweder `clear_add_on_credit_cap` oder `set_add_on_credit_cap` angeben, aber nicht beides.
</Info>

<div id="scope-configuration-choose-one">
  ### Bereichskonfiguration (eine Option wählen)
</div>

<ParamField body="team_level" type="boolean">
  Auf `true` setzen, um das Limit pro Benutzer auf alle Benutzer im Team anzuwenden
</ParamField>

<ParamField body="group_id" type="string">
  Das Limit pro Benutzer auf alle Benutzer in einer bestimmten Gruppe anwenden, indem Sie die Gruppen-ID angeben
</ParamField>

<ParamField body="user_email" type="string">
  Die Konfiguration auf einen bestimmten Benutzer anwenden, indem Sie dessen E‑Mail‑Adresse angeben
</ParamField>

<Info>
  Sie müssen eines von `team_level`, `group_id` oder `user_email` angeben, um den Geltungsbereich festzulegen.
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### Beispielanfrage – Kreditlimit pro Benutzer für alle Teammitglieder festlegen
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 10000,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="example-request-set-per-user-credit-cap-for-all-users-in-a-group">
  ### Beispielanfrage – Pro-Benutzer-Kreditobergrenze für alle Nutzer in einer Gruppe festlegen
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 5000,
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="example-request-set-credit-cap-for-user">
  ### Beispielanfrage – Kreditobergrenze für einen Benutzer festlegen
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 1000,
  "user_email": "user@example.com"
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="example-request-clear-credit-cap">
  ### Beispielanfrage – Credit-Limit aufheben
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "clear_add_on_credit_cap": true,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="response">
  ## Antwort
</div>

Der Antwortinhalt ist leer. Ein `200`-Statuscode weist darauf hin, dass der Vorgang erfolgreich war.

<div id="error-responses">
  ## Fehlerantworten
</div>

Häufige Fehlerszenarien:

* Ungültiger Service Key oder unzureichende Berechtigungen
* Sowohl `clear_add_on_credit_cap` als auch `set_add_on_credit_cap` übergeben
* Weder `clear_add_on_credit_cap` noch `set_add_on_credit_cap` übergeben
* Mehrere Scope-Parameter übergeben
* Kein Scope-Parameter übergeben
* Ungültige Gruppen-ID oder Benutzer-E-Mail-Adresse
* Ratenlimit überschritten