Skip to main content
PATCH
/
engine
/
v2
/
item
Update item metadata
curl --request PATCH \
  --url https://platform.ai.gloo.com/engine/v2/item \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "publisher_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "producer_id": "<string>",
  "item_title": "<string>",
  "item_subtitle": "<string>",
  "publication_date": "<string>",
  "item_image": "<string>",
  "item_url": "<string>",
  "item_summary": "<string>",
  "item_number": "<string>",
  "item_extra": "<string>",
  "author": [
    "<string>"
  ],
  "item_tags": [
    "<string>"
  ]
}
'
{
  "success": true,
  "message": "<string>"
}

Error Reference: Content Controls

Common errors: item not found (404), publisher not found (400), ownership mismatch (403), vector-store update failure (502).

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Update mutable metadata fields for an item. Provide either producer_id or item_id to identify the target item. (Both may be passed in together.)

​
item_id
string<uuid>
required

Item ID to update (preferred when available)

​
publisher_id
string<uuid>
required

Publisher ID that owns the item

​
producer_id
string | null

Producer-specific identifier for the item

​
item_title
string | null
​
item_subtitle
string | null
​
publication_date
string | null
​
item_image
string | null
​
item_url
string | null
​
item_summary
string | null
​
item_number
string | null
​
item_extra
string | null
​
author
string[] | null
​
item_tags
string[] | null

Response

Item updated successfully

​
success
boolean
required
​
message
string
required