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

# Inicio rápido

> Ejecute su primer workflow de verificación de Omni de punta a punta en pocos minutos.

Esta guía recorre el flujo completo de la Omni API: crear un profile, subir documentos y ejecutar un análisis.

## Requisitos previos

* Una Omni API key ([consígala aquí](/es/omni/getting-started/authentication))
* Un proyecto con al menos un workflow configurado

<Info>
  Si todavía no ha configurado un workflow, créelo primero en el dashboard de Omni. Consulte [Crear un workflow](/es/omni/guides/creating-a-workflow) para ver el proceso completo.
</Info>

## Flujo de punta a punta

<Steps>
  <Step title="Obtener project y workflow">
    Primero, consulte su proyecto para identificar los workflows disponibles.

    ```bash theme={null}
    curl -X GET "http://client-omni-api.argosidentity.com/v1/projects/{projectId}" \
      -H "x-api-key: su-api-key-here"
    ```

    Tome nota del `workflowId` que quiere usar.
  </Step>

  <Step title="Crear un profile">
    Cree un nuevo profile dentro del workflow. Cada profile representa un caso de verificación.

    ```bash theme={null}
    curl -X POST "http://client-omni-api.argosidentity.com/v1/workflows/{workflowId}/profiles" \
      -H "x-api-key: su-api-key-here" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Acme Corp - KYB Verification"
      }'
    ```

    La respuesta incluye el `profileId` y un folder predeterminado.
  </Step>

  <Step title="Subir items">
    Suba documentos al folder predeterminado. Omni admite imágenes (JPG, PNG), PDFs y documentos de oficina.

    ```bash theme={null}
    curl -X POST "http://client-omni-api.argosidentity.com/v1/folders/{folderId}/items/upload" \
      -H "x-api-key: su-api-key-here" \
      -F "file=@/path/to/id-document.jpg" \
      -F "type=file"
    ```

    <Note>
      Tamaño máximo por archivo: **10MB**. Máximo de items por folder: **5**. Formatos compatibles: JPG, PNG, PDF, TXT, DOC, DOCX, XLS, XLSX, BMP, TIFF, WEBP, CSV, HTML y MD.
    </Note>
  </Step>

  <Step title="Esperar el procesamiento">
    Después de la carga, los items pasan por procesamiento automático (OCR, extracción de texto). Consulte el estado hasta que todos los items estén en `ACTIVE`.

    ```bash theme={null}
    curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/items/status" \
      -H "x-api-key: su-api-key-here"
    ```

    ```json theme={null}
    {
      "total": 1,
      "pending": 0,
      "active": 1,
      "failed": 0
    }
    ```

    <Tip>
      Haga polling cada **1 segundo** con un **timeout de 60 segundos**. Todos los items deben llegar a estado `ACTIVE` antes de ejecutar el análisis.
    </Tip>
  </Step>

  <Step title="Ejecutar el análisis">
    Cuando todos los items estén activos, dispare el análisis. La policy, los engines y el output schema del workflow se aplican automáticamente.

    ```bash theme={null}
    curl -X POST "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/analyze" \
      -H "x-api-key: su-api-key-here"
    ```

    El análisis se ejecuta de forma asíncrona. Consulte el profile para revisar los resultados.
  </Step>

  <Step title="Recuperar resultados">
    Una vez finalizado el análisis, obtenga los resultados estructurados.

    ```bash theme={null}
    curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}" \
      -H "x-api-key: su-api-key-here"
    ```

    Los resultados siguen el output schema del workflow; el objeto `decision` incluye `verificationStatus` (`pending_review`, `approved` o `rejected`).
  </Step>
</Steps>

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Panel de control" icon="sliders" href="/es/omni/dashboard/overview">
    Aprenda a configurar workflows, policies y engines desde el dashboard.
  </Card>

  <Card title="Referencia de la API" icon="code" href="/es/omni/api-reference/overview">
    Explore la documentación completa de la API.
  </Card>
</CardGroup>
