Prerequisites
You need:- A Gloo AI Studio account
- For the API, your API key from the API Keys page
- For the API, authentication setup - Complete the Authentication Tutorial first
The caller must belong to the organization that owns the specified publisher.
Update a Single Item
- Via API
- Via Gloo AI Studio
Use the single-item endpoint to edit a specific item by its Example Response:Full API details: Single Item Patch API Reference
item_id or your producer_id.When to use:- Correcting a typo in a title
- Adding missing author or tags
- Updating a summary or publication date
Shell
Editable Fields
isbn, evergreen, visible_in_search, and visible_in_chat are editable only through the bulk PATCH /engine/v2/items endpoint. The single-item endpoint silently ignores these fields and returns them under ignored_fields.Update Multiple Items
Use the bulk endpoint to update many items at once: filter by author, tags, status, date ranges, or search terms, then apply operations to every match. When to use:- Adding a tag across all items by a specific author
- Updating metadata for a content series
- Standardizing fields after a catalog audit
Filter Options
Target items with any combination ofitem_ids, types, authors, tags, processing statuses, flags (evergreen, visible_in_search, visible_in_chat), date ranges (created_after / created_before, updated_after / updated_before), and search, a text search across titles, subtitles and summaries. The Multiple Item Patch API reference lists every filter field.
Operations
Apply one or more operations to matched items:- replace — Set a field to a new value
- append — Add values to a list (authors, tags)
- remove — Clear a field or remove values from a list
Shell
publisher_id in API requests is the unique identifier for your Publisher. See publisher_id in the glossary.
Common Use Cases
Correcting Metadata
Fix typos, add missing authors, or update summaries with the single-item endpoint.Bulk Tagging
Apply category tags (e.g., “Gospel of John”, “Marriage Series”) across hundreds of items by filtering on author or date range.Standardizing Fields
After a catalog audit, use bulk operations to make metadata consistent across your library.Managing Visibility
Control which items appear in search or chat with thevisible_in_search and visible_in_chat flags.
Next steps
To decide which metadata to set at upload and which to edit later, see Preparing Content for Ingestion. Upload Files to Data Engine walks through an upload end to end.Manage Content
Look up and list items in your collection.
Upload Content
Add new content to the Data Engine.
API Reference
Request details for updating an item.

