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

# Límites de ACU por usuario

> Consulta y establece anulaciones de límites de ACU por usuario mediante la API de claves de servicio.

<Info>
  Esta documentación corresponde a los despliegues federales de Devin. [Volver a la documentación de Devin](/es/get-started/devin-intro)
</Info>

Consulta y gestiona las anulaciones de límites de ACU por usuario. Una anulación por usuario prevalece sobre los límites de equipo y grupo; consulta [Límites de ACU](/es/federal/acu-limits) para saber cómo se determina el límite efectivo. Estos endpoints solo están disponibles en despliegues federales multi-tenant. Usan **Teams Read-Only** para las lecturas y **Teams Update** para las escrituras.

Ambos endpoints seleccionan al usuario mediante un objeto `user` que contiene exactamente uno de los siguientes campos:

<ParamField body="user.email" type="string">
  La dirección de correo electrónico del usuario.
</ParamField>

<ParamField body="user.user_id" type="string">
  El ID estable del usuario, tal como lo devuelve la API (por ejemplo, en filas de [miembros de un grupo](/es/federal/api/group-management#list-group-members) o de [consumo de ACU](/es/federal/api/acu-consumption)).
</ParamField>

Las claves de servicio con ámbito de grupo solo pueden seleccionar miembros actuales del grupo asignado; para otros usuarios se devuelve `not_found`. Consulta la [descripción general de la API](/es/federal/api/overview) para obtener información sobre autenticación y errores.

El objeto de límite que devuelven ambos endpoints:

| Campo                        | Descripción                                                                                                                                               |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                    | El ID estable del usuario.                                                                                                                                |
| `email`                      | El correo electrónico del usuario.                                                                                                                        |
| `configured_cycle_acu_limit` | La anulación directa por usuario, si se ha establecido. Un valor de `0` significa que el usuario está bloqueado. Se omite si no existe ninguna anulación. |
| `effective_cycle_acu_limit`  | El límite que se aplica realmente al usuario después de combinar la anulación con los límites de equipo y grupo. Se omite si no se aplica ningún límite.  |

***

<div id="get-a-users-acu-cap">
  ## Obtener el límite de ACU de un usuario
</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">
  ## Establecer o quitar el límite de ACU de un usuario
</div>

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

Se debe proporcionar exactamente uno de los siguientes:

<ParamField body="set_cycle_acu_limit" type="number">
  Establece la anulación del límite de ACU por ciclo del usuario. Debe ser un valor no negativo; `0` impide que el usuario consuma ACU.
</ParamField>

<ParamField body="clear_cycle_acu_limit" type="boolean">
  Elimina la anulación del usuario para que vuelvan a aplicarse los límites del equipo y del grupo.
</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
  }'
```

La respuesta contiene el objeto `cap` actualizado.

<Note>
  Una anulación de usuario de `0` **bloquea** al usuario. La API de grupos de claves de servicio no acepta un límite de grupo de cero: `set_cycle_acu_limit` debe ser positivo y `clear_cycle_acu_limit` elimina la anulación del grupo. La operación independiente del portal para establecer el límite de grupo considera que `0` como una eliminación. Consulta [Valores cero y no establecidos](/es/federal/acu-limits#zero-and-unset-values).
</Note>