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

# Imposta la configurazione dell'utilizzo

> Imposta o rimuovi i limiti dei crediti aggiuntivi per utente, con la possibilità di applicarli a un team, un gruppo o un singolo utente per la gestione della fatturazione Enterprise.

<div id="overview">
  ## Panoramica
</div>

Imposta o rimuovi i limiti di utilizzo per utente sui crediti aggiuntivi della tua organizzazione. I limiti vengono sempre applicati per singolo utente. Quando specifichi un ambito relativo a un team o gruppo, il limite viene applicato singolarmente a ciascun utente all'interno di quel team o gruppo; non imposta un limite condiviso per l'intero team o gruppo.

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

<ParamField body="service_key" type="string" required>
  La tua chiave di servizio con l'autorizzazione "Billing Write"
</ParamField>

<div id="credit-cap-configuration-choose-one">
  ### Configurazione del limite di credito (scegline una)
</div>

<ParamField body="clear_add_on_credit_cap" type="boolean">
  Imposta su `true` per azzerare il limite di credito aggiuntivo esistente
</ParamField>

<ParamField body="set_add_on_credit_cap" type="integer">
  Imposta un nuovo limite di credito aggiuntivo (valore intero)
</ParamField>

<Info>
  Devi specificare `clear_add_on_credit_cap` oppure `set_add_on_credit_cap`, ma non entrambi.
</Info>

<div id="scope-configuration-choose-one">
  ### Configurazione dell'ambito (Scegline una)
</div>

<ParamField body="team_level" type="boolean">
  Imposta su `true` per applicare il limite per utente a tutti gli utenti del team
</ParamField>

<ParamField body="group_id" type="string">
  Applica il limite per utente a tutti gli utenti di un gruppo specifico fornendo l'ID del gruppo
</ParamField>

<ParamField body="user_email" type="string">
  Applica la configurazione a un utente specifico fornendo il suo indirizzo email
</ParamField>

<Info>
  Devi fornire uno tra `team_level`, `group_id` o `user_email` per definire l'ambito.
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### Esempio di richiesta - Imposta un limite di credito per utente per tutti gli utenti del team
</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">
  ### Esempio di richiesta - Imposta il limite di credito per ciascun utente per tutti gli utenti di un gruppo
</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">
  ### Esempio di richiesta - Impostare il limite di credito per un utente
</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">
  ### Esempio di richiesta - Rimozione del limite di credito
</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">
  ## Risposta
</div>

Il corpo della risposta è vuoto. Un codice di stato `200` indica che l'operazione è andata a buon fine.

<div id="error-responses">
  ## Risposte di errore
</div>

Scenari di errore comuni:

* Chiave di servizio non valida o autorizzazioni insufficienti
* Sono stati forniti sia `clear_add_on_credit_cap` sia `set_add_on_credit_cap`
* Non è stato fornito né `clear_add_on_credit_cap` né `set_add_on_credit_cap`
* Sono stati forniti più parametri di ambito
* Non è stato fornito alcun parametro di ambito
* ID del gruppo o email dell'utente non validi
* Limite di richieste superato