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

# POST /analyses/:profileId/analyze

> Dispare un análisis impulsado por IA sobre los items de un profile. Se ejecuta de forma asíncrona y devuelve de inmediato un analysis ID.

## Endpoint

```text theme={null}
POST /v1/analyses/{profileId}/analyze
```

## Request

```bash theme={null}
curl -X POST "http://client-omni-api.argosidentity.com/v1/analyses/{profileId}/analyze" \
  -H "x-api-key: su-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_abc123" },
      { "itemId": "item_def456" }
    ]
  }'
```

## Request Body

<ResponseField name="targetItems" type="array" required>
  Lista de items que se incluirán en el análisis
</ResponseField>

<ResponseField name="targetItems[].itemId" type="string" required>
  Item ID (`item_`). Debe pertenecer al profile y estar en `ACTIVE`
</ResponseField>

## Response

```json theme={null}
{
  "id": "analysis_xyz789"
}
```

<ResponseField name="id" type="string" required>
  Analysis ID único (`analysis_`)
</ResponseField>

## Notas importantes

<Note>
  El análisis se ejecuta **asíncronamente**. Use [GET /analyses/:analysisId](/es/omni/api-reference/get-analysis) para consultar estado y resultados.
</Note>

<Warning>
  Se conservan como máximo **5 analyses** por profile. Si se supera este límite, el más antiguo se elimina automáticamente.
</Warning>

* Todos los target items deben estar en estado `ACTIVE`. Los items en otros estados serán rechazados.
* Solo puede ejecutarse **un análisis a la vez** por profile. Intentar iniciar un segundo análisis mientras hay uno en progreso devolverá un error `409`.

***

## Códigos de error

| Status | Code                   | Descripción                                                        |
| ------ | ---------------------- | ------------------------------------------------------------------ |
| 400    | `INVALID_ITEM_IDS`     | Uno o más items no existen o no pertenecen al profile especificado |
| 404    | `PROFILE_NOT_FOUND`    | El profile especificado no fue encontrado                          |
| 409    | `ANALYSIS_IN_PROGRESS` | Ya hay un análisis en ejecución para este profile                  |