# Content

Search and bulk operations over Knowledge Hub content (Preview)

## Run a bulk action on Knowledge Hub content (Preview)

 - [POST /content/bulk_actions](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/content/bulkcontentactions.md): Asynchronously run a bulk action over up to 1,000 Knowledge Hub content items.

Six actions are supported:
  * publish and unpublish — apply to article_content only.
  * delete — permanently delete content (excludes synced sources and external_content).
  * set_availability — toggle Fin AI Agent, Copilot, and Sales Agent availability flags.
  * set_audience — manage segment membership on content.
  * update_tags — apply and/or remove existing tags on content. Unlike the other
    actions, update_tags addresses articles by the parent article id, not
    article_content. Tags must already exist and not be archived; supply at least one of
    add_tag_ids / remove_tag_ids.

The endpoint validates the request and returns 202.

Important — 202 Accepted does not guarantee every item was processed. Two
classes of items are silently excluded:

  1. Unsupported content type for the action. Items whose type is not in the
     action's allowlist (see the action description) are not included in the bulk
     operation. No per-item error is returned.
  2. Synced content on delete. Articles imported from a synced source
     (Confluence, Notion, Zendesk, Salesforce Knowledge, etc.) are not deletable
     through this endpoint — they can only be removed by disconnecting the underlying
     import source.

For compliance-driven deletions (GDPR right-to-erasure, etc.), do not rely on the
202 Accepted response alone. Verify removal by fetching each item directly
(for example, GET /articles/{id} for article content) or disconnect the import
source for synced content. A future Preview release will expose a polling job
resource with per-item updated, unchanged, skipped, and failed buckets to
make these outcomes explicit.

Requires the write_content OAuth scope. Set Intercom-Version: preview.

## Search Knowledge Hub content (Preview)

 - [GET /content/search](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/content/searchcontent.md): Search across Knowledge Hub content of all supported types in a single call:
articles, content snippets, external content (webpages), file source content
(uploaded documents), and internal articles.

Articles are returned as a single item per article, with their per-locale
article_content variants nested under contents[]. Other content types are
returned as flat objects with type, id, and title.

Requires the read_content OAuth scope. Set Intercom-Version: preview.