microCMS
ドキュメント
  • 料金プラン
  • ブログ
  • よくある質問
  • お問い合わせ
  • ログイン
  • 無料ではじめる
ナビゲーション
チュートリアル
Next.js
  • Next.jsとの連携
  • Getting Started(App Router)
  • チュートリアル(App Router)
  • Getting Started(Pages Router)
  • チュートリアル(Pages Router)
Astro
  • Astroとの連携
  • Getting Started
  • チュートリアル
Nuxt
  • Nuxtとの連携
  • Getting Started
  • チュートリアル
Gatsby
  • Gatsbyとの連携
  • Getting Started
  • チュートリアル
JavaScript
  • JavaScriptとの連携
  • Getting Started(ブラウザ)
  • Getting Started(サーバー)
PHP
  • PHPとの連携
  • Getting Started
Ruby
  • Rubyとの連携
  • Getting Started
Go
  • Goとの連携
  • Getting Started
操作マニュアル
  • はじめに
アカウントとログイン
  • アカウント登録
  • ログイン
  • メールアドレス認証をする
サービス
  • サービスの作成
  • サービス設定
  • テンプレート
  • サービスの削除
お支払い
  • 料金プランの変更
  • 決済方法の登録と変更
API
  • APIの作成・管理
  • API設定
  • APIスキーマのエクスポート/インポート
フィールド
  • テキストフィールド
  • テキストエリア
  • 画像
  • 複数画像
  • 日時
  • 真偽値
  • セレクトフィールド
  • コンテンツ参照
  • 複数コンテンツ参照
  • 数字
  • ファイル
  • カスタム
  • 繰り返し
  • 拡張フィールド
コンテンツ
  • コンテンツの作成
  • コンテンツの編集
  • コンテンツ管理
  • ビュー
  • コンテンツのステータス
  • カスタムステータス
  • コンテンツIDの設定
  • コンテンツに自動付与される値
  • コンテンツのCSVエクスポート
  • コンテンツのCSVインポート
  • APIプレビュー
  • APIプレビューを活用したクエリパラメータの利用例
  • レンダリング方式ごとの組み込み方法
  • 画面プレビュー
  • コンテンツのWebhookを設定
リッチエディタ
  • リッチエディタの操作方法
  • リッチエディタのWRITE API
  • 旧リッチエディタの操作方法
レビュー機能
  • レビュー
  • AIレビュー
メディア
  • メディア管理
  • メディアのフィルター・表示順の変更
  • メディアのタグ設定
  • メディアのWebhookを設定
  • メディアのカスタムドメイン設定
権限管理
  • メンバーの管理
  • ロール(管理画面の権限管理)
複数環境
  • 複数環境(開発環境)
  • 環境間のAPI設定のマージ
外部連携
  • Amazon S3連携
データログ
  • 監査ログ
  • データ転送量
セキュリティ
  • コンテンツの更新履歴
  • 管理画面のIP制限
  • APIのIP制限
認証設定
  • 2要素認証の設定
  • 2要素認証の必須化
  • シングルサインオン
仕様・制限事項
  • 推奨環境
  • 制限事項/注意事項
コンテンツAPI
  • コンテンツAPIとは
基本操作
  • 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キー
  • APIキー(APIの認証と権限管理)
  • 旧API(X-API-KEYなど)からの移行
レスポンスとエラー処理
  • GET APIのフィールドごとのレスポンス形式
  • GET APIにおけるクエリパラメータの指定
  • コンテンツAPIのエラーレスポンス
マネジメントAPI(ベータ)
  • マネジメントAPIとは
コンテンツ操作
  • 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
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
メディア操作
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
メンバー操作
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API操作
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
  • POST /api/v1/apis
サービス操作
  • GET /api/v1/service
レスポンスとエラー処理
  • マネジメントAPIのエラーレスポンス
画像API
  • 画像APIとは
主なパラメータ
  • 画像サイズ
  • 品質
  • 解像度・画面サイズ
  • フォーマット
  • テキスト
  • 枠線
  • パディング
  • 形状
  • ダウンロード
  • ウォーターマーク
MCPサーバー
  • microCMS MCP
  • microCMS Document MCP Server
  • トップ
  • マネジメントAPI(ベータ)

マネジメントAPIのエラーレスポンス

最終更新日: 2026/06/08

マネジメントAPIへのリクエスト時に発生するエラーについて種別ごとにまとめます。

Caution
  • 下記に示す情報は、エラー時の全てのステータスコードを網羅することを保証していません。予期せぬ不具合や考慮の漏れにより、その他のエラーも発生する可能性がございます。あらかじめご了承ください。

エラー発生時のレスポンスボディ

マネジメントAPIのエラーレスポンスには、レスポンスボディに以下のようなメッセージが含まれる場合があります。

{
    message: "some message"
}


Caution
  • エラーメッセージは、予告なく変更される可能性がございます。エラーメッセージを元にしたハンドリングは行わないよう、ご注意ください。

エラーレスポンスの一覧

共通のエラーレスポンス

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

IP address rejected.

許可されていないIPアドレスからのリクエストです。APIのIP制限の設定を確認し、許可されているIPアドレスからリクエストしてください。

403 Forbidden

Forbidden

マネジメントAPIによる操作が許可されていません。APIキーが正しく設定されているか、APIキー設定で権限が付与されているかを確認してください。

404 Not Found

Not Found

リクエストのURLが誤っています。URLの誤字などがないか確認してください。

429 Too Many Requests

Too Many Requests

APIの呼び出し回数に関する制限を超過しています。

500 Internal Server Error

Internal Server Error

サーバー側で予期せぬエラーが生じています。

コンテンツ操作のエラーレスポンス

GETメソッド

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

Limit: must be no less than 0.

limitパラメータに0より小さい値が指定されています。0以上100以下の数値を指定してください。

400 Bad Request

limit must be less than or equal to 100

limitパラメータに100より大きい値が指定されています。0以上100以下の数値を指定してください。

400 Bad Request

Invalid integer in query (limit=xxx)

limitパラメータに不正な値が指定されています。0以上100以下の数値を指定してください。

400 Bad Request

Offset: must be no less than 0

offsetパラメータに0より小さい値が指定されています。0以上の数値を指定してください。

400 Bad Request

Invalid integer in query (offset=xxx)

offsetパラメータに不正な値が指定されています。0以上の数値を指定してください。

404 Not Found

Content not found

取得対象のコンテンツが存在しません。指定したコンテンツIDが正しいか確認してください。

PUTメソッド

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

invalid request body

ボディに不正な値が指定されています。ボディの内容を確認してください。

400 Bad Request

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

公開予約に過去日時が指定されています。現在時刻より未来の値を指定してください。

400 Bad Request

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

公開終了予約に過去日時が指定されています。現在時刻より未来の値を指定してください。

400 Bad Request

Cannot set publish or close schedule while under review

レビュー申請中のコンテンツに予約を設定しようとしています。レビューを完了/取り下げてから予約設定をしてください。

400 Bad Request

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

公開中コンテンツに公開開始予約だけを指定しています。公開終了予約を先に設定するか、ボディから公開開始予約の指定を外してください。

400 Bad Request

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

コンテンツが公開中の場合、公開開始予約は公開終了予約より後に設定する必要があります。公開終了予約を先、公開開始予約を後の日時に指定してください。

400 Bad Request

Cannot be reserved to stop publication while drafting

下書きコンテンツに公開終了予約だけ指定しています。公開開始予約も設定するか、ボディから公開終了予約を外してください。

400 Bad Request

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

下書きコンテンツの公開終了予約は公開開始予約より後に設定する必要があります。公開開始予約を先、公開終了予約を後の日時に指定してください。

400 Bad Request

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

公開終了コンテンツに公開終了予約だけを指定しています。公開開始予約も設定するか、ボディから公開終了予約を外してください。

400 Bad Request

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

公開終了コンテンツに指定する開始/終了予約の順序が不正です。公開開始予約を先、公開終了予約を後の日時に設定してください。

PATCHメソッド

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

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

ボディに不正な値が指定されています。ボディの内容を確認してください。

400 Bad Request

Status: the length must be exactly 1.

ボディに不正な値が指定されています。ボディの内容を確認してください。

400 Bad Request

invalid user id

ボディに不正なユーザーIDが指定されています。存在するユーザーIDを指定してください。

400 Bad Request

Request body is not JSON object.

ボディに指定したJSON形式が不適切です。ボディの内容を確認してください。

405 Method Not Allowed

Method Not Allowed

許可されていないメソッドのリクエストです。URLが誤っていないか確認してください。

メディア操作のエラーレスポンス

GETメソッド

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

Limit: must be no less than 0.

limitパラメータに0より小さい値が指定されています。0以上100以下の数値を指定してください。

400 Bad Request

limit must be less than or equal to 100

limitパラメータに100より大きい値が指定されています。0以上100以下の数値を指定してください。

400 Bad Request

Invalid integer in query (limit=xxx)

limitパラメータに不正な値が指定されています。0以上100以下の数値を指定してください。

400 Bad Request

Invalid boolean in query (imageOnly=xxx)

imageOnlyパラメータに不正な値が指定されています。trueもしくはfalseを指定してください。

400 Bad Request

Offset: must be no less than 0

offsetパラメータに不正な値が指定されています。0以上の数値を指定してください。

400 Bad Request

Invalid integer in query (offset=xxx)

offsetパラメータに不正な値が指定されています。0以上の数値を指定してください。

400 Bad Request

BadRequest

tokenパラメータの値が不正、もしくはtokenが無効です。

404 Not Found

Content not found

fileNameパラメータに指定した文字列をファイル名にもつメディアが存在しません。

POSTメソッド

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

invalid request

リクエストの形式が不正です。リクエストボディの内容などを確認してください。

400 Bad Request

request body too large

アップロードするメディアのファイルサイズが5MBを超えています。サイズを抑えるか、管理画面からアップロードしてください。

405 Method Not Allowed

Method Not Allowed

許可されていないメソッドのリクエストです。URLが誤っていないか確認してください。

DELETEメソッド

ステータスコード

エラーメッセージ

原因と対策

400 Bad Request

invalid url

指定されたURLが不正です。URLが誤っていないか確認してください。

400 Bad Request

this medium is referenced by another content

コンテンツから参照されているため削除できません。参照元のコンテンツから削除対象のメディアの参照を外してください。

404 Not Found

medium not found

削除対象のメディアが存在しません。正しいメディアURLが指定されているかを確認してください。

405 Method Not Allowed

Method Not Allowed

許可されていないメソッドのリクエストです。URLが誤っていないか確認してください。

メンバー操作のエラーレスポンス

GETメソッド

ステータスコード

エラーメッセージ

原因と対策

404 Not Found

Member not found

取得しようとしたメンバーが存在していない、もしくは招待中です。サービス参加済みのメンバーを指定してください。

目次

  • エラー発生時のレスポンスボディ
  • エラーレスポンスの一覧
  • 共通のエラーレスポンス
  • コンテンツ操作のエラーレスポンス
  • メディア操作のエラーレスポンス
  • メンバー操作のエラーレスポンス
  • 運営会社
  • 特定商取引法に基づく表記
  • 利用規約
  • プライバシーポリシー

Copyright © microcms.io All rights reserved.