Publish entities using their ID or identifier

Calling the Publish API creates a publishing operation for entities retrieved by the selected identifiers. If you provide IDs instead, they will be converted to their corresponding identifiers.

RequestResponse

POST https://<CONTENT_HUB_INSTANCE>/api/publish/entities

Example request

RequestResponse

POST https://<CONTENT_HUB_INSTANCE>/api/publish/entities
{
    "identifiers": [
       "Content.FruitfulCocktails",
       "Content.HealthIsHappiness"
   ],
   "skipNotification": true
   "tenant": "CaaS"
}

You can also use:

RequestResponse

POST https://<CONTENT_HUB_INSTANCE>/api/publish/entities
{
     "ids": [
          30033,
          30034
     ],
   "skipNotification": true
   "tenant": "CaaS"
}

Body parameters

Name	Type	Description
`identifiers`	String	Names or labels used to uniquely identify entities. You must provide either `identifiers` or `ids`, but not both.
`ids`	String	Numerical values used to uniquely identify entities. You must provide either `ids` or `identifiers`, but not both.
`skipNotification`	Boolean	If this is true, the request immediately updates the publishing status of entities, without refreshing the page. The recommended value is true, but if not specified, this value defaults to false.
`tenant`	String	Specifies a tenant to publish data to. If nothing is specified, this parameter defaults to CaaS. There are two possible values: `CaaS` or `PublicCollections`. This parameter is mandatory.

Choose either id or identifier for your API call, but don't use them simultaneously. If you have numerous identifiers to publish, it's best to split them into batches. We recommend sending batches of no more than 1000 identifiers per request.

Do you have some feedback for us?

If you have suggestions for improving this article,