Manage Applications

    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"
      }
    }