PATCH /items/:itemId - ARGOS Identity

Only the fields you send change. content can be updated only on text and json items.

Endpoint

PATCH /v1/items/{itemId}

Request

Path parameters

Parameter	Type	Description
`itemId`	`string`	ID of the item to update (`item_` prefix)

Request body

Field	Type	Description
`name`	`string`	Item name
`content`	`string \| object`	Body. Updatable on `text` and `json` types only
`metadata`	`object`	Your own metadata. It is replaced in full, not merged

curl -X PATCH "https://client-omni-api.argosidentity.com/v1/items/item_axfkh2noof85" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "certificate of good standing (resubmitted)",
    "metadata": { "doc_type": "certificate_of_good_standing", "resubmitted": "true" }
  }'

On a file item you can change only name and metadata. To replace the file itself, delete the item and add it again.

Response (200 OK)

{
  "id": "item_axfkh2noof85",
  "folderId": "fd_9pq2mklt83bx",
  "type": "text",
  "name": "certificate of good standing (resubmitted)",
  "content": "STATE OF DELAWARE\nCERTIFICATE OF GOOD STANDING\n\nEntity name: ACME TRADING LLC\nState file number: 7412583 ...",
  "contentType": "text/plain",
  "sizeBytes": 538,
  "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
  "s3OriginalUrl": null,
  "detected": null,
  "metadata": { "doc_type": "certificate_of_good_standing", "resubmitted": "true" },
  "status": "ACTIVE",
  "processedAt": "2026-09-10T05:35:38.902Z",
  "rag": "certificate of good standing ACME TRADING LLC state file number 7412583 Delaware ...",
  "createdAt": "2026-09-10T05:35:31.412Z"
}

The field definitions match read items. The update response also carries s3OriginalUrl (the original file URL, file type only), which read responses do not have.

Error codes

Status	Code	Description
400	`OMNI_2205`	`content` cannot be updated on a `file` item. Delete it and add it again
404	`OMNI_3006`	Item not found

Common errors (400 validation · 401 authentication · 403 permission · 500 server) are listed in the API overview.

⌘I