Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

To create a lock on a folder in Box you will need to provide our API with the id of the folder for which the lock should be applied. Optionally you may supply the specific locked_operations to be applied with the folder lock.
Folder LocksWhen using any folder lock API endpoints, you must be authenticated as the owner/co-owner of the folder you are trying to access.
curl -i -X POST "https://api.box.com/2.0/folder_locks" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "folder": {
         "type": "folder",
         "id": "33552487093"
       },
       "locked_operations": {
         "move": true,
         "delete": true
       }
     }'
Setting Locked OperationsIf the locked_operations object is included with a folder lock request, both move and delete need to be set to true. Supplying only one lock operation in the object, or setting the values of both to something other than true will produce an error. These options are in place to allow for additional operations in the future.

​
Lock Operations

There are two possible lock operations that may be applied to a folder, move and delete. The move lock will prevent the folder from being moved to a new location or owner while the lock is still applied. The delete lock will prevent the folder from being deleted while the lock is still applied.