> ## 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.

# PATCH /items/:itemId

> 아이템의 메타데이터 또는 콘텐츠를 업데이트합니다.

## 엔드포인트

```
PATCH /v1/items/{itemId}
```

## 요청

```bash theme={null}
curl -X PATCH "http://client-omni-api.argosidentity.com/v1/items/{itemId}" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "primary-id.jpg",
    "metadata": { "documentType": "passport" }
  }'
```

### 요청 본문

<ResponseField name="name" type="string">
  업데이트할 표시 이름
</ResponseField>

<ResponseField name="metadata" type="object">
  업데이트할 사용자 정의 메타데이터 (기존 데이터와 병합)
</ResponseField>

<ResponseField name="content" type="string | object">
  업데이트할 콘텐츠 (`text` 또는 `json` 타입 아이템만 해당)
</ResponseField>

## 응답

```json theme={null}
{
  "id": "item_abc123",
  "folderId": "fld_default001",
  "type": "file",
  "name": "primary-id.jpg",
  "content": null,
  "contentType": "image/jpeg",
  "sizeBytes": 245678,
  "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
  "s3OriginalUrl": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../original.jpg",
  "detected": {
    "contentType": "image/jpeg",
    "extension": "jpg",
    "fileCategory": "image"
  },
  "metadata": { "documentType": "passport" },
  "status": "ACTIVE",
  "processedAt": "2026-03-15T10:10:05Z",
  "createdAt": "2026-03-15T10:10:00Z"
}
```

<Note>
  `file` 타입 아이템의 경우 `name`과 `metadata`만 업데이트할 수 있습니다. 파일 자체를 교체하려면 아이템을 삭제하고 새로 업로드하세요.
</Note>

### 에러 코드

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