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

> Actualice la metadata o el contenido de un item.

## Endpoint

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

## Solicitud

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

### Cuerpo de la solicitud

<ResponseField name="name" type="string">
  Nombre visible actualizado
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadata personalizado actualizado (se fusiona con el existente)
</ResponseField>

<ResponseField name="content" type="string | object">
  Contenido actualizado (solo para items de tipo `text` o `json`)
</ResponseField>

## Respuesta

```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>
  Para items de tipo `file`, solo se pueden actualizar `name` y `metadata`. Para reemplazar el archivo, elimine el item y suba uno nuevo.
</Note>

### Códigos de error

| Status | Code             | Descripción        |
| ------ | ---------------- | ------------------ |
| 404    | `ITEM_NOT_FOUND` | Item no encontrado |