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

# Recupera la configurazione di utilizzo

> Recupera la configurazione del limite dei crediti aggiuntivi per utente, richiesta per ambito di team, gruppo o singolo utente per la gestione della fatturazione Enterprise.

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

Recupera la configurazione attuale del limite dei crediti aggiuntivi per utente per la tua organizzazione. I limiti sono sempre per utente. Quando effettui una query con ambito team o gruppo, la risposta restituisce il limite per utente applicato agli utenti di quel team o gruppo.

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

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

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

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

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

<ParamField body="user_email" type="string">
  Recupera la configurazione per 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-get-per-user-cap-for-all-users-on-team">
  ### Richiesta di esempio - Recuperare il limite 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",
  "team_level": true
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-per-user-cap-for-all-users-in-a-group">
  ### Richiesta di esempio - GET del limite per 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",
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-user-configuration">
  ### Richiesta di esempio - Recuperare la configurazione dell'utente
</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">
  ## Risposta
</div>

<ResponseField name="addOnCreditCap" type="integer">
  Il valore configurato del limite dei crediti aggiuntivi. Se questo campo non è presente nella risposta, non è configurato alcun limite nell'ambito richiesto.
</ResponseField>

<div id="example-response-with-cap-configured">
  ### Esempio di risposta - Con limite impostato
</div>

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

<div id="example-response-no-cap-configured">
  ### Risposta di esempio - Nessun limite configurato
</div>

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

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

Scenari di errore comuni:

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