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

# Establecer la configuración de uso

> Establecer o eliminar límites de uso de créditos complementarios por usuario, con la posibilidad de aplicarlos a través de un equipo, grupo o usuario individual para la gestión de Billing en Enterprise.

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

Configura o elimina límites de uso por usuario para los créditos de complementos de tu organización. Los límites siempre se aplican por usuario. Cuando especificas un ámbito de equipo o grupo, el límite se aplica individualmente a cada usuario dentro de ese equipo o grupo; no establece un límite compartido para todo el equipo o grupo.

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

<ParamField body="service_key" type="string" required>
  Tu clave de servicio con el permiso "Billing Write"
</ParamField>

<div id="credit-cap-configuration-choose-one">
  ### Configuración del límite de crédito (Elige una)
</div>

<ParamField body="clear_add_on_credit_cap" type="boolean">
  Establécelo en `true` para borrar el límite de crédito adicional existente
</ParamField>

<ParamField body="set_add_on_credit_cap" type="integer">
  Establece un nuevo límite de crédito adicional (valor entero)
</ParamField>

<Info>
  Debes proporcionar `clear_add_on_credit_cap` o `set_add_on_credit_cap`, pero no ambos.
</Info>

<div id="scope-configuration-choose-one">
  ### Configuración del alcance (Elige una)
</div>

<ParamField body="team_level" type="boolean">
  Configúralo en `true` para aplicar el límite por usuario a todos los usuarios del equipo
</ParamField>

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

<ParamField body="user_email" type="string">
  Aplica la configuración a 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 alcance.
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### Ejemplo de solicitud: establecer un tope de créditos por usuario para todos los usuarios del equipo
</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">
  ### Ejemplo de solicitud: establecer límite de crédito por usuario para todos los usuarios del grupo
</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">
  ### Ejemplo de solicitud: establecer límite de crédito para un usuario
</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">
  ### Ejemplo de solicitud: eliminar el límite de créditos
</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">
  ## Respuesta
</div>

El cuerpo de la respuesta está vacío. Un código de estado `200` indica que la operación se completó correctamente.

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

Escenarios de error comunes:

* Clave de servicio no válida o permisos insuficientes
* Se proporcionaron tanto `clear_add_on_credit_cap` como `set_add_on_credit_cap`
* No se proporcionó ni `clear_add_on_credit_cap` ni `set_add_on_credit_cap`
* Se proporcionaron varios parámetros de scope
* No se proporcionó ningún parámetro de scope
* ID de grupo o correo electrónico de usuario no válido
* Se superó el límite de solicitudes