Batch Create Item Publishings

Publishes multiple content items at once. This endpoint requires that all content items belong to the same content model.

Request body is an array of objects. Each object represents a content item. Available object property values:

Body: raw JSON

namedescription
ZUID[string] Required. The ZUID of the content item to be published.
version[int] Required. The specific item version you want to be published.
publishAt[date] Required. The date that the item will be published. If "now" is provided, the item will be published immediately.
unpublishAt[date] Required. The date the item will be unpublished. If "never" is provided, the item will be published forever, starting from the publishAt date.

CDN cache object purging

Publishing or unpublishing a content item triggers a CDN cache purge. Every entity is tagged using its ZUID, the instance ZUID, and for most cases, also tagged by the collection's ZUID it belongs to, for example is a content model which is a collection of content items. By default, the API uses the instance ZUID, which will trigger an instance scope purging. To change the scope, create a setting using the Create Setting endpoint with the following payload:

{
	"category": "general",
	"keyFriendly": "Purge CDN Scope",
	"key": "purge_cdn_scope",
	"value": "collection",
	"admin": true,
	"dataType": "dropdown",
	"options": "instance:Instance scope;collection:Collection scope;entity:Entity scope",
	"tips": "Changes the scope of purging a cache object when an entity is published or unpublished."
}

Instance scope — purges all cache objects across the entire instance that are tagged with the instance ZUID.

Collection scope — purges cache objects tagged with the ZUID of the collection. Every entity of a collection is tagged with the collection ZUID. For example every content item (e.g. 7-000-0000) is tagged with its model ZUID (e.g. 6-000-0000). Meaning when an item is published, and a cache purge is triggered, collection scope will purge all content items of that model. As they are all tagged with the content model ZUID.

Entity scope — purges only the cache object tagged with the published or unpublished item's ZUID.

NOTE: Entity scope is not supported on the batch endpoint and falls back to Instance scope purging if it is selected.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ZUID of the content model where all the items to publish is located

Body Params

Item publishing objects to create

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json