GET /items

폴더의 아이템 목록 조회

GET /v1/folders/{folderId}/items

요청

curl -X GET "https://client-omni-api.argosidentity.com/v1/folders/{folderId}/items?type=file&sort=createdAt&order=desc" \
  -H "x-api-key: your-api-key-here"

쿼리 파라미터

파라미터	타입	기본값	설명
`type`	string		아이템 타입으로 필터: `file`, `text`, `json`
`search`	string		아이템 이름으로 검색
`sort`	string	`createdAt`	정렬 필드: `name`, `type`, `createdAt`
`order`	string	`desc`	정렬 순서: `asc`, `desc`

응답

{
  "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상호: 주식회사 아크미..."
    }
  ]
}

string | null

MIME 타입 (파일 아이템만 해당)

number | null

파일 크기 (바이트, 파일 아이템만 해당)

string | null

추출된 텍스트 URL (검색/RAG용)

object | null

자동 감지된 파일 정보: contentType, extension, fileCategory

string | null

OCR로 추출 및 정제된 텍스트 (처리 중에는 null)

아이템 ID로 조회

GET /v1/items/{itemId}

curl -X GET "https://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상호: 주식회사 아크미..."
}

folder 객체는 아이템 상세 응답에만 포함되며, 목록 응답에는 포함되지 않습니다.

에러 코드

상태	코드	설명
404	`ITEM_NOT_FOUND`	아이템을 찾을 수 없음

개요

API 참조

폴더의 아이템 목록 조회

요청

쿼리 파라미터

응답

아이템 ID로 조회

에러 코드

​폴더의 아이템 목록 조회

​요청

​쿼리 파라미터

​응답

​아이템 ID로 조회

​에러 코드

폴더의 아이템 목록 조회

요청

쿼리 파라미터

응답

아이템 ID로 조회

에러 코드