microCMS
Documentation
  • Pricing
  • Blog
  • FAQ
  • Contact
  • Sign In
  • Get started for free
Navigation
Tutorial
Next.js
  • Integration with Next.js
  • Getting Started with App Router
  • Tutorial (App Router)
  • Getting Started with Pages Router
  • Tutorial (Pages Router)
Astro
  • Getting Started
  • Integration with Astro
  • Tutorial
Nuxt
  • Integration with Nuxt
  • Getting Started
  • Tutorial
Gatsby
  • Integration with Gatsby
  • Getting Started
  • Tutorial
JavaScript
  • Integration with JavaScript
  • Getting Started (Browser)
  • Getting Started (Server)
PHP
  • Integration with PHP
  • Getting Started
Ruby
  • Integration with Ruby
  • Getting Started
Go
  • Integration with Go
  • Getting Started with microCMS
Manual
  • Introduction
Account & Login
  • Account Registration
  • Login
  • Email Address Authentication
Services
  • Creating a Service
  • Service Configuration
  • Template
  • Service Deletion
Payment
  • Change of Pricing Plan
  • Registering and Changing Payment Methods
API
  • Creating and Managing APIs
  • API Settings
  • Export/Import of API Schema
Fields
  • Text Field
  • Text Area
  • Image
  • Multiple Images
  • Date
  • Boolean
  • Selectable Field
  • Content Reference
  • Multiple Content References
  • Number
  • File
  • Extended Field
  • Repetition
  • Custom
Contents
  • CSV Export of Content
  • Content Creation
  • Content Editing
  • Content Management
  • View
  • Content Status
  • Custom Status
  • Setting the Content ID
  • Automatically Assigned Values for Content
  • CSV Import of Content
  • API Preview
  • Examples of Using Query Parameters with API Preview
  • Integration Methods by Rendering Type
  • Screen Preview
  • Setting Up Webhooks for Content
Rich Editor
  • How to Use the Rich Editor
  • Rich Editor WRITE API
  • How to Use the Old Rich Editor
Reviews
  • Review
  • AI Review
Media
  • Media Management
  • Changing Media Filters and Display Order
  • Media Tag Configuration
  • Setting Up Media Webhooks
  • Custom Domain Settings for Media
Permission Management
  • Member Management
  • Roles (Permission Management in the Admin Panel)
Environments
  • Multiple Environments (Development Environment)
  • Merging API Settings Between Environments
Connection
  • Amazon S3 Integration
Logs
  • Audit Log
  • Data Transfer Volume
Security
  • Content Update History
  • IP Restrictions for Management Dashboard
  • IP Restrictions for APIs
Authentication
  • Setting Up Two-Factor Authentication
  • Mandatory Two-Factor Authentication
  • Single Sign-On
Specifications & Limitations
  • Recommended Environment
  • Limitations / Precautions
Content API
  • What is the Content API?
Basic Operations
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
API Keys
  • API Key (API Authentication and Authorization Management)
  • Migration from the Old API (X-API-KEY, etc.)
Responses & Error Handling
  • Response format for each field in the GET API
  • Specifying Query Parameters in the GET API
  • Error Responses of the Content API
Management API (Beta)
  • What is the Management API?
Content Operations
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
Media Operations
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
Member Operations
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API Operations
  • POST /api/v1/apis
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
Service Operations
  • GET /api/v1/service
Responses & Error Handling
  • Management API Error Responses
Image API
  • What is the Image API?
Parameters
  • Image Size
  • Quality
  • Resolution and Screen Size
  • Format
  • Text
  • Border
  • Padding
  • Shape
  • Download
  • Watermark
MCP Server
  • microCMS MCP
  • microCMS Document MCP Server
  • Top
  • Manual

Automatically Assigned Values for Content

Last updated: 2026/09/02

When you save content, several values are automatically assigned.
These automatically assigned values can be checked and modified in the Administration console. They can also be retrieved via the Content API.

id: Content ID

This is the ID of the created content. It is composed of a string according to the Content ID settings.
The Content ID can be edited in the Administration console. The allowable character count is from 1 to 50 characters.
Additionally, since it is a unique value for each API, it can also be used as a slug (a part of the URL).

Information

No ID is assigned to the object format API.


createdAt: Content Creation Date

This is the date and time when the content was created.
The creation date will not be updated after the content is created.


updatedAt: Content Update Date

The date and time when the content was updated.

When the Value is Updated

The value is updated when any of the following actions are performed.

Actions in the Administration Console

  • When the [Publish] button is clicked
  • When the [Re-Publish] button is clicked
  • When the [Save as Draft] button is clicked
  • When the [Add Draft] button is clicked
  • When the [Discard Draft] button is clicked
  • When the [Revert to Draft] button is clicked
  • When the [End Publication] button is clicked
  • When the publication status changes due to Scheduled Start/End of Publication
  • When the Content ID is changed

Actions via API

Content API

  • When content is registered using the POST API
  • When content is registered using the PUT API
  • When content is updated using the PATCH API

Management API

  • When the publication status of the content actually changes due to Status Change (the applicable changes are: "Published" → "Draft", "Draft" → "Published", "Published and Draft" → "Published (Draft Discarded)")


publishedAt: Content Publication Date

This is the date and time when the content was published.

Timing of Value Updates

The value is assigned or updated when any of the following actions are performed.

Actions in the Administration Console

  • When the [Publish] button is clicked (excluding content that is "Published and Draft")
  • When the [Re-Publish] button is clicked
  • When the publication date is edited to a specific date in the Administration Console

Actions via API

Content API

  • When content is registered using the POST API (excluding cases where the status=draft or status=closed parameters are applied)
  • When content is registered using the PUT API (excluding cases where the status=draft or status=closed parameters are applied)

Management API

  • When the status is changed (only from "Draft" to "Published")

Examples of Timing for Publication Date Updates

Here are some examples of when the publication date is updated.

Example 1: After Publishing, if Rewritten and then Re-Published

1. Draft → Published: Publication date is assigned
2. Published → Published and Draft (after rewriting and adding a draft): Publication date is not updated
3. Published and Draft → Published: Publication date is not updated

Example 2: After Publishing, if Returned to Draft and then Re-Published

1. Draft → Published: Publication date is assigned
2. Published → Draft (returned to draft): Publication date is not updated
3. Draft → Published: Publication date is updated


revisedAt: Content Revision Date

This is the date when the published content was updated.

Timing of Value Updates

The value is assigned or updated when any of the following actions are performed.

Actions in the Administration Console

  • When the [Publish] button is clicked
  • When the [Re-Publish] button is clicked
  • When content is published via Scheduled Publishing

Actions via API

Content API

  • When content is registered using the POST API (excluding cases where status=draft or status=closed parameters are applied)
  • When content is registered using the PUT API (excluding cases where status=draft or status=closed parameters are applied)
  • When content is updated using the PATCH API

Management API

  • When the status is changed (only from "Draft" to "Published")

Examples of Timing for Revision Date Updates

Here are examples of when the revision date is updated.

[Example 1] After Publishing, if a Rewrite is Done and then Re-Published

1. Draft → Published: Revision date is assigned
2. Published → Published and Draft (after rewriting and adding a draft): Revision date is not updated
3. Published and Draft → Published: Revision date is updated

Tips

Unlike the updatedAt timestamp, the revisedAt timestamp is not updated when a draft is saved.

Therefore, if you need to display the "update date" in article content, you can use the revisedAt timestamp.

Contents

  • id: Content ID
  • createdAt: Content Creation Date
  • updatedAt: Content Update Date
  • When the Value is Updated
  • publishedAt: Content Publication Date
  • Timing of Value Updates
  • Examples of Timing for Publication Date Updates
  • revisedAt: Content Revision Date
  • Timing of Value Updates
  • Examples of Timing for Revision Date Updates
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.