Legacy user ACU limit endpoints

Deprecated. These endpoints predate tiers and their naming is misleading: despite the local_agent field name, the limit they manage is no longer Local Agent-only — it is the user’s account-wide ACU limit across cloud Devin sessions and Local Agent products alike. Prefer the usage-policies endpoints.

Migration guide:

Setting cycle_acu_limit on the user endpoints is equivalent to setting a permanent override through the user override endpoint.
The default user limit endpoints now read and write the default tier’s cycle_acu_limit — there is no longer a standalone default user limit.
The billing_org_id field on the user endpoints is not deprecated: it is still how billing organization attribution for organization-level Local Agent limits is assigned.

See ACU limits for authentication, permissions, and PATCH semantics shared by all endpoints on this page.

User endpoints

Get a user’s ACU settings

GET /v3beta1/enterprise/users/{user_id}/consumption/acu-limits

Response body

{
  "local_agent": {
    "cycle_acu_limit": 1000,
    "billing_org_id": "org-xyz789"
  }
}

The local_agent block is omitted when the user has neither an explicit limit override nor a billing organization attribution. Fields inside the block are omitted when unset. This response contains only the user’s permanent override, not their effective limit. To determine effective limits, use the tier user endpoints.

Update a user’s ACU settings

PATCH /v3beta1/enterprise/users/{user_id}/consumption/acu-limits

Setting cycle_acu_limit here sets a permanent override without changing the user’s tier assignment. Request body — set a permanent override and billing organization

{
  "local_agent": {
    "cycle_acu_limit": 1000,
    "billing_org_id": "org-xyz789"
  }
}

Request body — clear only the billing organization assignment

{
  "local_agent": {
    "billing_org_id": null
  }
}

Request body — clear all user settings

{
  "local_agent": null
}

The endpoint returns HTTP 204 on success.

Delete a user’s ACU settings

This clears the user’s permanent limit override and billing organization attribution.

DELETE /v3beta1/enterprise/users/{user_id}/consumption/acu-limits

The endpoint returns HTTP 204 on success.

Default user limit endpoints

Get the default user limit

GET /v3beta1/enterprise/users/consumption/acu-limits

Response body

{
  "local_agent": {
    "cycle_acu_limit": 500
  }
}

The local_agent block is omitted when the default tier has no limit set.

Update the default user limit

PATCH /v3beta1/enterprise/users/consumption/acu-limits

Request body — set the default tier’s limit

{
  "local_agent": {
    "cycle_acu_limit": 500
  }
}

Request body — clear the default tier’s limit Set local_agent to null:

{
  "local_agent": null
}

The endpoint returns HTTP 204 on success.

Delete the default user limit

Clears the default tier’s limit.

DELETE /v3beta1/enterprise/users/consumption/acu-limits

The endpoint returns HTTP 204 on success.

Get Started

Essential Guidelines

Onboarding Devin

Working with Devin

Product Guides

Integrations

Admin

Release Notes

Legacy user ACU limit endpoints

User endpoints

Get a user’s ACU settings

Update a user’s ACU settings

Delete a user’s ACU settings

Default user limit endpoints

Get the default user limit

Update the default user limit

Delete the default user limit

​User endpoints

​Get a user’s ACU settings

​Update a user’s ACU settings

​Delete a user’s ACU settings

​Default user limit endpoints

​Get the default user limit

​Update the default user limit

​Delete the default user limit

User endpoints

Get a user’s ACU settings

Update a user’s ACU settings

Delete a user’s ACU settings

Default user limit endpoints

Get the default user limit

Update the default user limit

Delete the default user limit