トップ
マネジメント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`	取得しようとしたメンバーが存在していない、もしくは招待中です。サービス参加済みのメンバーを指定してください。

エラー発生時のレスポンスボディ
エラーレスポンスの一覧
共通のエラーレスポンス
コンテンツ操作のエラーレスポンス
メディア操作のエラーレスポンス
メンバー操作のエラーレスポンス