---
title: "Update watermark"
method: PUT
path: "/1/videos/{channel}/options/watermark"
tags: ["Option > Watermarking"]
---

# Update watermark

`PUT /1/videos/{channel}/options/watermark`

This endpoint allows you to retrieve to update or create the watermark.

## Path parameters

- `channel` integer, required

## Query parameters

- `with` string
- `account_id` integer, required — Account identifier

## Request body

- object
  - `align` string, required — Specify the position
  - `enabled` boolean, nullable — Enable the watermark
  - `follow_update` boolean, nullable
  - `height` integer — Specify the height size of image (px)
  - `horizontal_offset` integer, required — Specify the horizontal spacing in (px)
  - `image_path` string — Specify the image in base 64
  - `opacity_percentage` integer — Specify the opacity in percent
  - `size_percentage` integer — Specify the size of image in percent
  - `vertical_offset` integer, required — Specify the vertical spacing in (px)
  - `width` integer — Specify the width size of image (px)
  - `z_index` integer, nullable — Specify the opacity in percent

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` A57c9d69TranscodingOverlay
    - `overlay_id` integer, required
    - `name` string, required — Name of the resource `TranscodingOverlay`
    - `enabled` boolean, required
    - `follow_update` boolean, required
    - `description` string, required — Description of the resource `TranscodingOverlay`
    - `z_index` integer, required
    - `align` string, required
    - `width` integer, required
    - `height` integer, required
    - `opacity_percentage` integer, required
    - `horizontal_offset` integer, required
    - `vertical_offset` integer, required
    - `size_percentage` integer, required
    - `was_enabled` boolean, required
    - `encoder_preset` A57c9d69EncoderPreset
      - `encoder_preset_id` integer, required
      - `stream_id` string, required — Unique identifier of the `stream` that is related to the resource `EncoderPreset`
      - `template_id` integer, required
      - `name` string, required — Name of the resource `EncoderPreset`
      - `enabled` boolean, required
      - `video_bitrate` integer, required
      - `audio_bitrate` integer, required
      - `video_codec` string, required
      - `audio_codec` string, required
      - `encoding_implementation` string, required
      - `gpu_id` integer, required
      - `profile` string, required
      - `key_frame_interval` integer, required
      - `fit_mode` string, required
      - `width` integer, required
      - `height` integer, required
      - `crop_top` integer, required
      - `crop_bottom` integer, required
      - `crop_left` integer, required
      - `crop_right` integer, required
    - `image_path` string, required

## Other responses

- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)