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

# Organization-level ACU limits

> Cap an organization's monthly Local Agent and Devin ACU consumption

Organization-level limits cap the total ACU usage attributed to one organization, per product category:

| Limit                           | Products covered                                        |
| ------------------------------- | ------------------------------------------------------- |
| **Local Agent** (`local_agent`) | Devin Desktop, Windsurf JetBrains, Devin CLI            |
| **Devin** (`cloud_agent`)       | Devin cloud sessions (web app, Slack, other interfaces) |

Each organization in an enterprise can have its own limits, allowing administrators to allocate budgets across teams or projects. You can also manage organization-level Devin limits from the web app; see [Enterprise billing](/admin/billing/enterprise#setting-organization-acu-limits).

Organization-level limits are independent of [user-level limits](/admin/billing/user-acu-limits) — a request is blocked if either has been reached. See [ACU limits](/admin/billing/acu-limits) for authentication, permissions, and `PATCH` semantics shared by all endpoints on this page.

## Billing organization attribution

Each user's Local Agent usage is counted toward a **billing organization**, which determines which organization's Local Agent limit applies. The billing organization is resolved in this order:

1. **Explicit assignment:** An administrator sets `billing_org_id` on the user's ACU settings through the API.
2. **Automatic resolution:** If there is no explicit assignment, the first organization the user can access through direct membership or an identity provider group assignment is used.

A user's primary billing org also determines which [local agent controls](/enterprise/local/controls) apply to them.

Explicit billing organization assignments are managed with the [legacy user endpoints](/admin/billing/legacy-user-acu-limits#user-endpoints) — the `billing_org_id` field there is not deprecated, only the limit field is:

```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"}}'
```

## Organization endpoints

### Get an organization's limits

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

**Response body**

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

An agent block is omitted when no limit is set for that product category.

### Update an organization's limits

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

**Request body — set Local Agent and Devin limits**

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

**Request body — clear only the Local Agent limit**

Set `local_agent` to `null` without changing the Devin limit:

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

The endpoint returns HTTP `204` on success.

### Delete an organization's limits

This clears both the Local Agent and Devin limits for the organization.

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

The endpoint returns HTTP `204` on success.

## Example workflows

### Set up organization-level Local Agent limits

Set an organization-level budget for combined Devin Desktop, Windsurf JetBrains, and Devin CLI usage:

```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}}'
```

### Set up organization-level Devin limits

Set a Devin cloud session budget for an organization:

```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}}'
```

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What is billing organization attribution?">
    Billing organization attribution determines which organization's Local Agent limit includes a user's Devin Desktop, Windsurf JetBrains, and Devin CLI usage. If it is not assigned explicitly, it resolves automatically to the first organization the user can access.
  </Accordion>

  <Accordion title="What happens when an organization reaches a limit?">
    New work is blocked on the products in that category for the organization's users — Local Agent products for the `local_agent` limit, Devin cloud sessions for the `cloud_agent` limit — until the limit is adjusted or usage resets in the next monthly window.
  </Accordion>
</AccordionGroup>