PIpicsart
Watermark

Add Watermark

Changed on

Add watermark to your image.

post/watermark

Request

  • Base URL
    https://api.picsart.io/tools/1.0
  • URL
    https://api.picsart.io/tools/1.0/watermark
  • Auth
    API key in header X-Picsart-API-Key

Request body multipart/form-data

imagestring binary

Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)

image_urlstring uri

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image_idstring

Deprecated. Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.)

watermarkstring binary nullable

Source watermark image file (binary). (If this parameter is present, the other watermark image source parameters must be empty.)

watermark_urlstring uri nullable

Source watermark image URL. (If this parameter is present, the other watermark image source parameters must be empty.)

watermark_anchor_point'left-top' | 'left-middle' | 'left-bottom' | 'center-top' | 'center-middle' | 'center-bottom' | 'right-top' | 'right-middle' | 'right-bottom' | 'pattern'

Anchor point for the watermark.

watermark_opacityinteger nullable

Define the opacity of the watermark. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent.

watermark_angleinteger nullable

Define the angle of the watermark. Takes values from 0 to 360.

format'JPG' | 'PNG' | 'WEBP'

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows:

  • JPG
  • PNG
  • WEBP

Response

Success.

statusstring

Changes

  • 466238206997Revision changes
    • breaking

      added to the request body allOf list

    • breaking

      the request property //// became not nullable

    • breaking

      the request property //// became not nullable

    • breaking

      the request property //// became not nullable

    • breaking

      the request property //// became not nullable

    • breaking

      removed the success response with the status

    • warning

      the optional response header X-Correlation-Id removed for the status 400

    • warning

      the optional response header X-Correlation-Id removed for the status 401

    • warning

      the optional response header X-Correlation-Id removed for the status 403

    • warning

      the optional response header X-Correlation-Id removed for the status 404

    • warning

      the optional response header X-Correlation-Id removed for the status 405

    • warning

      the optional response header X-Correlation-Id removed for the status 413

    • warning

      the optional response header X-Correlation-Id removed for the status 415

    • warning

      the optional response header X-Correlation-Id removed for the status 429

    • warning

      the optional response header X-Correlation-Id removed for the status 431

    • warning

      the optional response header X-Correlation-Id removed for the status 500

    • warning

      the optional response header X-Correlation-Id removed for the status 503

    • warning

      removed from the request body allOf list

    • warning

      removed the request property ////

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id video-add-watermark removed and replaced with image-add-watermark

    • info

      added the new optional request property ////

    • info

      request property //// list-of-types was widened by adding types string to media type multipart/form-data

    • info

      request property //// list-of-types was widened by adding types string to media type multipart/form-data

    • info

      request property //// list-of-types was widened by adding types string to media type multipart/form-data

    • info

      request property //// list-of-types was widened by adding types string to media type multipart/form-data

    • info

      added the non-success response with the status

    • info

      added the success response with the status