---
title: "Create an Image Validation Test by Image Upload"
method: POST
path: "/v1/inspect/images/upload"
tags: ["Image Validation"]
---

# Create an Image Validation Test by Image Upload

`POST /v1/inspect/images/upload`

## Request

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

Create an image validation test by image upload

## Request body

- GithubComMailgunInspectInternalImagevalidationImageValidationUploadRequest
  - `image` string, binary

## Response `200`

A 200 response

- GithubComMailgunInspectInternalImagevalidationGetImageUploadValidationResults
  - `meta` object, nullable
  - `items` GithubComMailgunInspectInternalImagevalidationImageValidation
    - `id` string, required
    - `total_load_time_ms` integer, nullable
    - `images` GithubComMailgunInspectInternalImagevalidationImageValidationResult[]
      - `id` string, required
      - `url` string
      - `status` string, required
      - `line` integer
      - `column` integer
      - `selector` string
      - `absolute_index` integer
      - `passes` GithubComMailgunInspectInternalImagevalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
      - `failures` GithubComMailgunInspectInternalImagevalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
      - `informational` GithubComMailgunInspectInternalImagevalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
    - `image_optimization` 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
    - `gif_processing_job` GithubComMailgunInspectInternalImagevalidationGifProcessingJob
      - `id` string, required
      - `gif_frames` GithubComMailgunInspectInternalImagevalidationGifFrameDetails[]
        - `id` string, required
        - `original_image_id` string, required
        - `frame_details` GithubComMailgunInspectInternalImagevalidationFrameDetails[], required
          - `frame_id` integer, required
          - `frame_url` string, required
      - `reordered_gif` GithubComMailgunInspectInternalImagevalidationReorderedGiF[]
        - `id` string, required
        - `original_image_id` string, required
        - `frame_id` integer, required
        - `url` string, required
      - `created_at` string, date-time, required
      - `completed_at` string, date-time

## Other responses

- `400`: A 400 response
- `401`: A 401 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)