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

# Récupérer la configuration d’utilisation

> Récupérer la configuration du plafond de crédits additionnels par utilisateur, selon le périmètre du Team, du groupe ou de l’utilisateur individuel, pour la gestion de la facturation Enterprise.

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

Récupérez la configuration actuelle du plafond de crédits additionnels par utilisateur pour votre organisation. Les plafonds sont toujours définis par utilisateur. Lorsque vous effectuez une requête sur le périmètre d’une Team ou d’un groupe, la réponse renvoie le plafond par utilisateur appliqué aux utilisateurs de cette Team ou de ce groupe.

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

<ParamField body="service_key" type="string" required>
  Votre clé de service avec l’autorisation « Billing Read »
</ParamField>

<div id="scope-configuration-choose-one">
  ### Configuration du périmètre (choisissez une option)
</div>

<ParamField body="team_level" type="boolean">
  Définissez cette valeur sur `true` pour récupérer le plafond par utilisateur appliqué à tous les utilisateurs de la Team
</ParamField>

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

<ParamField body="user_email" type="string">
  Récupérez la configuration d’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 le périmètre.
</Info>

<div id="example-request-get-per-user-cap-for-all-users-on-team">
  ### Exemple de requête - Récupérer le plafond par utilisateur pour tous les utilisateurs de la Team
</div>

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

<div id="example-request-get-per-user-cap-for-all-users-in-a-group">
  ### Exemple de requête - Récupérer le plafond 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",
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-user-configuration">
  ### Exemple de requête - Récupérer la configuration utilisateur
</div>

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

<div id="response">
  ## Réponse
</div>

<ResponseField name="addOnCreditCap" type="integer">
  La valeur configurée du plafond de crédits additionnel. Si ce champ n'est pas présent dans la réponse, aucun plafond n'est configuré pour le niveau de périmètre demandé.
</ResponseField>

<div id="example-response-with-cap-configured">
  ### Exemple de réponse - Avec un plafond configuré
</div>

```json theme={null}
{
  "addOnCreditCap": 10000
}
```

<div id="example-response-no-cap-configured">
  ### Exemple de réponse - Aucun plafond n’est configuré
</div>

```json theme={null}
{}
```

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

Scénarios d'erreur courants :

* Clé de service invalide ou autorisations insuffisantes
* Plusieurs paramètres de périmètre fournis
* Aucun paramètre de périmètre fourni
* ID de groupe ou adresse e-mail d’utilisateur invalide
* Limite de débit dépassée