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

# Limiti ACU per utente

> Leggi e imposta gli override dei limiti ACU per utente tramite l'API con chiave di servizio.

<Info>
  Questa documentazione è destinata alle distribuzioni federali di Devin. [Torna alla documentazione di Devin](/it/get-started/devin-intro)
</Info>

Leggi e gestisci gli override dei limiti ACU per utente. Un override a livello di utente ha precedenza sui limiti di team e gruppo. Per informazioni su come viene determinato il limite effettivo, consulta [Limiti ACU](/it/federal/acu-limits). Questi endpoint sono disponibili solo nelle distribuzioni federali multi-tenant. Utilizzano **Teams Read-Only** per le letture e **Teams Update** per le scritture.

Entrambi gli endpoint selezionano l'utente tramite un oggetto `user` contenente esattamente uno dei seguenti campi:

<ParamField body="user.email" type="string">
  L'indirizzo email dell'utente.
</ParamField>

<ParamField body="user.user_id" type="string">
  L'ID stabile dell'utente, come restituito dall'API, ad esempio nelle righe relative a [membri del gruppo](/it/federal/api/group-management#list-group-members) o al [consumo ACU](/it/federal/api/acu-consumption).
</ParamField>

Le chiavi di servizio con ambito di gruppo possono selezionare solo i membri correnti del gruppo assegnato; per gli altri utenti viene restituito `not_found`. Consulta la [panoramica dell'API](/it/federal/api/overview) per informazioni sull'autenticazione e sugli errori.

L'oggetto limite restituito da entrambi gli endpoint:

| Campo                        | Descrizione                                                                                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                    | L'ID stabile dell'utente.                                                                                                                          |
| `email`                      | L'indirizzo email dell'utente.                                                                                                                     |
| `configured_cycle_acu_limit` | L'override diretto per utente, se impostato. Un valore di `0` indica che l'utente è bloccato. Omesso se non esiste alcun override.                 |
| `effective_cycle_acu_limit`  | Il limite effettivamente applicato all'utente dopo aver combinato l'override con i limiti di team e gruppo. Omesso se non si applica alcun limite. |

***

<div id="get-a-users-acu-cap">
  ## Ottieni il limite di ACU di un utente
</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">
  ## Impostare o rimuovere il limite di ACU di un utente
</div>

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

È necessario fornire esattamente uno dei seguenti parametri:

<ParamField body="set_cycle_acu_limit" type="number">
  Imposta l'override del limite di ACU per ciclo dell'utente. Deve essere non negativo; `0` impedisce all'utente di consumare ACU.
</ParamField>

<ParamField body="clear_cycle_acu_limit" type="boolean">
  Rimuove l'override dell'utente, consentendo nuovamente l'applicazione dei limiti del team e del gruppo.
</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 risposta contiene l'oggetto `cap` aggiornato.

<Note>
  Un override utente pari a `0` **blocca** l'utente. L'API del gruppo di chiavi di servizio non accetta un limite di gruppo pari a zero: `set_cycle_acu_limit` deve essere positivo e `clear_cycle_acu_limit` rimuove l'override del gruppo. La specifica operazione del portale per il limite di gruppo interpreta `0` come rimozione del limite. Vedi [Valori zero e non impostati](/it/federal/acu-limits#zero-and-unset-values).
</Note>