> ## 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 no nível da organização

> Limite o consumo mensal de ACU de Local Agent e Devin de uma organização

Os limites no nível da organização restringem o uso total de ACU atribuído a uma organização, por categoria de produto:

| Limite                          | Produtos abrangidos                                            |
| ------------------------------- | -------------------------------------------------------------- |
| **Local Agent** (`local_agent`) | Devin Desktop, Windsurf JetBrains, Devin CLI                   |
| **Devin** (`cloud_agent`)       | sessões em nuvem do Devin (app web, Slack e outras interfaces) |

Cada organização em uma Enterprise pode ter seus próprios limites, permitindo que administradores aloquem orçamentos entre equipes ou projetos. Você também pode gerenciar os limites do Devin no nível da organização pelo app web; consulte [Faturamento Enterprise](/pt-BR/admin/billing/enterprise#setting-organization-acu-limits).

Os limites no nível da organização são independentes dos [limites no nível do usuário](/pt-BR/admin/billing/user-acu-limits) — uma requisição é bloqueada se qualquer um deles for atingido. Consulte [Limites de ACU](/pt-BR/admin/billing/acu-limits) para informações sobre autenticação, permissões e a semântica de `PATCH` compartilhada por todos os endpoints desta página.

<div id="billing-organization-attribution">
  ## Atribuição da organização de faturamento
</div>

O uso do Local Agent de cada usuário é contabilizado para uma **organização de faturamento**, que determina qual limite de Local Agent da organização será aplicado. A organização de faturamento é determinada nesta ordem:

1. **Atribuição explícita:** Um administrador define `billing_org_id` nas configurações de ACU do usuário pela API.
2. **Determinação automática:** Se não houver atribuição explícita, será usada a primeira organização à qual o usuário tiver acesso, seja por associação direta ou por atribuição a um grupo de um provedor de identidade.

A organização de faturamento principal do usuário também determina quais [controles do agente local](/pt-BR/enterprise/local/controls) se aplicam a ele.

As atribuições explícitas de organização de faturamento são gerenciadas pelos [endpoints legados de usuário](/pt-BR/admin/billing/legacy-user-acu-limits#user-endpoints) — o campo `billing_org_id` não está obsoleto; apenas o campo `limit` está:

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/users/user_abc123/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"local_agent": {"billing_org_id": "org-xyz789"}}'
```

<div id="organization-endpoints">
  ## Endpoints da organização
</div>

<div id="get-an-organizations-limits">
  ### Obter os limites da organização
</div>

```http theme={null}
GET /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits
```

**Corpo da resposta**

```json theme={null}
{
  "local_agent": {
    "cycle_acu_limit": 2000
  },
  "cloud_agent": {
    "cycle_acu_limit": 1000
  }
}
```

Um bloco de agente é omitido quando não há limite definido para essa categoria de produto.

<div id="update-an-organizations-limits">
  ### Atualizar os limites de uma organização
</div>

```http theme={null}
PATCH /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits
```

**Corpo da requisição — definir os limites do Local Agent e do Devin**

```json theme={null}
{
  "local_agent": {
    "cycle_acu_limit": 2000
  },
  "cloud_agent": {
    "cycle_acu_limit": 1000
  }
}
```

**Corpo da requisição — limpe apenas o limite do Local Agent**

Defina `local_agent` como `null` sem alterar o limite do Devin:

```json theme={null}
{
  "local_agent": null
}
```

O endpoint retorna HTTP `204` em caso de sucesso.

<div id="delete-an-organizations-limits">
  ### Excluir os limites de uma organização
</div>

Isso remove os limites do Local Agent e do Devin da organização.

```http theme={null}
DELETE /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits
```

O endpoint retorna HTTP `204` em caso de sucesso.

<div id="example-workflows">
  ## Exemplos de workflows
</div>

<div id="set-up-organization-level-local-agent-limits">
  ### Configure limites do Local Agent no nível da organização
</div>

Defina um orçamento no nível da organização para o uso combinado do Devin Desktop, Windsurf JetBrains e Devin CLI:

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/organizations/org-xyz789/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"local_agent": {"cycle_acu_limit": 5000}}'
```

<div id="set-up-organization-level-devin-limits">
  ### Configure os limites do Devin no nível da organização
</div>

Defina um orçamento de sessões em nuvem do Devin para uma organização:

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/organizations/org-xyz789/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cloud_agent": {"cycle_acu_limit": 1000}}'
```

<div id="frequently-asked-questions">
  ## Perguntas frequentes
</div>

<AccordionGroup>
  <Accordion title="O que é a atribuição da organização de faturamento?">
    A atribuição da organização de faturamento determina em qual limite de Local Agent da organização é contabilizado o uso do Devin Desktop, Windsurf JetBrains e Devin CLI por um usuário. Se não for definida explicitamente, ela será atribuída automaticamente à primeira organização que o usuário puder acessar.
  </Accordion>

  <Accordion title="O que acontece quando uma organização atinge um limite?">
    Novos trabalhos são bloqueados nos produtos dessa categoria para os usuários da organização — produtos Local Agent para o limite `local_agent` e sessões em nuvem do Devin para o limite `cloud_agent` — até que o limite seja ajustado ou o uso seja redefinido no próximo período mensal.
  </Accordion>
</AccordionGroup>