> ## 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.

# Edit Content

> Update metadata for your content without re-uploading files.

<Tabs>
  <Tab title="Via API">
    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:

    * A **Gloo AI Studio** account
    * Your **Client ID** and **Client Secret** from the [API Credentials page](/studio/manage-api-credentials)
    * **Authentication setup** - Complete the [Authentication Tutorial](/tutorials/authentication) first

    <Info>
      The caller must belong to the organization that owns the specified publisher.
    </Info>

    ## Update a Single Item

    Use the single-item endpoint when you need to edit a specific item by its [`item_id`](/getting-started/glossary#item_id) or your [`producer_id`](/getting-started/glossary#producer_id).

    **When to use:**

    * Correcting a typo in a title
    * Adding missing author or tags
    * Updating a summary or publication date

    ```bash Shell theme={null}
    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:**

    ```json theme={null}
    {
      "success": true,
      "message": "Item 37328826-e527-4039-8996-bd27741b6f8e has been updated."
    }
    ```

    <Tip>
      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.
    </Tip>

    **Full API details:** [Single Item Patch API Reference](/api-reference/content-controls/single-item-patch)

    ***

    ## 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

    ```bash Shell theme={null}
    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:**

    ```json theme={null}
    {
      "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](/api-reference/content-controls/multi-item-patch)

    <Info>
      The `publisher_id` in API requests is the unique identifier for your Publisher. See [publisher\_id](/getting-started/glossary#publisher_id) in the glossary.
    </Info>

    ***

    ## Editable Fields

    | Field Type   | Fields                                                                                                                           |
    | ------------ | -------------------------------------------------------------------------------------------------------------------------------- |
    | **Strings**  | `item_title`, `item_subtitle`, `item_summary`, `item_image`, `item_url`, `item_number`, `item_extra`, `isbn`, `publication_date` |
    | **Lists**    | `author`, `item_tags`                                                                                                            |
    | **Booleans** | `evergreen`, `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.
  </Tab>

  <Tab title="Via Gloo AI Studio">
    You can edit metadata for individual items directly from the Content Library in Studio.

    1. Click **Data Engine** in the Studio sidebar, then click **Content Library**.
    2. Find the item you want to edit and click the **edit icon** in the Actions column.
    3. Update any of the following fields:
       * **Title** — The main title as it appears in search results
       * **Subtitle** — Additional title information
       * **Image URL** — Link to a cover image or thumbnail
       * **Source URL** — Link to the original content source
       * **Summary** — Brief description for search results
       * **Tags** — Comma-separated keywords to improve searchability
    4. Click **Save Changes**.

    <Note>
      The Studio UI supports editing individual items. For bulk updates across many items, use the [Via API tab](#update-multiple-items).
    </Note>
  </Tab>
</Tabs>