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

> Update an item's metadata or content.

## Endpoint

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

## Request

```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" }
  }'
```

### Request Body

<ResponseField name="name" type="string">
  Updated display name
</ResponseField>

<ResponseField name="metadata" type="object">
  Updated custom metadata (merged with existing)
</ResponseField>

<ResponseField name="content" type="string | object">
  Updated content (only for `text` or `json` type items)
</ResponseField>

## Response

```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>
  For `file` type items, only `name` and `metadata` can be updated. To replace the file itself, delete the item and upload a new one.
</Note>

### Error Codes

| Status | Code             | Description    |
| ------ | ---------------- | -------------- |
| 404    | `ITEM_NOT_FOUND` | Item not found |