List Items in a Folder
GET /v1/folders/{folderId}/items
Request
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 | Description |
|---|
type | string | | Filter by item type: file, text, json |
search | string | | Search by item name |
sort | string | createdAt | Sort field: name, type, createdAt |
order | string | desc | Sort order: asc, desc |
Response
{
"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상호: 주식회사 아크미..."
}
]
}
MIME type (file items only)
File size in bytes (file items only)
URL to extracted text (for search/RAG)
Auto-detected file info: contentType, extension, fileCategory
OCR-extracted and refined text (null while processing)
Get Item by 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상호: 주식회사 아크미..."
}
The folder object is only included in the item detail response, not in the list response.
Error Codes
| Status | Code | Description |
|---|
| 404 | ITEM_NOT_FOUND | Item not found |
