Publish Content

Publishes an existing content entry. After this call the content becomes visible to read-token consumers (the default behavior of GET endpoints). Until then, the content is only reachable in preview mode (with the PREVIEW_ token prefix).

Caution

This endpoint requires a Write Token in the Authorization header. Calling it with a regular (read) token returns 403 Forbidden.

Tip

If you’re using JavaScript or TypeScript, the Content Island API client wraps this endpoint as client.publishContent(...).

Endpoint

shell

curl -X POST https://api.contentisland.net/api/1.0/content/:id/publish \
--header 'Authorization: Bearer YOUR_WRITE_TOKEN'

Path Parameters

The :id segment in the URL is required and identifies which content entry to publish.

Name	Type	Required	Description
id	string	yes	The ID of the content entry to publish. You can find it in your project’s Content tab, either in the list or in the content details.

This endpoint does not accept a request body.

Example

Replace :id with the real content ID:

shell

curl -X POST https://api.contentisland.net/api/1.0/content/660f5b8a3a1c2d4e7f8b9012/publish \
--header 'Authorization: Bearer YOUR_WRITE_TOKEN'

Response

On success the endpoint returns 204 No Content with an empty body.

Status Codes

Code	Description
204	The content was published successfully.
401	Unauthorized. The token is missing, malformed or expired.
403	Forbidden. The token does not have write permissions — use a Write Token.
404	No content with the supplied CONTENT_ID was found in the project.
500	Internal server error. An error occurred while processing the request.