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

Creating and Managing APIs

Last updated: 2026/04/24

You can create multiple APIs within the service.
This document explains how to create and manage APIs.

Information

The maximum number of APIs you can create varies by plan.

Steps to Create an API

This section explains the steps to create a new API.

First, in the left menu of the management screen, click the three-dot menu next to the "Content (API)" item and then click [Create New API].



This will display the API creation screen.
※If no API exists, the API creation screen will automatically appear after accessing the service.



When creating an API, you can choose from the following two methods:

  1. Decide on your own
  2. Select from a template (Blog / Announcement / Banner)

Next, we will explain each method.

Deciding on Your Own

Click on [Decide on Your Own] in the API creation screen.
Then, proceed with the following steps.

1. Enter Basic Information for the API

Enter the basic information for the API.



Here, you will enter two items: "API Name" and "Endpoint".

API Name

The API name is used to identify each API in the management screen.

Endpoint

The endpoint is the value that corresponds to the last part of the API endpoint path.
The input conditions for the endpoint are as follows:

  • 3 to 32 characters
  • Half-width alphanumeric characters
  • Lowercase only
  • Only hyphens and underscores are allowed as symbols
  • Cannot duplicate existing API endpoints

2. Select the API Type

Select the API type.



Here, you can choose between "List Format" or "Object Format" for the API response format.

List Format

This handles multiple pieces of content.
It is suitable for managing multiple contents such as announcements and blogs.
The API can retrieve array data as shown below.

[ { message: 'Good morning' }, { message: 'Hello' }, { message: 'Good evening' } ]

Object Format

This handles a single piece of content.
It is suitable for managing single contents such as configuration information or individual page information.
The API can retrieve object data as shown below.

{ title: 'Profile', profile: 'I am studying Headless CMS' }

3. Define the API Schema

Define the API schema.



In defining the API schema, you will enter the following three items.

Field ID

A unique ID for each field. This will be the property name in the API response.

Display Name

This will be displayed when entering content.

Type

This specifies the input form format when entering content.
You can choose from various types such as text fields, rich editors, and image fields.

Information

For details on configuring the API schema, please refer to the "API Settings" page.

4. Click on [Create]

Finally, clicking on [Create] will complete the API creation.


Creating from a Template

When creating from a template, you can choose from the following three templates. Different APIs will be created for each template.

  • Blog: A template for blogs. It creates APIs for articles and categories.
  • Announcement: A template for updates and news. It creates APIs for announcements and tags.
  • Banner: A template for banners, such as for campaigns. It creates APIs for banner elements.


Clicking on the desired template will start the creation process.



After a while, the API will be created automatically.
Additionally, several sample contents have been uploaded for each API.

Grouping Created APIs


You can group the created APIs into API groups. This is useful when managing multiple sites with a single service.

Information

The API group is a feature available with the Team, Business, and Enterprise plans.
For details on the features available with each plan, please refer to the pricing page.

Create an API Group


In the left menu of the management screen, click the three-dot menu next to the "Content (API)" item and then click [Create New API Group].

Information
  • You can create up to 100 API groups.
  • API groups support only one level.

Enter the group name for the group you want to create and click [Create].

Caution

An API group with the same name cannot be created.

By dragging and dropping the API, you can group APIs into an API group.


Renaming an API Group


Hover over the API group and click the three-dot menu, then click [Edit Group Name].



Edit the group name and click [Change] to apply the changes to the group name.

Deleting an API Group


Hover over the API group and click the three-dot menu, then click [Delete Group].



In the confirmation dialog, click [OK] to delete the API group.

Caution

You cannot delete an API group if it contains APIs.

Please move all APIs to another API group before deleting it.

Contents

  • Steps to Create an API
  • Deciding on Your Own
  • Creating from a Template
  • Grouping Created APIs
  • Create an API Group
  • Renaming an API Group
  • Deleting an API Group
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.