Listar items de una carpeta
GET /v1/folders/{folderId}/items
Solicitud
curl -X GET "http://client-omni-api.argosidentity.com/v1/folders/{folderId}/items?type=file&sort=createdAt&order=desc" \
-H "x-api-key: your-api-key-here"
Query Parameters
| Parameter | Type | Default | Descripción |
|---|
type | string | | Filtrar por tipo de item: file, text, json |
search | string | | Buscar por nombre de item |
sort | string | createdAt | Campo de ordenación: name, type, createdAt |
order | string | desc | Orden: asc, desc |
Respuesta
{
"count": 2,
"items": [
{
"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",
"detected": {
"contentType": "application/pdf",
"extension": "pdf",
"fileCategory": "document"
},
"metadata": {
"documentType": "business_registration"
},
"status": "ACTIVE",
"processedAt": "2026-03-15T10:10:05Z",
"createdAt": "2026-03-15T10:10:00Z",
"rag": "사업자등록증\n상호: 주식회사 아크미..."
}
]
}
Tipo MIME (solo para items de tipo file)
Tamaño del archivo en bytes (solo para items de tipo file)
URL del texto extraído (para search/RAG)
Información del archivo detectada automáticamente: contentType, extension, fileCategory
Texto extraído y refinado por OCR (null durante el procesamiento)
Obtener item por ID
curl -X GET "http://client-omni-api.argosidentity.com/v1/items/{itemId}" \
-H "x-api-key: your-api-key-here"
{
"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",
"detected": {
"contentType": "application/pdf",
"extension": "pdf",
"fileCategory": "document"
},
"metadata": {
"documentType": "business_registration"
},
"status": "ACTIVE",
"processedAt": "2026-03-15T10:10:05Z",
"folder": {
"id": "fld_default001",
"name": "default"
},
"createdAt": "2026-03-15T10:10:00Z",
"rag": "사업자등록증\n상호: 주식회사 아크미..."
}
El objeto folder solo se incluye en la respuesta de detalle del item, no en la respuesta de lista.
Códigos de error
| Status | Code | Descripción |
|---|
| 404 | ITEM_NOT_FOUND | Item no encontrado |
