Skip to main content
PATCH
/
engine
/
v2
/
items
Patch Multiple Items
curl --request PATCH \
  --url https://platform.ai.gloo.com/engine/v2/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filter": {
    "item_ids": [
      "<string>"
    ],
    "types": [
      "<string>"
    ],
    "statuses": [
      "<string>"
    ],
    "authors": [
      "<string>"
    ],
    "tags": [
      "<string>"
    ],
    "evergreen": true,
    "visible_in_search": true,
    "visible_in_chat": true,
    "search": "<string>",
    "created_after": "<string>",
    "created_before": "<string>",
    "updated_after": "<string>",
    "updated_before": "<string>"
  },
  "ops": [
    {
      "field": "<string>",
      "value": "<unknown>"
    }
  ],
  "limit": 100
}
'
{
  "success": true,
  "total_matched": 123,
  "total_patched": 123,
  "total_failed": 123,
  "results": [
    {
      "item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "success": true,
      "error": "<string>",
      "etag": "<string>",
      "updated_at": "<string>"
    }
  ],
  "message": "<string>",
  "filter_applied": {
    "item_ids": [
      "<string>"
    ],
    "types": [
      "<string>"
    ],
    "statuses": [
      "<string>"
    ],
    "authors": [
      "<string>"
    ],
    "tags": [
      "<string>"
    ],
    "evergreen": true,
    "visible_in_search": true,
    "visible_in_chat": true,
    "search": "<string>",
    "created_after": "<string>",
    "created_before": "<string>",
    "updated_after": "<string>",
    "updated_before": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gloo.com/llms.txt

Use this file to discover all available pages before exploring further.

Error Reference: Content Controls

Common errors: missing patch operations (400), publisher not found (400), validation errors (422), bulk patch failure (500).

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
publisher_id
string<uuid>
required

Body

application/json
​
filter
MultiItemPatchFilter · object
required
​
ops
PatchOperation · object[]
required
Minimum array length: 1
​
limit
integer
default:100
Required range: 1 <= x <= 10000

Response

Successful Response

​
success
boolean
required
​
total_matched
integer
required
​
total_patched
integer
required
​
total_failed
integer
required
​
results
ItemPatchResult · object[]
required
​
message
string
required
​
filter_applied
MultiItemPatchFilter · object
required