---
title: "Reprocess Image"
method: PUT
path: "/v1/images/{image_id}"
tags: ["Image Emotion API"]
---

# Reprocess Image

`PUT /v1/images/{image_id}`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v1/images/{image_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Reprocesses an image that has either failed or completed.
You can trigger the reprocessing by setting reprocess to True.
This will reanalyze the image and provide updated insights.

## Path parameters

- `image_id` string, required: The unique image ID of the image.

## Request body `application/x-www-form-urlencoded`

- BodyReprocessImageV1ImagesImageIdPut
  - `callback_url` string, nullable: The callback url to notify image reprocessing is completed. Give a valid URL. Must be an https URL on a publicly reachable host.
  - `reprocess` boolean: Set to 'True' to reprocess an already completed image; defaults to 'False'.

## Response `200`

Successful Response

- ImageReprocessResponse: Response model returned after reprocessing an image emotion analysis.
  - `id` string, required
  - `status` string, required
  - `message` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-20** `74ceee4a5c98`: 1 breaking, 1 info
  - request property `reprocess` list-of-types was narrowed by removing types `string` from media type `application/x-www-form-urlencoded`
  - request property `callback_url` list-of-types was widened by adding types `null` to media type `application/x-www-form-urlencoded`

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v1/images/:image_id/put.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)