Box Developer Documentation
Log in

Remove Shared Link

Guides Shared Links Remove Shared Link
Edit this page

Remove Shared Link

A shared link may be removed from a resource by calling the update file or update folder or update weblink endpoint and setting the shared_link value to null.

If you delete the shared link and create a new one, the new shared link will have a different URL and users with the old URL will not be able to access the resource.

Remove Shared Link on File

To remove a shared link on a file, specify the ID of file to set the shared_link field to null.

cURL
curl -i -X PUT "https://api.box.com/2.0/files/32423234?fields=shared_link" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d '{
       "shared_link": null
     }'
Python
file_id = '11111'
client.file(file_id).remove_shared_link()
Node
client.files.update('12345', {
  shared_link: null
}).then(file => {
  // ...
})

Remove Shared Link on Folder

To remove a shared link on a folder, specify the ID of folder to set the shared_link field to null.

cURL
curl -i -X PUT "https://api.box.com/2.0/folders/32423234?fields=shared_link" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d '{
       "shared_link": null
     }'
Python
folder_id = '11111'
client.folder(folder_id).remove_shared_link()
Node
client.folders.update('12345', {
  shared_link: null
}).then(folder => {
  // ...
})

Remove Shared Link on Web Link

To remove a shared link on a web link, specify the ID of web link to set the shared_link field to null.

cURL
curl -i -X PUT "https://api.box.com/2.0/web_links/32423234?fields=shared_link" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d '{
       "shared_link": null
     }'
Python
client.web_link('12345').remove_shared_link()