---
title: "Changes to Create a batch of images"
method: POST
path: "/v1/image/batch"
---

# Changes to Create a batch of images

`POST /v1/image/batch`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 13 revisions.

- **2026-10-03** `9095bcb65ead`: 2 breaking, 2 info
- **2026-09-30** `398cec19904b`: 3 info
- **2026-09-07** `bbc489673554`: 57 breaking, 3 info

## Changes

- **2026-10-03** `9095bcb65ead`: 2 breaking, 2 info
  - the request property `variations` became required
  - the `variations` request property's minItems was increased to `1`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
- **2026-09-30** `398cec19904b`: 3 info
  - added the new optional request property `default_options/oneOf[subschema #2: Base Image Request]/request_overrides`
  - added the new optional request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/request_overrides`
  - added the new optional request property `variations/items/anyOf[subschema #2: URL Image Request]/request_overrides`
- **2026-09-07** `bbc489673554`: 57 breaking, 3 info
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/dedupe_duration_s`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/jumbo_max_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/jumbo_max_width`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/max_wait_ms`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/ms_delay`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/viewport_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/viewport_width`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/dedupe_duration_s`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/jumbo_max_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/jumbo_max_width`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/max_wait_ms`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/ms_delay`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/viewport_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/viewport_width`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/dedupe_duration_s`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/jumbo_max_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/jumbo_max_width`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/max_wait_ms`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/ms_delay`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/viewport_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/viewport_width`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/pdf_options/oneOf[#/components/schemas/PDFOptions]/scale`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/pdf_options/oneOf[#/components/schemas/PDFOptions]/scale`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/pdf_options/oneOf[#/components/schemas/PDFOptions]/scale`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$` to the request property `default_options/oneOf[subschema #2: Base Image Request]/device_scale`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$` to the request property `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/device_scale`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$` to the request property `variations/items/anyOf[subschema #2: URL Image Request]/device_scale`
  - the `default_options/oneOf[subschema #2: Base Image Request]/dedupe_duration_s` request property type changed from `null, integer` to `null, integer, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/device_scale` request property type changed from `null, number` to `null, number, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/jumbo_max_height` request property type changed from `null, integer` to `null, integer, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/jumbo_max_width` request property type changed from `null, integer` to `null, integer, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/max_wait_ms` request property type changed from `null, integer` to `null, integer, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/ms_delay` request property type changed from `null, integer` to `null, integer, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/pdf_options/oneOf[#/components/schemas/PDFOptions]/scale` request property type changed from `null, number` to `null, number, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/viewport_height` request property type changed from `null, integer` to `null, integer, string`
  - the `default_options/oneOf[subschema #2: Base Image Request]/viewport_width` request property type changed from `null, integer` to `null, integer, string`
  - the `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/dedupe_duration_s` request property type changed from `null, integer` to `null, integer, string`
  - the `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/device_scale` request property type changed from `null, number` to `null, number, string`
  - the `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/jumbo_max_height` request property type changed from `null, integer` to `null, integer, string`
  - the `variations/items/anyOf[subschema #1: HTML/CSS Image Request]/jumbo_max_width` request property type changed from `null, integer` to `null, integer, string`
  - …20 more

---

[Operation](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/docs/v1/image/batch/post.md) - [API](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api.md) - [Page](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/changes/v1/image/batch/post)