---
title: "Changes to Add Watermark"
method: POST
path: "/watermark"
---

# Changes to Add Watermark

`POST /watermark`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `466238206997`: 6 breaking, 24 warning, 8 info

## Changes

- **2026-11-03** `466238206997`: 6 breaking, 24 warning, 8 info
  - added `#/components/schemas/ImageParameters, #/components/schemas/ExportParameters` to the request body `allOf` list
  - the request property `allOf[#/components/schemas/WatermarkParameters]/watermark_height` became not nullable
  - the request property `allOf[#/components/schemas/WatermarkParameters]/watermark_padding_x` became not nullable
  - the request property `allOf[#/components/schemas/WatermarkParameters]/watermark_padding_y` became not nullable
  - the request property `allOf[#/components/schemas/WatermarkParameters]/watermark_width` became not nullable
  - removed the success response with the status `202`
  - the optional response header `X-Correlation-Id` removed for the status `400`
  - the optional response header `X-Correlation-Id` removed for the status `401`
  - the optional response header `X-Correlation-Id` removed for the status `403`
  - the optional response header `X-Correlation-Id` removed for the status `404`
  - the optional response header `X-Correlation-Id` removed for the status `405`
  - the optional response header `X-Correlation-Id` removed for the status `413`
  - the optional response header `X-Correlation-Id` removed for the status `415`
  - the optional response header `X-Correlation-Id` removed for the status `429`
  - the optional response header `X-Correlation-Id` removed for the status `431`
  - the optional response header `X-Correlation-Id` removed for the status `500`
  - the optional response header `X-Correlation-Id` removed for the status `503`
  - removed `#/components/schemas/VideoParameters` from the request body `allOf` list
  - removed the request property `allOf[#/components/schemas/WatermarkParameters]/anchor_point`
  - removed the optional property `code` from the response with the `400` status
  - removed the optional property `code` from the response with the `402` status
  - removed the optional property `code` from the response with the `403` status
  - removed the optional property `code` from the response with the `404` status
  - removed the optional property `code` from the response with the `405` status
  - removed the optional property `code` from the response with the `413` status
  - removed the optional property `code` from the response with the `415` status
  - removed the optional property `code` from the response with the `429` status
  - removed the optional property `code` from the response with the `431` status
  - removed the optional property `code` from the response with the `500` status
  - removed the optional property `code` from the response with the `503` status
  - api operation id `video-add-watermark` removed and replaced with `image-add-watermark`
  - added the new optional request property `allOf[#/components/schemas/WatermarkParameters]/watermark_anchor_point`
  - request property `allOf[#/components/schemas/WatermarkParameters]/watermark_height` list-of-types was widened by adding types `string` to media type `multipart/form-data`
  - request property `allOf[#/components/schemas/WatermarkParameters]/watermark_padding_x` list-of-types was widened by adding types `string` to media type `multipart/form-data`
  - request property `allOf[#/components/schemas/WatermarkParameters]/watermark_padding_y` list-of-types was widened by adding types `string` to media type `multipart/form-data`
  - request property `allOf[#/components/schemas/WatermarkParameters]/watermark_width` list-of-types was widened by adding types `string` to media type `multipart/form-data`
  - added the non-success response with the status `529`
  - added the success response with the status `200`

---

[Operation](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis/docs/watermark/post.md) - [API](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis.md) - [Page](https://skmtc.dev/picsart/apis/picsart-programmable-image-apis/changes/watermark/post)