v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Watermarks (Files)

Apply watermark to file

Applies or update a watermark on a file.

put/files/{file_id}/watermark

Path parameters

file_idstring required

The unique identifier that represents a file.

The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123.

Request body

Example request

{
  "watermark": {
    "imprint": "default"
  }
}

Response

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

Example response

{
  "watermark": {
    "created_at": "2012-12-12T10:53:43-08:00",
    "modified_at": "2012-12-12T10:53:43-08:00"
  }
}