---
title: "Optimize Single Image By Test ID"
method: POST
path: "/v1/inspect/images/{id}/optimize/{image_id}"
tags: ["Image Validation"]
---

# Optimize Single Image By Test ID

`POST /v1/inspect/images/{id}/optimize/{image_id}`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/inspect/images/{id}/optimize/{image_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/inspect/images/:id/optimize/:image_id/post.ts> (a function with typed inputs; its response is checked against the schema)

Optimizes a single image by test id

## Path parameters

- `id` string, required
- `image_id` string, required

## Response `200`

A 200 response

- GithubComMailgunInspectInternalImagevalidationOptimizeImageByTestJSONAPIResponse
  - `meta` object, nullable
  - `paging` GithubComMailgunScaffoldHttpapiPagingPagingResponse
    - `previous` string, required: Previous page URL
    - `first` string, required: First page URL
    - `next` string, required: Next page URL
    - `last` string, required: Last page URL
  - `items` GithubComMailgunInspectInternalImagevalidationImageOptimization
    - `id` string, required
    - `error_message` string
    - `optimized_images` GithubComMailgunInspectInternalImagevalidationOptimizedImage[]
      - `id` string, required
      - `original_image_id` string, required
      - `image_url` string, required
      - `optimized_url` string
      - `optimized_file_size` string
      - `optimized_format` string
      - `optimized_mime_type` string
      - `load_time_ms` integer, nullable
      - `status` 'Complete' | 'Error' | 'Processing', required: Status of the optimized image processing
      - `error_message` string

## Other responses

- `401`: A 401 response
- `404`: A 404 response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)
