POST /items/upload

Endpoint

POST /v1/folders/{folderId}/items/upload

Métodos de carga

Solo archivo
Solo texto/JSON
Archivo + texto (combinado)

Suba un archivo. Crea un item de tipo file.

curl -X POST "https://client-omni-api.argosidentity.com/v1/folders/{folderId}/items/upload" \
  -H "x-api-key: your-api-key-here" \
  -F "file=@/path/to/business_registration.pdf" \
  -F "metadata={\"documentType\":\"business_registration\"}"

Suba contenido de texto o JSON. Crea un item de tipo text o json.

curl -X POST "https://client-omni-api.argosidentity.com/v1/folders/{folderId}/items/upload" \
  -H "x-api-key: your-api-key-here" \
  -F "type=text" \
  -F "name=verification_notes" \
  -F "content=Document appears valid. No signs of tampering." \
  -F "metadata={\"author\":\"compliance_officer\"}"

Suba un archivo con contenido de texto adicional. El texto se combina con el archivo. Crea un item de tipo file.

curl -X POST "https://client-omni-api.argosidentity.com/v1/folders/{folderId}/items/upload" \
  -H "x-api-key: your-api-key-here" \
  -F "file=@/path/to/contract.pdf" \
  -F "content=Additional notes: This contract has been verified." \
  -F "metadata={\"verified\":true}"

Parámetros de solicitud (Form Data)

file

Archivo a subir. Se debe proporcionar file o content.

string

Tipo de item: file, text o json. Requerido cuando solo se proporciona content. Se ignora cuando se proporciona file.

string

Nombre visible (por defecto usa el nombre del archivo o se genera automáticamente)

string

Contenido de texto o JSON. Se debe proporcionar file o content.

string (JSON)

Metadata personalizado como cadena JSON

Respuesta (201 Created)

{
  "id": "item_abc123",
  "folderId": "fld_default001",
  "type": "file",
  "name": "business_registration.pdf",
  "content": null,
  "contentType": "application/pdf",
  "sizeBytes": 245678,
  "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
  "s3OriginalUrl": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../original.pdf",
  "detected": {
    "contentType": "application/pdf",
    "extension": "pdf",
    "fileCategory": "document"
  },
  "metadata": {
    "documentType": "business_registration"
  },
  "status": "PENDING",
  "processedAt": null,
  "rag": null,
  "createdAt": "2026-03-15T10:10:00Z"
}

string | null

URL del archivo original. Solo se incluye en las respuestas de carga/actualización, no en consultas de lista o detalle.

object | null

Información del archivo detectada automáticamente: contentType, extension, fileCategory

string | null

Texto extraído por OCR. null en la creación; se completa después del procesamiento.

Restricciones de archivo

Restricción	Valor
Tamaño máximo de archivo	10 MB
Máximo de items por folder	5

Formatos de archivo compatibles

Tipo de archivo	Extensiones	Procesamiento
Imágenes	jpg, jpeg, png, bmp, tiff, webp	OCR (extracción automática de texto)
PDF	pdf	OCR (extracción automática de texto)
Documentos de texto	txt, md, html, htm, csv	Lectura directa
Documentos de oficina	doc, docx, xls, xlsx	Extracción automática de texto

Procesamiento

Después de la carga, los items se procesan automáticamente:

Imágenes y PDFs: Extracción OCR (coreano e inglés)
Documentos de oficina: Extracción de texto y datos
Flujo de estado: PENDING → ACTIVE (o FAILED)

Haga polling de GET /v1/profiles/{profileId}/items/status cada 1 segundo (máx. 60 segundos) para verificar cuándo todos los items están listos para el análisis.

Códigos de error

Status	Code	Descripción
400	`FILE_OR_CONTENT_REQUIRED`	Se debe proporcionar `file` o `content`
400	`TYPE_REQUIRED`	`type` es requerido cuando solo se proporciona `content`
404	`FOLDER_NOT_FOUND`	Folder no encontrado
409	`ITEM_LIMIT_EXCEEDED`	Se superó el máximo de 5 items por folder
413	`FILE_TOO_LARGE`	El archivo supera el límite de 10 MB
415	`UNSUPPORTED_FILE_TYPE`	Formato de archivo no compatible

Descripción General

Referencia API

Endpoint

Métodos de carga

Parámetros de solicitud (Form Data)

Respuesta (201 Created)

Restricciones de archivo

Formatos de archivo compatibles

Procesamiento

Códigos de error

​Endpoint

​Métodos de carga

​Parámetros de solicitud (Form Data)

​Respuesta (201 Created)

​Restricciones de archivo

​Formatos de archivo compatibles

​Procesamiento

​Códigos de error

Endpoint

Métodos de carga

Parámetros de solicitud (Form Data)

Respuesta (201 Created)

Restricciones de archivo

Formatos de archivo compatibles

Procesamiento

Códigos de error