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
  • Management API (Beta)

Management API Error Responses

Last updated: 2026/06/08

This document summarizes the errors that occur when making requests to the Management API, categorized by type.

Caution
  • The information provided below does not guarantee coverage of all status codes during errors. Unexpected issues or omissions may lead to other errors occurring. Please be aware of this in advance.

Response Body on Error

The error response from the Management API may include a message in the response body as follows:

{
    message: "some message"
}


Caution
  • Error messages may change without notice. Please be careful not to handle based on the error messages.

List of Error Responses

Common Error Responses

Status Code

Error Message

Cause and Solution

400 Bad Request

IP address rejected.

The request is coming from an unauthorized IP address. Please check the API IP restriction settings and make the request from an allowed IP address.

403 Forbidden

Forbidden

Operations via the Management API are not permitted. Please check if the API key is correctly set and if permissions are granted in the API key settings.

404 Not Found

Not Found

The requested URL is incorrect. Please check for any typos in the URL.

429 Too Many Requests

Too Many Requests

You have exceeded the API call limit.

500 Internal Server Error

Internal Server Error

An unexpected error has occurred on the server side.

Error Responses for Content Operations

GET Method

Status Code

Error Message

Cause and Solution

400 Bad Request

Limit: must be no less than 0.

The limit parameter has a value less than 0. Please specify a number between 0 and 100.

400 Bad Request

limit must be less than or equal to 100

The limit parameter has a value greater than 100. Please specify a number between 0 and 100.

400 Bad Request

Invalid integer in query (limit=xxx)

The limit parameter has an invalid value. Please specify a number between 0 and 100.

400 Bad Request

Offset: must be no less than 0

The offset parameter has a value less than 0. Please specify a non-negative number.

400 Bad Request

Invalid integer in query (offset=xxx)

The offset parameter has an invalid value. Please specify a non-negative number.

404 Not Found

Content not found

The requested content does not exist. Please check if the specified content ID is correct.

PUT Method

Status Code

Error Message

Cause and Solution

400 Bad Request

invalid request body

An invalid value is specified in the body. Please check the content of the body.

400 Bad Request

Past dates and times cannot be set as the reserved open date and time

A past date and time has been specified for the scheduled publication. Please specify a future value relative to the current time.

400 Bad Request

Past date and time cannot be set as the date and time to stop publishing reservations

A past date and time has been specified for the scheduled end of publication. Please specify a future value relative to the current time.

400 Bad Request

Cannot set publish or close schedule while under review

You are trying to set a reservation for content that is under review. Please complete or withdraw the review before setting the reservation.

400 Bad Request

Cannot be reserved for the public because it has already been published

You are specifying a reservation to start publication for content that is already published. Please set a reservation to end publication first, or remove the reservation to start publication from the body.

400 Bad Request

Reservations to start publishing must be set after reservations to stop publishing if the content is being published

If the content is currently published, the reservation to start publication must be set after the reservation to stop publication. Please specify the end reservation first and the start reservation later.

400 Bad Request

Cannot be reserved to stop publication while drafting

You are specifying only a reservation to end publication for draft content. Please also set a reservation to start publication, or remove the reservation to end publication from the body.

400 Bad Request

Reservations to stop publishing must be set after reservations to start publishing if content is in draft

The reservation to end publication for draft content must be set after the reservation to start publication. Please specify the start reservation first and the end reservation later.

400 Bad Request

Cannot be reserved to stop publication if the content is closed to the public

You are specifying only a reservation to end publication for content that is closed to the public. Please also set a reservation to start publication, or remove the reservation to end publication from the body.

400 Bad Request

Reservations to stop publishing must be set after reservations to start publishing if the content is closed to the public

The order of the start/end reservations specified for closed content is incorrect. Please set the start reservation first and the end reservation later.

PATCH Method

Status Code

Error Message

Cause and Solution

400 Bad Request

Status: (0: must be a valid value.).

An invalid value is specified in the body. Please check the content of the body.

400 Bad Request

Status: the length must be exactly 1.

An invalid value is specified in the body. Please check the content of the body.

400 Bad Request

invalid user id

An invalid user ID is specified in the body. Please specify an existing user ID.

400 Bad Request

Request body is not JSON object.

The JSON format specified in the body is incorrect. Please check the content of the body.

405 Method Not Allowed

Method Not Allowed

This is a request with a method that is not allowed. Please check if the URL is correct.

Media Operation Error Response

GET Method

Status Code

Error Message

Cause and Solution

400 Bad Request

Limit: must be no less than 0.

The limit parameter has a value less than 0. Please specify a number between 0 and 100.

400 Bad Request

limit must be less than or equal to 100

The limit parameter has a value greater than 100. Please specify a number between 0 and 100.

400 Bad Request

Invalid integer in query (limit=xxx)

The limit parameter has an invalid value. Please specify a number between 0 and 100.

400 Bad Request

Invalid boolean in query (imageOnly=xxx)

The imageOnly parameter has an invalid value. Please specify true or false.

400 Bad Request

Offset: must be no less than 0

The offset parameter has an invalid value. Please specify a number greater than or equal to 0.

400 Bad Request

Invalid integer in query (offset=xxx)

The offset parameter has an invalid value. Please specify a number greater than or equal to 0.

400 Bad Request

BadRequest

The value of the token parameter is invalid or the token is expired.

404 Not Found

Content not found

No media exists with the file name specified in the fileName parameter.

POST Method

Status Code

Error Message

Cause and Solution

400 Bad Request

invalid request

The format of the request is invalid. Please check the contents of the request body.

400 Bad Request

request body too large

The file size of the media being uploaded exceeds 5MB. Please reduce the size or upload it from the Administration console.

405 Method Not Allowed

Method Not Allowed

This is a request with an unsupported method. Please check if the URL is correct.

DELETE Method

Status Code

Error Message

Cause and Solution

400 Bad Request

invalid url

The specified URL is invalid. Please check if the URL is correct.

400 Bad Request

this medium is referenced by another content

It cannot be deleted because it is referenced by another content. Please remove the reference to the media from the source content.

404 Not Found

medium not found

The media to be deleted does not exist. Please check if the correct media URL is specified.

405 Method Not Allowed

Method Not Allowed

This is a request with an unsupported method. Please check if the URL is correct.

Member Operation Error Response

GET Method

Status Code

Error Message

Cause and Solution

404 Not Found

Member not found

The member you are trying to retrieve does not exist or is still pending invitation. Please specify a member who has already joined the service.

Contents

  • Response Body on Error
  • List of Error Responses
  • Common Error Responses
  • Error Responses for Content Operations
  • Media Operation Error Response
  • Member Operation Error Response
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.