Endpoint
Solicitud
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
Nombre visible actualizado
Metadata personalizado actualizado (se fusiona con el existente)
Contenido actualizado (solo para items de tipo text o json)
Respuesta
{
"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"
}
Para items de tipo file, solo se pueden actualizar name y metadata. Para reemplazar el archivo, elimine el item y suba uno nuevo.
Códigos de error
| Status | Code | Descripción |
|---|
| 404 | ITEM_NOT_FOUND | Item no encontrado |
