{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Asynchronously run a bulk action over up to 1,000 Knowledge Hub content items.\n\nSix actions are supported:\n  * `publish` and `unpublish` — apply to `article_content` only.\n  * `delete` — permanently delete content (excludes synced sources and `external_content`).\n  * `set_availability` — toggle Fin AI Agent, Copilot, and Sales Agent availability flags.\n  * `set_audience` — manage segment membership on content.\n  * `update_tags` — apply and/or remove existing tags on content. Unlike the other\n    actions, `update_tags` addresses articles by the parent `article` id, not\n    `article_content`. Tags must already exist and not be archived; supply at least one of\n    `add_tag_ids` / `remove_tag_ids`.\n\nThe endpoint validates the request, enqueues background work, and returns 202 with a\nplaceholder envelope. Items whose `type` is not in the action's allowlist are silently\ndropped before processing. Articles imported from synced sources (Confluence, Notion,\nZendesk, Salesforce Knowledge, etc.) are silently skipped on `delete` — they can only be\nremoved by disconnecting the underlying import source.\n\nRequires the `write_content` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"body":{"$ref":"#/definitions/content_bulk_action_request","examples":[{"action":"publish","content_ids":[{"type":"article_content","id":"12345678"},{"type":"article_content","id":"12345679"}]}]}},"required":["body"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]},"content_bulk_action_request":{"title":"Content Bulk Action Request Payload","type":"object","required":["action","content_ids"],"properties":{"action":{"type":"string","description":"The bulk action to perform. Allowed `content_ids[].type` values vary per action:\n  * `publish`, `unpublish`: `article_content`\n  * `delete`: `article_content`, `content_snippet`, `file_source_content`, `internal_article`\n  * `set_availability`, `set_audience`: `article_content`, `content_snippet`, `external_content`, `file_source_content`, `internal_article`\n  * `update_tags`: `article` (the parent Article id, not `article_content`), `content_snippet`, `external_content`, `file_source_content`, `internal_article`\n","enum":["publish","unpublish","delete","set_availability","set_audience","update_tags"],"examples":["publish"]},"content_ids":{"type":"array","maxItems":1000,"description":"Up to 1,000 content items to apply the action to.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["article","article_content","content_snippet","external_content","file_source_content","internal_article"],"examples":["article_content"]},"id":{"type":"string","examples":["12345678"]}}}},"availability":{"type":"object","description":"Required when `action` is `set_availability`. Each field is optional — only the\nproperties present in the request are toggled.\n","properties":{"ai_agent":{"type":"boolean","description":"Toggle Fin AI Agent availability."},"copilot":{"type":"boolean","description":"Toggle Copilot availability."},"sales_agent":{"type":"boolean","description":"Toggle Sales Agent availability."}}},"audience":{"type":"object","description":"Required when `action` is `set_audience`. Manages segment membership.","properties":{"add_segment_ids":{"type":"array","description":"Segment IDs to assign to the selected content.","items":{"type":"integer"},"examples":[[100]]},"remove_segment_ids":{"type":"array","description":"Segment IDs to remove from the selected content.","items":{"type":"integer"},"examples":[[200]]},"remove_all":{"type":"boolean","description":"When `true`, removes all segments from the selected content.","examples":[false]}}},"tags":{"type":"object","description":"Required when `action` is `update_tags`. Applies and/or removes existing tags.\nSupply at least one of `add_tag_ids` / `remove_tag_ids`. At most 100 distinct tag IDs\nmay be supplied across `add_tag_ids` and `remove_tag_ids` combined. Tag IDs must\nreference existing, non-archived tags; exceeding the limit or referencing unknown or\narchived IDs is rejected with `parameter_invalid` (HTTP 422).\n","properties":{"add_tag_ids":{"type":"array","description":"Tag IDs to apply to the selected content.","items":{"type":"integer"},"examples":[[100]]},"remove_tag_ids":{"type":"array","description":"Tag IDs to remove from the selected content.","items":{"type":"integer"},"examples":[[200]]}}}}}}},"name":"Run a bulk action on Knowledge Hub content","id":"intercom.bulkcontentactions","example":{"body":{"action":"publish","content_ids":[]}},"maxRequests":1,"summary":false}}