# Watermarks operations

> Word-compatible text and picture watermark lifecycle and placement.



5 operations. Names, descriptions, and behavior flags come from the canonical contract.

## Operations

- [`watermarks.apply`](/document-api/reference/watermarks/apply) (mutates): Atomically insert, replace, or remove selected watermarks in explicit scopes while preserving surrounding headers.
- [`watermarks.list`](/document-api/reference/watermarks/list) (read): List Word-compatible text and picture watermarks and their effective header scopes.
- [`watermarks.insert`](/document-api/reference/watermarks/insert) (mutates): Insert a Word-compatible text or picture watermark into a header scope.
- [`watermarks.replace`](/document-api/reference/watermarks/replace) (mutates): Replace an existing watermark while retaining its stable identity and owner scope.
- [`watermarks.remove`](/document-api/reference/watermarks/remove) (mutates): Remove a watermark without removing unrelated header content.