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

# Configurer l’utilisation

> Définir ou supprimer des plafonds de crédits d’add-on par utilisateur, avec la possibilité de les appliquer à l’échelle d’une équipe, d’un groupe ou d’un utilisateur pour la gestion de la facturation Enterprise.

<div id="overview">
  ## Vue d’ensemble
</div>

Définissez ou effacez des plafonds d’utilisation par utilisateur sur les crédits d’add-on pour votre organisation. Les plafonds sont toujours appliqués utilisateur par utilisateur. Lorsque vous spécifiez un périmètre d’équipe ou de groupe, le plafond est appliqué individuellement à chaque utilisateur au sein de cette équipe ou de ce groupe — il ne définit pas un plafond partagé pour l’ensemble de l’équipe ou du groupe.

<div id="request">
  ## Requête
</div>

<ParamField body="service_key" type="string" required>
  Votre clé de service avec les permissions « Facturation Write »
</ParamField>

<div id="credit-cap-configuration-choose-one">
  ### Configuration du plafond de crédits (Choisissez une option)
</div>

<ParamField body="clear_add_on_credit_cap" type="boolean">
  Définissez sur `true` pour réinitialiser le plafond de crédits additionnels existant
</ParamField>

<ParamField body="set_add_on_credit_cap" type="integer">
  Définissez un nouveau plafond de crédits additionnels (valeur entière)
</ParamField>

<Info>
  Vous devez fournir soit `clear_add_on_credit_cap`, soit `set_add_on_credit_cap`, mais pas les deux.
</Info>

<div id="scope-configuration-choose-one">
  ### Configuration de la portée (choisir une option)
</div>

<ParamField body="team_level" type="boolean">
  Définissez sur `true` pour appliquer le plafond par utilisateur à tous les utilisateurs de l’équipe
</ParamField>

<ParamField body="group_id" type="string">
  Appliquez le plafond par utilisateur à tous les utilisateurs d’un groupe spécifique en fournissant l’ID du groupe
</ParamField>

<ParamField body="user_email" type="string">
  Appliquez la configuration à un utilisateur spécifique en fournissant son adresse e‑mail
</ParamField>

<Info>
  Vous devez fournir l’un de `team_level`, `group_id` ou `user_email` pour définir la portée.
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### Exemple de requête – Définir le plafond de crédits par utilisateur pour tous les membres de l’équipe
</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">
  ### Exemple de requête - Définir un plafond de crédit par utilisateur pour l'ensemble des utilisateurs d'un groupe
</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">
  ### Exemple de requête - Définir le plafond de crédit d’un utilisateur
</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">
  ### Exemple de requête - Suppression du plafond de crédits
</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">
  ## Réponse
</div>

Le corps de la réponse est vide. Un code d’état HTTP `200` indique que l’opération s’est déroulée avec succès.

<div id="error-responses">
  ## Réponses d’erreur
</div>

Scénarios d’erreur courants :

* Clé de service invalide ou autorisations insuffisantes
* `clear_add_on_credit_cap` et `set_add_on_credit_cap` fournis tous les deux
* Ni `clear_add_on_credit_cap` ni `set_add_on_credit_cap` fournis
* Plusieurs paramètres de portée fournis
* Aucun paramètre de portée fourni
* ID de groupe ou e-mail d’utilisateur invalide
* Limite de taux dépassée