# Update watermark configuration

URL: /en/docs/api/v1/watermark/put
Last Updated: 2026-07-30T21:15:44.988Z

## Description
No description available.

## Available Actions
- Execute PUT request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### PUT /api/v1/watermark

**Update watermark configuration**

Update tenant-specific watermark configuration used for protected document downloads.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`) - required:

- `enabled` (boolean)
- `text` (string)
- `position` (enum: center | top-left | top-right | bottom-left | bottom-right)
- `opacity` (number)
- `size` (integer)
- `color` (string)
- `rotation` (integer)

**Responses:**

- `200` - Watermark configuration updated successfully
  - `enabled` (boolean): Whether watermarking is enabled for the tenant.
  - `text` (string): Primary watermark text displayed in the document.
  - `position` (enum: center | top-left | top-right | bottom-left | bottom-right): Base placement for the watermark block.
  - `opacity` (number): Opacity value for the rendered watermark text.
  - `size` (integer): Font size used for watermark text.
  - `color` (string): Text color provided as a hex RGB value.
  - `rotation` (integer): Rotation angle applied to the watermark text block.
- `400` - Validation error – invalid configuration values
- `401` - Unauthorized
- `403` - Forbidden - Admin role required