> ## 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 de add-on por usuário, com a capacidade de aplicá-los a uma equipe inteira, a um grupo ou a um usuário individual para gerenciamento de cobrança em nível Enterprise.

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

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

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

<ParamField body="service_key" type="string" required>
  Sua Chave de serviço com permissões "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 em um grupo específico fornecendo o ID do grupo
</ParamField>

<ParamField body="user_email" type="string">
  Aplique a configuração a um usuário específico fornecendo o endereço de e-mail
</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édito 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 Requisição - Definir Limite de Crédito por Usuário para Todos os Usuários de 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éditos do 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 — limite de créditos definido
</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 bem-sucedida.

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

Cenários de erro comuns:

* Service Key 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
* Múltiplos parâmetros de escopo fornecidos
* Nenhum parâmetro de escopo fornecido
* ID de grupo ou e-mail de usuário inválido
* Limite de requisições excedido