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

# Nutzung konfigurieren

> Add-on‑Credit‑Limits pro Benutzer festlegen oder zurücksetzen und sie bei Bedarf auf Team‑, Gruppen‑ oder Benutzerebene für das Enterprise‑Billing anwenden.

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

Legen Sie benutzerbezogene Limits für die Nutzung von Add-on-Guthaben in Ihrer Organisation fest oder heben Sie sie auf. Limits werden immer pro Benutzer angewendet. Wenn Sie den Geltungsbereich auf ein Team oder eine Gruppe festlegen, wird das Limit für jeden einzelnen Benutzer innerhalb dieses Teams oder dieser Gruppe individuell angewendet – es legt kein gemeinsames Limit für das gesamte Team oder die gesamte Gruppe fest.

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

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

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

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

<ParamField body="set_add_on_credit_cap" type="integer">
  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 auswählen)
</div>

<ParamField body="team_level" type="boolean">
  Auf `true` setzen, um die benutzerspezifische Obergrenze für alle Benutzer im Team anzuwenden
</ParamField>

<ParamField body="group_id" type="string">
  Die benutzerspezifische Obergrenze auf alle Benutzer in einer bestimmten Gruppe anwenden, indem die Gruppen-ID angegeben wird
</ParamField>

<ParamField body="user_email" type="string">
  Die Konfiguration auf einen bestimmten Benutzer anwenden, indem dessen E-Mail-Adresse angegeben wird
</ParamField>

<Info>
  Es muss eines von `team_level`, `group_id` oder `user_email` angegeben werden, um den Geltungsbereich festzulegen.
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### Beispielanfrage – Kreditlimit pro Nutzer 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 – Kreditobergrenze pro Benutzer für alle Benutzer 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 – Kreditlimit 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 – Guthabenlimit 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 Antworttext ist leer. Ein `200`-Statuscode zeigt an, dass der Vorgang erfolgreich war.

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

Häufige Fehlerfälle:

* 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
* Rate Limit überschritten