Skip to main content
The Content APIs let you update item-level metadata—titles, tags, authors, and more—without re-ingesting content. Make quick edits to individual items or apply changes across hundreds of items at once.

​
Prerequisites

Before starting, ensure you have:
The caller must belong to the organization that owns the specified publisher.

​
Update a Single Item

Use the single-item endpoint when you need 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
curl -X PATCH https://platform.ai.gloo.com/engine/v2/item \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "publisher_id": "your-publisher-id",
    "item_id": "37328826-e527-4039-8996-bd27741b6f8e",
    "item_title": "Updated Title",
    "item_tags": ["theology", "sermons"]
  }'
Example Response: 
{
  "success": true,
  "message": "Item 37328826-e527-4039-8996-bd27741b6f8e has been updated."
}
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

​
Update Multiple Items

Use the bulk endpoint when you need to update many items matching specific criteria. Filter by author, tags, status, date ranges, or search terms, then apply operations to all matching items. 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 using any combination of:
  • item_ids — Specific item UUIDs
  • authors — Items by specific authors
  • tags — Items with specific tags
  • statuses — Items in specific processing states
  • search — Text search across titles, subtitles, summaries
  • created_after / created_before — Date ranges
  • visible_in_search / visible_in_chat — Visibility flags

​
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
curl -X PATCH "https://platform.ai.gloo.com/engine/v2/items?publisher_id=your-publisher-id" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "authors": ["John Smith"],
      "visible_in_search": true
    },
    "ops": [
      {
        "op": "append",
        "field": "item_tags",
        "value": ["series-2024"]
      }
    ],
    "limit": 500
  }'
Example Response: 
{
  "success": true,
  "total_matched": 42,
  "total_patched": 42,
  "total_failed": 0,
  "message": "Successfully patched 42 of 42 items"
}
Full API details: Multiple Item Patch API Reference

​
Editable Fields

Field TypeFields
Stringsitem_title, item_subtitle, item_summary, item_image, item_url, item_number, item_extra, isbn, publication_date
Listsauthor, item_tags
Booleansevergreen, visible_in_search, visible_in_chat

​
Common Use Cases

​
Correcting Metadata

Fix typos, add missing authors, or update summaries for individual items using 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 ensure consistent metadata across your content library.

​
Managing Visibility

Control which items appear in search results or are accessible via chat by updating visible_in_search and visible_in_chat flags.