---
title: "Apply watermark to folder"
method: PUT
path: "/folders/{folder_id}/watermark"
tags: ["Watermarks (Folders)"]
---

# Apply watermark to folder

`PUT /folders/{folder_id}/watermark`

Applies or update a watermark on a folder.

## Path parameters

- `folder_id` string, required

## Request body

- object
  - `watermark` object, required — The watermark to imprint on the folder.
    - `imprint` 'default', required — The type of watermark to apply. Currently only supports one option.

## Response `200`

Returns an updated watermark if a watermark already
existed on this folder.

- Watermark — A watermark is a semi-transparent overlay on an embedded file preview that displays a viewer's email address or user ID and the time of access over a file's content.
  - `watermark` object
    - `created_at` string, date-time — When this watermark was created.
    - `modified_at` string, date-time — When this task was modified.

## Other responses

- `201` — Returns a new watermark if no watermark existed on this folder yet.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)