BObox
Watermarks (Folders)

Apply watermark to folder

Changed on

Applies or update a watermark on a folder.

put/folders/{folder_id}/watermark

Request

  • Base URL
    https://api.box.com/2.0
  • URL
    https://api.box.com/2.0/folders/{folder_id}/watermark
  • Auth
    OAuth 2
    Authorization code: https://account.box.com/api/oauth2/authorize
    Token URL: https://api.box.com/oauth2/token

Path parameters

folder_idstring required

The unique identifier that represent a folder.

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

The root folder of a Box account is always represented by the ID 0.

Request body

Example request

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

Response

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

Example response

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

Changes

  • c4d5303fa5c3Revision changes
    • warning

      added the new unprocessable_entity enum value to the response property for the response status