> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener la configuración de uso

> Obtener la configuración del límite de créditos adicionales por usuario, consultada por alcance de equipo, grupo o usuario individual para la gestión de Billing en Enterprise.

<div id="overview">
  ## Descripción general
</div>

Obtén la configuración actual del límite de créditos de complementos por usuario para tu organización. Los límites siempre son por usuario. Cuando consultas con el alcance de un equipo o grupo, la respuesta devuelve el límite por usuario aplicado a los usuarios de ese equipo o grupo.

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

<ParamField body="service_key" type="string" required>
  Tu clave de servicio con permisos de "Billing Read"
</ParamField>

<div id="scope-configuration-choose-one">
  ### Configuración del ámbito (elige una opción)
</div>

<ParamField body="team_level" type="boolean">
  Establece en `true` para obtener el límite por usuario aplicado a todos los usuarios del equipo
</ParamField>

<ParamField body="group_id" type="string">
  Obtén el límite por usuario aplicado a todos los usuarios de un grupo específico proporcionando el ID del grupo
</ParamField>

<ParamField body="user_email" type="string">
  Obtén la configuración de un usuario específico proporcionando su dirección de correo electrónico
</ParamField>

<Info>
  Debes proporcionar uno de `team_level`, `group_id` o `user_email` para definir el ámbito.
</Info>

<div id="example-request-get-per-user-cap-for-all-users-on-team">
  ### Ejemplo de solicitud: obtener el límite por usuario para todos los miembros del equipo
</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">
  ### Ejemplo de solicitud: obtener el límite por usuario de todos los usuarios de un grupo
</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">
  ### Ejemplo de solicitud: Obtener configuración de usuario
</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">
  ## Respuesta
</div>

<ResponseField name="addOnCreditCap" type="integer">
  El valor configurado del límite de créditos del complemento. Si este campo no está presente en la respuesta, no hay ningún límite configurado para el nivel de alcance solicitado.
</ResponseField>

<div id="example-response-with-cap-configured">
  ### Ejemplo de respuesta - con límite configurado
</div>

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

<div id="example-response-no-cap-configured">
  ### Ejemplo de respuesta: sin tope configurado
</div>

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

<div id="error-responses">
  ## Respuestas de error
</div>

Escenarios de error comunes:

* Clave de servicio no válida o permisos insuficientes
* Se proporcionaron varios parámetros de scope
* No se proporcionó ningún parámetro de scope
* ID de grupo no válido o correo electrónico de usuario no válido
* Límite de solicitudes superado