Skip to main content
Update item-level metadata (titles, tags, authors, and more) without re-ingesting content, for one item or hundreds at once. The Content APIs handle both single-item and bulk updates; the Content Library in Studio’s Data Engine section edits one item at a time without code. To change the file itself, replace the item’s content.

Prerequisites

You need:
The caller must belong to the organization that owns the specified publisher.

Update a Single Item

Use the single-item endpoint to edit a specific item by its 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
Example Response:
You can identify items by either item_id (Gloo’s UUID) or producer_id (your internal ID). If you provide both, item_id takes precedence.
Full API details: Single Item Patch API Reference

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 of item_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
Example Response:
Full API details: Multiple Item Patch API Reference The 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 the visible_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.