サービスのメディアを削除するAPIです。
画像とファイルの両方の削除に対応しています。

リクエストヘッダー

X-MICROCMS-API-KEY

リクエストの際に必要な認証キーです。
マネジメントAPIの権限で「メディアの削除」を有効にして、リクエストヘッダーに含めて送信してください。

クエリパラメータ

本APIにはパラメータを指定できます。

url

削除したいメディアのURLを指定します。

?url=https://images.microcms-assets.io/assets/xxxxx/yyyyy/hoge.jpg
?url=https://files.microcms-assets.io/assets/xxxxx/yyyyy/hoge.pdf

リクエストボディ

不要です。

レスポンス

ステータスコード

正常にコンテンツを削除できた場合は200レスポンスが返却されます。

レスポンスボディ

正常にコンテンツを削除できた場合は、以下のようなレスポンスが返却されます。

{"id":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

id

削除されたメディアの内部的なIDです。