---
title: "Publish entities using their ID or identifier"
slug: "publish-entities-using-their-id-or-identifier"
abstract: "How to publish entities using the entity ID or identifier."
---
# 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.

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

```

## Example request

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

```

You can also use:

```http
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.