microCMS

Content Status

There are four statuses for the content as follows:

  1. Published
  2. Publication Ended
  3. Drafting
  4. Published and Drafting

The behavior of the API and the automatically assigned values for the content differ depending on each status.

Description of Statuses

Here is an explanation of each status.

1. Published

When the status is published, you can retrieve the content's details via the API.
The status code will be 200.

Automatically Assigned Values for the Content

2. End of Publication

If the status is "End of Publication," you cannot retrieve the content via the API.
The status code will be 404.
However, if the API key has been granted the permission for "Retrieve All End of Publication Content", you can retrieve the content.

3. Drafting

When the status is drafting, the content cannot be retrieved via the API.
The status code will be 404.
However, if you request with the draftKey or grant the API key the permission for Retrieve All Draft Content, you can retrieve the content.

Automatically Granted Values for Content

informationInformation
  • publishedAt and revisedAt are not included in the response.
  • For content that has been published once, publishedAt and revisedAt will be included (the values at the time of publication in the past).

4. Published and Draft

When the status is both published and in draft, you can only retrieve the content of published items via the API.
The status code will be 200.
However, if you request with the draftKey or if your API key has the Retrieve All Drafts permission, you can retrieve the content of draft items.

Automatically Granted Values for Content