POST /analyses/:profileId/analyze

Los análisis se ejecutan de forma asíncrona. Este endpoint devuelve únicamente el ID del análisis; el resultado se obtiene sondeando leer análisis.

Endpoint

POST /v1/analyses/{profileId}/analyze

Petición

Parámetros de ruta

Parámetro	Tipo	Descripción
`profileId`	`string`	ID del perfil a analizar (prefijo `pf_`)

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`targetItems`	`object[]`	Obligatorio	Ítems que se incluyen en el análisis. Al menos uno
`targetItems[].itemId`	`string`	Obligatorio	ID del ítem (prefijo `item_`). Debe pertenecer a este perfil y estar `ACTIVE`

curl -X POST "https://client-omni-api.argosidentity.com/v1/analyses/pf_6h4y8s2f0v9n/analyze" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_axfkh2noof85" },
      { "itemId": "item_lxzzl2vedy9y" },
      { "itemId": "item_wfepr5xxo6w2" }
    ]
  }'

Respuesta (202 Accepted)

{
  "id": "analysis_lsc7icgm9cjd"
}

Campo	Tipo	Descripción
`id`	`string`	ID del análisis (prefijo `analysis_`)

Condiciones y restricciones

Elemento	Detalle
Estado de los ítems	Todos los ítems objetivo deben estar `ACTIVE`. En caso contrario, `400` `OMNI_2109`
Concurrencia	Un análisis por perfil. Volver a pedirlo mientras hay uno en curso devuelve `409` `OMNI_2201`
Límite de prueba	10 al día por proyecto. Al superarlo, `429` `OMNI_2004`
Retención	Los 5 análisis más recientes por perfil. Más allá, el más antiguo se elimina automáticamente

Antes de ejecutarlo, compruebe que isRagReady es true con el estado de los ítems.

Códigos de error

Estado	Código	Descripción
400	`OMNI_2109`	Un ítem no existe o no pertenece a este perfil
404	`OMNI_3005`	Perfil no encontrado
409	`OMNI_2201`	Ya hay un análisis en curso en este perfil
429	`OMNI_2004`	Superado el límite diario de análisis (10) de un proyecto de prueba

Los errores comunes (400 validación · 401 autenticación · 403 permisos · 500 servidor) están en la descripción general de la API.

Descripción General

Referencia API

POST /analyses/:profileId/analyze

Endpoint

Petición

Parámetros de ruta

Cuerpo de la petición

Respuesta (202 Accepted)

Condiciones y restricciones

Códigos de error

​Endpoint

​Petición

​Parámetros de ruta

​Cuerpo de la petición

​Respuesta (202 Accepted)

​Condiciones y restricciones

​Códigos de error

Endpoint

Petición

Parámetros de ruta

Cuerpo de la petición

Respuesta (202 Accepted)

Condiciones y restricciones

Códigos de error