# Watermarks operations

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



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

## Operations

- [`watermarks.list`](/document-api/reference/watermarks/list) (read): List Word-compatible text and picture watermarks and their effective header scopes. Available on v2-backed sessions only; v1-backed sessions currently return `CAPABILITY_UNAVAILABLE`.
- [`watermarks.insert`](/document-api/reference/watermarks/insert) (mutates): Insert a Word-compatible text or picture watermark into a header scope. Available on v2-backed sessions only; v1-backed sessions currently return `CAPABILITY_UNAVAILABLE`.
- [`watermarks.replace`](/document-api/reference/watermarks/replace) (mutates): Replace an existing watermark while retaining its stable identity and owner scope. Available on v2-backed sessions only; v1-backed sessions currently return `CAPABILITY_UNAVAILABLE`.
- [`watermarks.remove`](/document-api/reference/watermarks/remove) (mutates): Remove a watermark without removing unrelated header content. Available on v2-backed sessions only; v1-backed sessions currently return `CAPABILITY_UNAVAILABLE`.