Skip to content
Home/
REST API Reference
/
/
Content Bulk Action Reque...

Content Bulk Action Request Payload

actionstringrequired

The bulk action to perform. Allowed content_ids[].type values vary per action:

  • publish, unpublish: article_content
  • delete: article_content, content_snippet, file_source_content, internal_article
  • set_availability, set_audience: article_content, content_snippet, external_content, file_source_content, internal_article
  • update_tags: article (the parent Article id, not article_content), content_snippet, external_content, file_source_content, internal_article
Enum:"publish""unpublish""delete""set_availability""set_audience""update_tags"
Example:"publish"
content_idsArray of objects, <= 1000 itemsrequired

Up to 1,000 content items to apply the action to.

availabilityobject

Required when action is set_availability. Each field is optional — only the properties present in the request are toggled.

audienceobject

Required when action is set_audience. Manages segment membership.

tagsobject

Required when action is update_tags. Applies and/or removes existing tags. Supply at least one of add_tag_ids / remove_tag_ids. At most 100 distinct tag IDs may be supplied across add_tag_ids and remove_tag_ids combined. Tag IDs must reference existing, non-archived tags; exceeding the limit or referencing unknown or archived IDs is rejected with parameter_invalid (HTTP 422).

{
  "action": "publish",
  "content_ids": [
    { … }
  ],
  "availability": {
    "ai_agent": true,
    "copilot": true,
    "sales_agent": true
  },
  "audience": {
    "add_segment_ids": [ … ],
    "remove_segment_ids": [ … ],
    "remove_all": false
  },
  "tags": {
    "add_tag_ids": [ … ],
    "remove_tag_ids": [ … ]
  }
}