GET /items

Esta página cubre dos endpoints de lectura de ítems.

Propósito	Endpoint
Ítems de una carpeta	`GET /v1/folders/{folderId}/items`
Un ítem concreto	`GET /v1/items/{itemId}`

Listar ítems

GET /v1/folders/{folderId}/items

No hay paginación. Se devuelven de una vez todos los ítems de la carpeta, y la respuesta lleva solo count e items.

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
`type`	`string`		Filtro por tipo: `file` · `text` · `json`
`search`	`string`		Coincidencia parcial con el nombre del ítem
`sort`	`string`	`createdAt`	`name` · `type` · `createdAt`
`order`	`string`	`desc`	`asc` · `desc`

curl "https://client-omni-api.argosidentity.com/v1/folders/fd_9pq2mklt83bx/items?sort=createdAt&order=asc" \
  -H "x-api-key: your-api-key-here"

Respuesta

{
  "count": 3,
  "items": [
    {
      "id": "item_axfkh2noof85",
      "folderId": "fd_9pq2mklt83bx",
      "type": "text",
      "name": "certificate of good standing",
      "content": "STATE OF DELAWARE\nCERTIFICATE OF GOOD STANDING\n\nEntity name: ACME TRADING LLC\nState file number: 7412583 ...",
      "contentType": "text/plain",
      "sizeBytes": 538,
      "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
      "detected": null,
      "metadata": { "doc_type": "certificate_of_good_standing" },
      "status": "ACTIVE",
      "processedAt": "2026-09-10T05:35:38.902Z",
      "rag": "certificate of good standing ACME TRADING LLC state file number 7412583 Delaware ...",
      "createdAt": "2026-09-10T05:35:31.412Z"
    }
  ]
}

Campos de la respuesta

Campo	Tipo	Descripción
`count`	`number`	Número de ítems
`items[].id`	`string`	ID del ítem (prefijo `item_`)
`items[].folderId`	`string`	ID de la carpeta a la que pertenece
`items[].type`	`string`	`file` · `text` · `json`
`items[].name`	`string`	Nombre del ítem
`items[].content`	`string \| object \| null`	El cuerpo que envió al añadir el ítem. `null` para el tipo `file`
`items[].contentType`	`string \| null`	Tipo MIME
`items[].sizeBytes`	`number \| null`	Tamaño en bytes
`items[].url`	`string \| null`	URL en S3 del texto extraído. Solo se rellena mientras `status` es `ACTIVE`
`items[].detected`	`object \| null`	Datos detectados automáticamente (`contentType`, `extension`, `fileCategory`). Solo para el tipo archivo
`items[].metadata`	`object \| null`	Metadatos propios
`items[].status`	`string`	`PENDING` · `ACTIVE` · `FAILED`
`items[].processedAt`	`string \| null`	Fin del procesamiento. `null` mientras está `PENDING`
`items[].rag`	`string \| null`	El cuerpo extraído y depurado que usa realmente el análisis. Solo se rellena mientras está `ACTIVE`
`items[].createdAt`	`string`	Fecha de creación

s3OriginalUrl (la URL del archivo original) aparece solo en las respuestas de creación y actualización, nunca en una de lectura.

Leer un ítem

GET /v1/items/{itemId}

Los mismos campos que una entrada de lista, más un objeto folder.

curl "https://client-omni-api.argosidentity.com/v1/items/item_axfkh2noof85" \
  -H "x-api-key: your-api-key-here"

Respuesta

{
  "id": "item_axfkh2noof85",
  "folderId": "fd_9pq2mklt83bx",
  "type": "text",
  "name": "certificate of good standing",
  "content": "STATE OF DELAWARE\nCERTIFICATE OF GOOD STANDING\n\nEntity name: ACME TRADING LLC\nState file number: 7412583 ...",
  "contentType": "text/plain",
  "sizeBytes": 538,
  "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
  "detected": null,
  "metadata": { "doc_type": "certificate_of_good_standing" },
  "status": "ACTIVE",
  "processedAt": "2026-09-10T05:35:38.902Z",
  "rag": "certificate of good standing ACME TRADING LLC state file number 7412583 Delaware ...",
  "folder": {
    "id": "fd_9pq2mklt83bx",
    "name": "default"
  },
  "createdAt": "2026-09-10T05:35:31.412Z"
}

Campo	Tipo	Descripción
`folder.id`	`string`	ID de la carpeta a la que pertenece
`folder.name`	`string`	Nombre de la carpeta a la que pertenece

Códigos de error

Estado	Código	Descripción
404	`OMNI_3009`	Carpeta no encontrada (lista)
404	`OMNI_3006`	Ítem no encontrado (ítem concreto)

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

Listar ítems

Parámetros de consulta

Respuesta

Campos de la respuesta

Leer un ítem

Respuesta

Códigos de error

​Listar ítems

​Parámetros de consulta

​Respuesta

​Campos de la respuesta

​Leer un ítem

​Respuesta

​Códigos de error

Listar ítems

Parámetros de consulta

Respuesta

Campos de la respuesta

Leer un ítem

Respuesta

Códigos de error