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

# Plafonds d’ACU par utilisateur

> Consultez et définissez les dérogations de limite d’ACU par utilisateur via l’API de clé de service.

<Info>
  Cette documentation concerne les déploiements fédéraux de Devin. [Retour à la documentation Devin](/fr/get-started/devin-intro)
</Info>

Consultez et gérez les dérogations de plafond d’ACU par utilisateur. Une dérogation utilisateur prévaut sur les limites de team et de groupe — consultez [Limites d’ACU](/fr/federal/acu-limits) pour savoir comment la limite effective est déterminée. Ces endpoints sont disponibles uniquement dans les déploiements fédéraux multitenants. Ils utilisent **Teams Read-Only** pour la lecture et **Teams Update** pour l’écriture.

Les deux endpoints sélectionnent l’utilisateur à l’aide d’un objet `user` contenant exactement l’un des éléments suivants :

<ParamField body="user.email" type="string">
  L’adresse e-mail de l’utilisateur.
</ParamField>

<ParamField body="user.user_id" type="string">
  L’ID stable de l’utilisateur, tel que renvoyé par l’API (par exemple dans les lignes de [membres de groupe](/fr/federal/api/group-management#list-group-members) ou de [consommation d’ACU](/fr/federal/api/acu-consumption)).
</ParamField>

Les clés de service limitées à un groupe ne peuvent sélectionner que les membres actuels du groupe qui leur est attribué ; pour les autres utilisateurs, elles renvoient `not_found`. Consultez la [vue d’ensemble de l’API](/fr/federal/api/overview) pour l’authentification et les erreurs.

L’objet de plafond renvoyé par les deux endpoints :

| Champ                        | Description                                                                                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                    | L’ID stable de l’utilisateur.                                                                                                                                       |
| `email`                      | L’adresse e-mail de l’utilisateur.                                                                                                                                  |
| `configured_cycle_acu_limit` | La dérogation directe par utilisateur, si elle est définie. Une valeur de `0` signifie que l’utilisateur est bloqué. Omis lorsqu’aucune dérogation n’existe.        |
| `effective_cycle_acu_limit`  | Le plafond réellement appliqué à l’utilisateur après prise en compte de la dérogation et des limites de team et de groupe. Omis lorsqu’aucune limite ne s’applique. |

***

<div id="get-a-users-acu-cap">
  ## Obtenir le plafond d’ACU d’un utilisateur
</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">
  ## Définir ou supprimer le plafond d’ACU d’un utilisateur
</div>

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

Vous devez fournir exactement l’un des paramètres suivants :

<ParamField body="set_cycle_acu_limit" type="number">
  Définit la dérogation de limite d’ACU par cycle pour l’utilisateur. Doit être supérieure ou égale à zéro ; `0` empêche l’utilisateur de consommer des ACU.
</ParamField>

<ParamField body="clear_cycle_acu_limit" type="boolean">
  Supprime la dérogation de l’utilisateur afin que les limites de la Team et du groupe s’appliquent de nouveau.
</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
  }'
```

La réponse contient l’objet `cap` mis à jour.

<Note>
  Une dérogation utilisateur définie sur `0` **bloque** l’utilisateur. L’API des groupes de clés de service n’accepte pas de plafond de groupe égal à zéro : `set_cycle_acu_limit` doit être positif et `clear_cycle_acu_limit` supprime la dérogation de groupe. L’opération distincte du portail relative à la limite de groupe interprète `0` comme une suppression. Consultez [Valeurs zéro et non définies](/fr/federal/acu-limits#zero-and-unset-values).
</Note>