---
title: "Changes to Create a new version for an existing template"
method: POST
path: "/v1/template/{id}"
---

# Changes to Create a new version for an existing template

`POST /v1/template/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 13 revisions.

- **2026-10-15** `5ae0f7aed53d`: 1 info
- **2026-09-30** `398cec19904b`: 1 info
- **2026-09-16** `524335d5910f`: 1 info
- **2026-09-07** `bbc489673554`: 17 breaking, 3 info

## Changes

- **2026-10-15** `5ae0f7aed53d`: 1 info
  - added the new optional request property `pdf_options`
- **2026-09-30** `398cec19904b`: 1 info
  - added the new optional request property `request_overrides`
- **2026-09-16** `524335d5910f`: 1 info
  - added the new optional request property `selector`
- **2026-09-07** `bbc489673554`: 17 breaking, 3 info
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `jumbo_max_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `jumbo_max_width`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `max_wait_ms`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `ms_delay`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `viewport_height`
  - added the pattern `^-?(?:0|[1-9]\d*)$` to the request property `viewport_width`
  - added the pattern `^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$` to the request property `device_scale`
  - the `device_scale` request property type changed from `null, number` to `null, number, string`
  - the `jumbo_max_height` request property type changed from `null, integer` to `null, integer, string`
  - the `jumbo_max_width` request property type changed from `null, integer` to `null, integer, string`
  - the `max_wait_ms` request property type changed from `null, integer` to `null, integer, string`
  - the `ms_delay` request property type changed from `null, integer` to `null, integer, string`
  - the `viewport_height` request property type changed from `null, integer` to `null, integer, string`
  - the `viewport_width` request property type changed from `null, integer` to `null, integer, string`
  - the `statusCode` response's property type changed from `integer` to `integer, string` for status `400`
  - the `statusCode` response's property type changed from `integer` to `integer, string` for status `429`
  - the `template_version` response's property type changed from `integer` to `integer, string` for status `200`
  - the `statusCode` response's property pattern `^-?(?:0|[1-9]\d*)$` was added for the status `400`
  - the `statusCode` response's property pattern `^-?(?:0|[1-9]\d*)$` was added for the status `429`
  - the `template_version` response's property pattern `^-?(?:0|[1-9]\d*)$` was added for the status `200`

---

[Operation](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/docs/v1/template/:id/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/template/:id/post)