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

# Definir configuração de uso

> Definir ou remover limites de créditos adicionais por usuário, com a possibilidade de aplicá-los a uma equipe, grupo ou usuário individual para gerenciamento de cobrança no plano Enterprise.

<div id="overview">
  ## Visão geral
</div>

Defina ou remova limites de uso por usuário em créditos de complementos para sua organização. Os limites são sempre aplicados individualmente, por usuário. Quando você especifica um escopo de equipe ou grupo, o limite é aplicado individualmente a cada usuário dentro dessa equipe ou grupo — ele não define um limite compartilhado para toda a equipe ou grupo.

<div id="request">
  ## Solicitação
</div>

<ParamField body="service_key" type="string" required>
  Sua Chave de serviço com permissões de "Cobrança Write"
</ParamField>

<div id="credit-cap-configuration-choose-one">
  ### Configuração do limite de crédito (escolha uma)
</div>

<ParamField body="clear_add_on_credit_cap" type="boolean">
  Defina como `true` para limpar o limite de crédito do add-on existente
</ParamField>

<ParamField body="set_add_on_credit_cap" type="integer">
  Defina um novo limite de crédito do add-on (valor inteiro)
</ParamField>

<Info>
  Você deve fornecer `clear_add_on_credit_cap` ou `set_add_on_credit_cap`, mas não ambos.
</Info>

<div id="scope-configuration-choose-one">
  ### Configuração de escopo (escolha uma)
</div>

<ParamField body="team_level" type="boolean">
  Defina como `true` para aplicar o limite por usuário a todos os usuários da equipe
</ParamField>

<ParamField body="group_id" type="string">
  Aplique o limite por usuário a todos os usuários de um grupo específico informando o ID do grupo
</ParamField>

<ParamField body="user_email" type="string">
  Aplique a configuração a um usuário específico informando o endereço de e‑mail desse usuário
</ParamField>

<Info>
  Você deve fornecer um de `team_level`, `group_id` ou `user_email` para definir o escopo.
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### Exemplo de solicitação — Definir limite de créditos por usuário para todos os membros da equipe
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "sua_service_key_aqui",
  "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">
  ### Exemplo de Solicitação - Definir Limite de Crédito por Usuário para Todos os Usuários em um 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">
  ### Exemplo de requisição - Definir limite de crédito para o usuário
</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">
  ### Exemplo de requisição - Limpar limite de crédito
</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">
  ## Resposta
</div>

O corpo da resposta está vazio. Um código de status `200` indica que a operação foi concluída com sucesso.

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

Cenários de erro comuns:

* Chave de serviço inválida ou permissões insuficientes
* Ambos `clear_add_on_credit_cap` e `set_add_on_credit_cap` fornecidos
* Nem `clear_add_on_credit_cap` nem `set_add_on_credit_cap` fornecidos
* Vários parâmetros de escopo fornecidos
* Nenhum parâmetro de escopo fornecido
* ID do grupo inválido ou e-mail do usuário inválido
* Limite de frequência excedido