> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /items

> 폴더의 아이템 목록 조회 또는 특정 아이템 조회.

## 폴더의 아이템 목록 조회

```
GET /v1/folders/{folderId}/items
```

### 요청

```bash theme={null}
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"
```

### 쿼리 파라미터

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

### 응답

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

<ResponseField name="items[].contentType" type="string | null">
  MIME 타입 (파일 아이템만 해당)
</ResponseField>

<ResponseField name="items[].sizeBytes" type="number | null">
  파일 크기 (바이트, 파일 아이템만 해당)
</ResponseField>

<ResponseField name="items[].url" type="string | null">
  추출된 텍스트 URL (검색/RAG용)
</ResponseField>

<ResponseField name="items[].detected" type="object | null">
  자동 감지된 파일 정보: `contentType`, `extension`, `fileCategory`
</ResponseField>

<ResponseField name="items[].rag" type="string | null">
  OCR로 추출 및 정제된 텍스트 (처리 중에는 `null`)
</ResponseField>

***

## 아이템 ID로 조회

```
GET /v1/items/{itemId}
```

```bash theme={null}
curl -X GET "http://client-omni-api.argosidentity.com/v1/items/{itemId}" \
  -H "x-api-key: your-api-key-here"
```

```json theme={null}
{
  "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상호: 주식회사 아크미..."
}
```

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

### 에러 코드

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