---
title: "Refresh a URL-sourced item image: re-fetch its source URL and, if the content changed, store a new variant set and remove the old. Returns the outcome (refreshed / unchanged / failed-with-reason). This is the only retry path for a previously failed ingest."
method: POST
path: "/v1/Items/{itemId}/images/{key}/refresh"
tags: ["Items"]
---

# Refresh a URL-sourced item image: re-fetch its source URL and, if the content changed, store a new variant set and remove the old. Returns the outcome (refreshed / unchanged / failed-with-reason). This is the only retry path for a previously failed ingest.

`POST /v1/Items/{itemId}/images/{key}/refresh`

## Path parameters

- `itemId` integer, required
- `key` string, required

## Query parameters

- `Account` unknown

## Response `200`

Success

- RefreshItemImageResponse
  - `imageKey` string, nullable
  - `outcome` 0 | 1 | 2
  - `reason` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-08-27** `61263b2302a0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/invendor/apis/io-commonapi/changes/v1/Items/:itemId/images/:key/refresh/post.md)

---

[API](https://skmtc.dev/invendor/apis/io-commonapi.md) · [All operations](https://skmtc.dev/invendor/apis/io-commonapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/invendor/io-commonapi/revisions/61263b2302a0/schema)