Get folder watermark

get
https://api.box.com/2.0
/folders/:folder_id/watermark

Retrieve the watermark for a folder.

Request

application/json

Path Parameters

stringin pathrequired
0

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.

Response

application/jsonWatermark

Returns an object containing information about the watermark associated for to this folder.

application/jsonClient Error

Returns an error if the folder does not have a watermark applied.

You can now try out some of our APIs live, right here in the documentation.
Log In

Request Example

cURL
curl -X GET https://api.box.com/2.0/folders/4353455/watermark \
     -H "Authorization: Bearer <ACCESS_TOKEN>"
.NET
BoxWatermark watermark = await client.FoldersManager.GetWatermarkAsync("22222");
Java
BoxFolder folder = new BoxFolder(api, id);
BoxWatermark watermark = folder.getWatermark();
Python
watermark = client.folder(folder_id='11111').get_watermark()
print('Watermark created at {0} and modified at {1}'.format(watermark.created_at, watermark.modified_at))
Node
client.folders.getWatermark('22222')
	.then(watermark => {
		/* watermark -> {
			watermark: 
			{ created_at: '2016-10-31T15:33:33-07:00',
				modified_at: '2016-10-31T15:33:33-07:00' } }
		*/
	});

Response Example

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