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

# Presupuestos

> Descubre cómo los presupuestos de empresa forman un árbol de límites de ACU, cómo configurar períodos mensuales y niveles de usuario por presupuesto, y cómo gestionarlos con la API.

Los presupuestos te permiten limitar el consumo de ACU según la estructura de tu empresa: un límite para la cuenta, fondos compartidos para equipos o proyectos y límites por usuario dentro de cada fondo.

## Ejemplos de casos de uso

### Departamentos con administradores delegados

Acme Corp tiene 10 departamentos. Cada jefe de departamento gestiona los límites de sus organizaciones, y el departamento central de TI fija el total de cada departamento. Este ejemplo muestra dos de ellos.

Alice, la administradora empresarial, crea un presupuesto para cada departamento dentro del presupuesto de la cuenta y lo comparte con el administrador de ese departamento. A su vez, cada administrador de departamento crea un presupuesto para cada una de sus organizaciones.

![Presupuesto de la cuenta de 100,000 ACU, con Engineering en 30,000 ACU (que incluye Payments y Search) y Marketing en 5,000 ACU.](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/budget-departments.svg?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=fd65b7ebd17f98f03e694dae32493b69)

Presupuestos de departamento dentro del presupuesto de la cuenta

* Bob, el administrador del departamento de Engineering, puede establecer límites y límites temporales en cualquier presupuesto que dependa de Engineering. Por ejemplo, puede asignar a Payments un límite temporal de 6,000 ACU durante una semana de mucha actividad.
* Bob no puede aumentar el límite de 30,000 ACU de Engineering. Solo Alice puede hacerlo.
* El consumo de todas las organizaciones de Engineering se descuenta del límite de 30,000 ACU, aunque la suma de los presupuestos de las organizaciones sea mayor.

![Página Presupuestos vista por un administrador de departamento](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-tree.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=9f921d3d02cf54e6a28792beb1db26b5)

La página Presupuestos vista por un administrador de departamento, con el presupuesto de la cuenta bloqueado

![Aumento del límite de un presupuesto hijo](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-edit-child.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=a12442bc7a00464d08283bad62358864)

Un administrador de departamento aumenta el límite de un presupuesto hijo

![El límite del presupuesto del departamento es de solo lectura](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-own-limit.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=7fc6e5bf029581de28e3290e6beb7554)

Un administrador de departamento no puede cambiar el límite del presupuesto de su departamento

### Un presupuesto de proyecto con límites por usuario más altos

Cada desarrollador dispone de 200 ACU al mes. Para la iniciativa de migración, Acme Corp reserva 5,000 ACU y permite que las personas del proyecto consuman más.

Mantén las organizaciones de Developer tools en un presupuesto Developer tools con un nivel predeterminado de 200 ACU. Crea un presupuesto Migration initiative con un límite de 5,000 ACU. Incluye en él la organización del proyecto y asígnale un nivel predeterminado de 1,000 ACU. Ambos presupuestos dependen del presupuesto de la cuenta.

![Developer tools con 20,000 ACU y un nivel predeterminado de 200 ACU, y Migration initiative con 5,000 ACU y un nivel predeterminado de 1,000 ACU.](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/budget-project.svg?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=a0d7477384a985d998a72ef8ae73f481)

Presupuestos Developer tools y Migration initiative con sus niveles

* Carol, desarrolladora del proyecto, puede usar hasta 1,000 ACU en la organización Migration y hasta 200 ACU en las organizaciones de Developer tools.
* El proyecto en su conjunto nunca puede superar los 5,000 ACU al mes.

![Selector de presupuestos de My Analytics](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/my-analytics-multi-budget.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=1b91652d38ed08edbcba1468f074af59)

Selector de presupuestos de My Analytics con varios presupuestos

## Cómo funcionan los presupuestos

### Árbol de presupuestos

Cada cuenta de empresa tiene un único árbol de presupuestos. La raíz es el **presupuesto de la cuenta** (Account budget), del que dependen los presupuestos hijos. Un árbol puede tener hasta tres niveles de profundidad.

Un presupuesto puede contener una o varias organizaciones. Cada organización pertenece a un único presupuesto. Las organizaciones nuevas se asignan al presupuesto de la cuenta.

Por ejemplo, Acme Corp establece un límite de 100,000 ACU en su presupuesto de la cuenta. Engineering divide su pool en tres presupuestos hijos.

![Presupuesto de la cuenta de 100,000 ACU con Engineering en 40,000 ACU y sus tres presupuestos hijos, y Developer tools en 20,000 ACU con tres niveles de límite por usuario.](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/budget-tree.svg?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=48dc89ce8cd22e3043b576e5349ce1e0)

Árbol de presupuestos con presupuestos y niveles de límite por usuario

Los niveles son límites por usuario dentro de un mismo presupuesto, no presupuestos independientes.

![Árbol de presupuestos con el uso de cada presupuesto](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/tree.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=cc09209e5169718deadade894b7b4802)

Árbol de presupuestos con el uso de cada presupuesto (datos de ejemplo)

### Límites de presupuesto

Un límite de presupuesto restringe el consumo combinado de ACU de las organizaciones del presupuesto y de las organizaciones de sus presupuestos hijos durante un período mensual. Un límite `null` significa que no hay límite.

* **El consumo se computa en todos los ancestros.** El consumo en un presupuesto hijo también se computa en su padre y en el presupuesto de la cuenta.
* **Un ancestro agotado bloquea a sus hijos.** Cuando cualquier presupuesto de la ruta se agota, el consumo en esa rama se detiene.
* **La suma de los límites de los hijos puede superar el límite del padre.** Aun así, el límite del padre sigue restringiendo su consumo combinado.
* **Un presupuesto sin límite sigue estando restringido por sus padres.**

Un presupuesto vinculado a una única organización comparte su límite con esa organización. Los [endpoints deprecados de límite de ACU a nivel de organización](https://docs.devin.ai/es/admin/billing/org-acu-limits#organization-endpoints) también lo establecen. También puedes usar el [endpoint de actualización](#update-a-budget) que se describe más abajo.

### Qué ocurre cuando se agota un presupuesto

Cuando se agota un presupuesto, se detiene el consumo en sus organizaciones. El consumo también se detiene si se agota cualquiera de sus presupuestos padre. El consumo se reanuda en el siguiente período mensual, o cuando un administrador aumenta el límite o establece un límite temporal.

* **Sesiones de Devin:** no se pueden iniciar sesiones nuevas y las sesiones en ejecución pasan a dormir. Los usuarios ven el mensaje "Increase your organization's usage limit."
* **Devin CLI y agente local de Desktop:** las solicitudes se bloquean. Los usuarios ven el mensaje "Your organization has reached its monthly usage limit. Ask an account admin to raise it, or wait for the limit to reset next month."
* **Devin Review:** se bloquean las nuevas revisiones.

![Banner del editor: límite de consumo alcanzado](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/cloud-limit-reached.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=419babb34f9e136d7cd10853b3d18074)

Banner del editor cuando se agota el presupuesto

### Período mensual

Los límites del presupuesto, los límites por usuario y los límites temporales se restablecen al inicio de cada período mensual. Cada período comienza el día de inicio de tu fase de facturación, por lo que no siempre coincide con el mes calendario.

Por ejemplo, si la fase de facturación comienza el día 15, los períodos van del 15 de octubre al 14 de noviembre, luego del 15 de noviembre al 14 de diciembre, y así sucesivamente.

Un **límite temporal** sustituye al límite del presupuesto durante el resto del período actual. El límite permanente vuelve a aplicarse en el siguiente período. Una anulación por usuario temporal vence al final del período actual.

![Presupuesto de Marketing con un límite temporal](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/limits-temporary.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=f5394365ee93dd0a9107ec8d650e8a93)

Un límite temporal aumenta el presupuesto de Marketing a 6,000 ACU solo durante este período

### Límites de usuario en un presupuesto

Los límites de usuario fijan cuánto puede consumir una persona en un período mensual. Cada presupuesto con una organización vinculada tiene sus propios límites de usuario, que se aplican únicamente dentro de ese presupuesto.

* **Niveles.** Cada presupuesto tiene sus propios niveles y un nivel predeterminado. Un nivel establece el límite mensual de ACU para sus miembros.
* **Asignaciones de grupos de IdP.** Asocia un grupo del proveedor de identidad a un nivel. Los miembros del grupo reciben ese nivel.
* **Excepciones.** Establece un límite permanente o temporal para un usuario concreto.
* **Políticas de solicitud.** Cada nivel define cómo se gestionan las solicitudes de aumento del límite. `unconditional` y `conditional` aprueban las solicitudes hasta el `max_limit` del nivel. `manual` envía las solicitudes a un administrador para que las revise.
* **Ámbito.** Un límite de usuario solo contabiliza el consumo del usuario en las organizaciones de ese presupuesto.
* **Copiar y borrar.** Copia niveles de otro presupuesto o de la cuenta. También puedes copiar asignaciones de grupos de IdP, asignaciones de usuarios y excepciones. Borra todos los niveles de un presupuesto para empezar de cero.

> [!WARNING]
>
> Un límite de usuario en un presupuesto padre no se extiende a sus presupuestos hijos. Por ejemplo, si Engineering también contiene una organización, un límite de usuario de 300 ACU en Engineering no limita el consumo de un usuario en Payments o Search.

![Diálogo Copiar políticas de uso](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/copy-policies.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=bafda52c62081f5c5d3d71266eff8cad)

Diálogo Copiar políticas de uso con Developer tools como origen

### Quién puede gestionar un presupuesto

Los Admin de Enterprise gestionan los presupuestos en **Enterprise Settings**, dentro de **Presupuestos**. Gestionan todo el árbol, incluido el presupuesto de la cuenta.

* **Delegación.** Un administrador empresarial puede compartir un presupuesto con una persona o un grupo desde la pestaña Manage access. Un administrador delegado puede crear presupuestos dentro de él y establecer límites y límites temporales en esos presupuestos hijos. La delegación debe habilitarse por separado; ponte en contacto con tu equipo de gestión de cuentas.
* **Un administrador delegado no puede aumentar el límite del propio presupuesto compartido.** Solo puede cambiarlo un administrador que gestione el presupuesto padre.
* **Los miembros** ven su propio consumo y su límite en My Analytics.

![Pestaña Manage access del presupuesto Engineering](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-access.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=a90c02116678e594ff6dfef6511b6724)

Pestaña Manage access del presupuesto Engineering, con Bob como gestor

## Preguntas frecuentes

> [accordion] ¿Pueden los Admin de org establecer el límite de ACU de una organización?
>
> No. Los límites de ACU de las organizaciones los establecen los Admin de Enterprise. Para que un equipo gestione sus propios límites, comparte un presupuesto con el administrador del equipo.

> [accordion] ¿Por qué el endpoint de límite de organización devuelve 409?
>
> Una vez que se hacen cumplir los límites de presupuesto en tu empresa, el endpoint de límite de organización devuelve HTTP `409` cuando la organización comparte su presupuesto con otras organizaciones o cuando está directamente en el presupuesto de la cuenta. El mensaje de error es «This organization has no limit of its own. Set the limit on its budget.». Por ejemplo, si Globex, Initech y Umbrella comparten un presupuesto, una operación de escritura del límite de Globex devuelve `409`.

> [accordion] ¿Cuándo se restablecen los límites?
>
> Al inicio de cada período mensual, que comienza el día de inicio de tu fase de facturación.

> [accordion] ¿Puede una organización estar en dos presupuestos?
>
> No. Cada organización pertenece a un único presupuesto, pero un presupuesto puede contener varias organizaciones.

## Gestionar presupuestos con la API V3

Todas las solicitudes se autentican con un **token de usuario de servicio** de la empresa. Quienes realicen las llamadas necesitan el permiso de cuenta **ManageAcuLimits** o [acceso delegado](#who-can-manage-a-budget) al presupuesto. Usa `https://api.devin.ai` como URL base. Consulta la [descripción general de la API V3](https://docs.devin.ai/es/api-reference/v3/overview.md) para obtener instrucciones sobre la autenticación y los usuarios de servicio.

Los endpoints de colección específicos del presupuesto incluyen el presupuesto en la ruta: `/v3beta1/enterprise/usage-policies/budgets/{budget_id}/...`. Los endpoints que hacen referencia a un único nivel o solicitud (`/tiers/{tier_id}`, `/requests/{request_id}`) determinan el presupuesto a partir del nivel o la solicitud, por lo que comparten sus rutas con los endpoints de toda la cuenta.

### Semántica de PATCH

En los endpoints `PATCH`:

* Si se omite un campo, no se modifica.
* Si un campo se establece en `null`, se borra.
* Si un campo se establece en un valor, se crea o se actualiza.

## Endpoints de presupuesto

### Listar presupuestos

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets
```

Devuelve una lista paginada de los presupuestos de la cuenta, tanto activos como archivados. Cada presupuesto tiene el siguiente formato:

```json theme={null}
{
  "budget_id": "budget-abc123",
  "name": "Engineering",
  "parent_budget_id": "budget-root",
  "org_ids": ["org-xyz789"],
  "status": "active",
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": null
}
```

* `budget_id`: el identificador que se usa en las rutas específicas del presupuesto.
* `parent_budget_id`: el presupuesto padre; `null` para el presupuesto raíz de la cuenta.
* `org_ids`: las organizaciones vinculadas a este presupuesto. Su consumo se imputa a este presupuesto. Está vacío si no hay ninguna organización vinculada.
* `status`: `active` o `archived`.
* `cycle_acu_limit`: el límite del presupuesto para el consumo de ACU que se le imputa a él y a sus descendientes en cada período de facturación mensual; `null` significa que no hay límite.
* `temporary_cycle_acu_limit`: un límite que anula `cycle_acu_limit` hasta el final del período de facturación mensual actual; `null` si no hay ninguno vigente.

### Actualizar un presupuesto

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}
```

Actualización parcial: los campos omitidos no se modifican y `null` borra un límite. Se requiere al menos un campo.

* `parent_budget_id`: mueve el presupuesto, junto con sus subpresupuestos, a otro presupuesto activo. El presupuesto raíz no se puede mover, y los presupuestos admiten como máximo tres niveles de anidamiento.
* `cycle_acu_limit`, `temporary_cycle_acu_limit`: los límites del presupuesto, igual que en la respuesta de listado.

**Cuerpo de la solicitud: establecer el límite y un aumento temporal para este mes**

```json theme={null}
{
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": 2500
}
```

**Cuerpo de la solicitud — eliminar los límites**

```json theme={null}
{
  "cycle_acu_limit": null,
  "temporary_cycle_acu_limit": null
}
```

**Cuerpo de la solicitud: mover el presupuesto a otro presupuesto**

```json theme={null}
{
  "parent_budget_id": "budget-platform"
}
```

Devuelve el presupuesto actualizado. Si vuelves a establecer `temporary_cycle_acu_limit`, se reinicia para el período actual. En un presupuesto vinculado exactamente a una organización, `cycle_acu_limit` también pasa a ser el límite de ACU de la organización.

## Endpoints de niveles

### Listar niveles

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

Devuelve una lista paginada de los niveles del presupuesto en orden de precedencia: primero el `priority` más alto y, dentro de una misma prioridad, primero el nivel más reciente. Cada nivel tiene esta estructura:

```json theme={null}
{
  "tier_id": "tier-abc123",
  "name": "Engineers",
  "is_default": true,
  "cycle_acu_limit": 500,
  "policy": "manual",
  "max_limit": null,
  "priority": 0,
  "member_count": 42,
  "created_at": 1735689600
}
```

* `is_default`: indica si este es el nivel predeterminado del presupuesto.
* `cycle_acu_limit`: el límite de ACU predeterminado por ciclo para cada miembro; `null` significa sin límite.
* `policy`: cómo se gestionan las solicitudes de aumento del límite para el nivel: `unconditional` y `conditional` las aprueban hasta `max_limit`, mientras que `manual` requiere la revisión de un administrador.
* `max_limit`: el límite máximo hasta el que se aprueban las solicitudes de aumento; `null` las aprueba sin tope. Siempre es `null` cuando `cycle_acu_limit` es `null`.
* `priority`: determina la prioridad del nivel entre los niveles que un usuario tiene asignados mediante un grupo del IdP: prevalece el valor más alto y, en caso de empate, el nivel más reciente. Una asignación explícita del usuario anula esta prioridad, y el nivel predeterminado nunca se tiene en cuenta en ella.
* `member_count`: el número de usuarios que pertenecen actualmente al nivel. En el caso del nivel predeterminado, incluye a todos los miembros del presupuesto que no están en otro nivel.

### Crear un nivel

```http theme={null}
POST /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

**Cuerpo de la solicitud**

```json theme={null}
{
  "name": "Engineers",
  "cycle_acu_limit": 500,
  "policy": "manual"
}
```

El primer nivel del presupuesto se convierte automáticamente en su nivel predeterminado. Devuelve HTTP `201` con el nivel creado.

### Obtener un nivel

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

### Actualizar un nivel

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

Actualización parcial: los campos omitidos se mantienen sin cambios.

```json theme={null}
{
  "name": "Engineering",
  "cycle_acu_limit": 750
}
```

### Eliminar un nivel

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

Devuelve HTTP `204` si la operación se completa correctamente. El nivel predeterminado no se puede eliminar (primero debes promover otro nivel). Si un nivel todavía tiene usuarios, primero debes moverlos a otro nivel y quitar todas las asignaciones de grupo de IdP vinculadas a ese nivel.

## Endpoints de usuarios por nivel

### Listar los usuarios de un nivel

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users
```

Devuelve una lista paginada de los usuarios del nivel con sus límites resueltos. En el caso del nivel predeterminado, incluye a todos los miembros del presupuesto que no pertenecen a ningún otro nivel:

```json theme={null}
{
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "cycle_acu_limit_override": null,
  "temporary_cycle_acu_limit": 800,
  "effective_cycle_acu_limit": 800,
  "limit_source": "temporary_override",
  "membership": "explicit"
}
```

* `cycle_acu_limit_override`: la anulación permanente del usuario, si existe.
* `temporary_cycle_acu_limit`: la anulación temporal del usuario; solo aparece mientras esté vigente en el período de facturación mensual actual.
* `effective_cycle_acu_limit`: el límite que se aplica actualmente al usuario; `null` significa sin límite.
* `limit_source`: el origen del límite efectivo: `override` (permanente), `temporary_override` o `tier`.
* `membership`: el motivo por el que el usuario pertenece al nivel: `explicit` (asignado directamente), `idp_group` (a través de la asignación de grupo de IdP que prevalece) o `default` (fallback al nivel predeterminado).

### Asignar un usuario a un nivel

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

Idempotente. Devuelve HTTP `204` si la operación se completa correctamente. Al mover a un usuario desde otro nivel, se borra cualquier configuración específica por usuario, por lo que pasa a heredar el límite del nivel de destino.

### Eliminar un usuario de un nivel

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

Elimina la asignación explícita de nivel del usuario (y cualquier anulación). A partir de ese momento, al usuario se le aplica su nivel asignado mediante un grupo del IdP, si existe, o, en su defecto, el nivel predeterminado. Devuelve HTTP `204` si la operación se realiza correctamente.

## Endpoints de usuario

### Obtener los límites de un usuario

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

Devuelve el nivel resuelto del usuario, sus límites y la solicitud pendiente dentro del presupuesto. Incluye los [campos de usuario del nivel](#list-a-tiers-users) descritos anteriormente, además de:

```json theme={null}
{
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "tier_cycle_acu_limit": 500,
  "pending_request_id": null,
  "pending_request_cycle_acu_limit": null
}
```

* `tier_id` / `tier_name`: el nivel del que se deriva el límite del usuario (asignación explícita, asignación de grupo de IdP o el nivel predeterminado); `null` cuando el presupuesto no tiene niveles.
* `tier_cycle_acu_limit`: el límite propio del nivel antes de aplicar cualquier anulación; `null` significa sin límite.
* `pending_request_id` / `pending_request_cycle_acu_limit`: la solicitud de aumento del límite pendiente del usuario y el límite que solicita, si la hay.

### Establecer o borrar la anulación de un usuario

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

User-scoped: el usuario de destino solo necesita ser miembro del presupuesto; no interviene ningún nivel y la asignación de nivel del usuario nunca se modifica.

**Cuerpo de la solicitud: establecer una anulación temporal**

```json theme={null}
{
  "cycle_acu_limit": 800,
  "kind": "temporary"
}
```

`kind` es obligatorio al establecer un valor: `permanent` nunca caduca; `temporary` caduca al final del período de facturación mensual actual.

**Cuerpo de la solicitud: borrar todas las excepciones**

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

El endpoint devuelve HTTP `204` si la operación se completa correctamente.

## Endpoints de grupos del IdP

Asocia un grupo del IdP a un nivel para que sus miembros hereden ese nivel automáticamente. Las asignaciones se resuelven en tiempo real a partir de la pertenencia a grupo y nunca modifican la asignación explícita de nivel de un usuario: una asignación explícita siempre prevalece. Si un usuario pertenece a varios grupos asociados, se le asigna el nivel asociado highest-ranked (el nivel con mayor `priority`; en caso de empate, prevalece el nivel más reciente).

### Listar asignaciones de grupos de IdP

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups
```

Devuelve una lista paginada de las asignaciones de grupos a niveles del presupuesto, de la más antigua a la más reciente. Filtra con `?tier_id=` para listar solo los grupos asociados a un nivel concreto:

```json theme={null}
{
  "idp_group_id": "grp_abc123",
  "idp_group_name": "Engineering",
  "tier_id": "tier-abc123"
}
```

### Obtener la asignación de un grupo del IdP

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

Devuelve HTTP `404` si el grupo no tiene ninguna asignación en el presupuesto.

### Asociar un grupo del IdP a un nivel

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

**Cuerpo de la solicitud**

```json theme={null}
{
  "tier_id": "tier-abc123"
}
```

Upsert idempotente. El nivel debe pertenecer al presupuesto. Un grupo solo puede estar asociado a un nivel por presupuesto, por lo que, si se asocia un grupo que ya lo está, este pasa al nivel indicado.

### Desasociar un grupo del IdP

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

Devuelve HTTP `204` si la operación se realiza correctamente. El nivel asociado deja de aplicarse a los miembros del grupo; los usuarios que no tengan una asignación explícita ni otro nivel asociado pasan al nivel predeterminado.

## Endpoints de solicitudes de aumento del límite

Los usuarios pueden solicitar un límite por ciclo más alto. La `policy` del nivel del solicitante determina qué ocurre: con `unconditional` y `conditional`, la solicitud se aprueba automáticamente hasta el `max_limit` del nivel, mientras que con `manual` queda retenida hasta que un administrador la revise mediante estos endpoints.

### Listar solicitudes de aumento del límite

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/requests
```

Devuelve una lista paginada de las solicitudes del presupuesto, filtrable con `?status=` (`pending`, `approved`, `denied`, `expired`) y `?user_id=`:

```json theme={null}
{
  "request_id": 42,
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "current_cycle_acu_limit": 500,
  "requested_cycle_acu_limit": 800,
  "message": "Wrapping up a large migration this month",
  "status": "pending",
  "created_at": 1735689600,
  "reviewed_at": null,
  "reviewer": null
}
```

* `tier_id` / `tier_name`: el nivel del solicitante dentro del presupuesto; `null` cuando el presupuesto no tiene niveles.
* `current_cycle_acu_limit`: el límite que se aplica actualmente al solicitante; `null` significa que no hay límite.
* `status`: `expired` indica que la solicitud seguía pendiente al finalizar su ciclo de facturación.
* `reviewer`: el administrador que revisó la solicitud; `null` mientras esté pendiente.

### Obtener una solicitud de aumento del límite

```http theme={null}
GET /v3beta1/enterprise/usage-policies/requests/{request_id}
```

### Aprobar una solicitud de aumento del límite

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/approve
```

Concede el límite solicitado como una **anulación temporal** que vence al final del período de facturación mensual actual. Opcionalmente, puedes conceder un límite distinto:

```json theme={null}
{
  "cycle_acu_limit": 700
}
```

Devuelve la solicitud actualizada. Devuelve HTTP `409` si la solicitud ya se revisó o si el solicitante ya no es miembro de la cuenta.

### Denegar una solicitud de aumento del límite

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/deny
```

Devuelve la solicitud actualizada o HTTP `409` si ya se revisó.

## Ejemplos de flujos de trabajo

### Configurar los niveles de un presupuesto

Busca el presupuesto, establece un límite de 2000 ACU al mes y luego crea un nivel predeterminado para que cada miembro del presupuesto tenga un límite mensual de 500 ACU:

```bash theme={null}
curl "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets" \
  -H "Authorization: Bearer <token>"

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 2000}'

curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Standard", "cycle_acu_limit": 500, "policy": "manual"}'
```

Asocia un grupo del IdP al nivel y concede a un usuario un aumento temporal para lo que queda de mes:

```bash theme={null}
curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/idp-groups/Engineering" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"tier_id": "tier-abc123"}'

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/users/user_abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 800, "kind": "temporary"}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.