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

# Limites de ACU por usuário

> Consulte e defina overrides de limite de ACU por usuário pela API de chave de serviço.

<Info>
  Esta documentação é destinada às implantações federais do Devin. [Voltar para a documentação do Devin](/pt-BR/get-started/devin-intro)
</Info>

Consulte e gerencie overrides de limite de ACU por usuário. Um override por usuário tem precedência sobre os limites de equipe e grupo — consulte [Limites de ACU](/pt-BR/federal/acu-limits) para entender como o limite efetivo é determinado. Estes endpoints estão disponíveis apenas em implantações federais multilocatárias. Eles usam **Teams Read-Only** para leitura e **Teams Update** para gravação.

Ambos os endpoints selecionam o usuário por meio de um objeto `user` que contém exatamente um dos seguintes campos:

<ParamField body="user.email" type="string">
  O endereço de e-mail do usuário.
</ParamField>

<ParamField body="user.user_id" type="string">
  O ID estável do usuário, conforme retornado pela API (por exemplo, em registros de [membros de grupo](/pt-BR/federal/api/group-management#list-group-members) ou de [consumo de ACU](/pt-BR/federal/api/acu-consumption)).
</ParamField>

Chaves de serviço com escopo de grupo só podem selecionar membros atuais do grupo atribuído; para outros usuários, retornam `not_found`. Consulte a [visão geral da API](/pt-BR/federal/api/overview) para informações sobre autenticação e erros.

O objeto de limite retornado por ambos os endpoints:

| Campo                        | Descrição                                                                                                                                    |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                    | O ID estável do usuário.                                                                                                                     |
| `email`                      | O e-mail do usuário.                                                                                                                         |
| `configured_cycle_acu_limit` | O override direto por usuário, se estiver definido. Um valor de `0` significa que o usuário está bloqueado. Omitido quando não há override.  |
| `effective_cycle_acu_limit`  | O limite efetivamente aplicado ao usuário após combinar o override com os limites de equipe e grupo. Omitido quando nenhum limite se aplica. |

***

<div id="get-a-users-acu-cap">
  ## Obter o limite de ACUs de um usuário
</div>

```
POST /api/v1/GetUserAcuCap
```

```bash theme={null}
curl -X POST https://<your-server>/api/v1/GetUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"}
  }'
```

```json theme={null}
{
  "cap": {
    "userId": "user_abc",
    "email": "dev@agency.gov",
    "configuredCycleAcuLimit": 25,
    "effectiveCycleAcuLimit": 25
  }
}
```

<div id="set-or-clear-a-users-acu-cap">
  ## Definir ou remover o limite de ACUs de um usuário
</div>

```
POST /api/v1/UpdateUserAcuCap
```

Exatamente um dos seguintes itens deve ser fornecido:

<ParamField body="set_cycle_acu_limit" type="number">
  Define o override de ACUs do usuário por ciclo. Deve ser não negativo; `0` impede o usuário de consumir ACUs.
</ParamField>

<ParamField body="clear_cycle_acu_limit" type="boolean">
  Remove o override do usuário para que os limites da equipe e do grupo voltem a ser aplicados.
</ParamField>

```bash theme={null}
curl -X POST https://<your-server>/api/v1/UpdateUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"},
    "set_cycle_acu_limit": 25
  }'
```

A resposta contém o objeto `cap` atualizado.

<Note>
  Um override de usuário de `0` **bloqueia** o usuário. A API de grupos de chaves de serviço não aceita um limite de grupo igual a zero: `set_cycle_acu_limit` deve ser positivo, e `clear_cycle_acu_limit` remove o override do grupo. A operação separada do portal para limites de grupo trata `0` como remoção do limite. Consulte [Valores zero e não definidos](/pt-BR/federal/acu-limits#zero-and-unset-values).
</Note>