メインコンテンツまでスキップ

DELETE /v1/items/{id}/images/{imageId}

scope​

write_items

リクエストパラメーター​

名前位置型必須説明
idパスstring必須対象のリソース ID
imageIdパスstring必須対象のリソース ID
Idempotency-Keyヘッダーstring必須冪等キー（必須）。UUID v4 を推奨します。同一キーの再送は最初の結果をそのまま再生し、応答に Idempotent-Replay: true が付きます。同一キーで異なるボディを送ると 422 になるため、リトライは必ず同一リクエストで行ってください

レスポンスの例​

{
  "item_id": "string",
  "images": [
    {
      "id": "string",
      "key": "string",
      "url": "string",
      "sort": 0
    }
  ]
}

解説​

追加画像を 1 枚削除します。削除後は残りの画像の表示順が 1 から詰め直されます。メイン画像は削除できません（差し替えのみ）。存在しない画像・他商品の画像は 404。Idempotency-Key 必須（同一キーの再送は最初の結果を再生します）。

エラーレスポンスの例​

{
  "error": {
    "code": "insufficient_scope",
    "message": "requires scope 'write_items'",
    "request_id": "req_01H..."
  }
}

返しうるエラー: 401 / 403 / 404 / 409 / 503