Add the power of the Box AI API to your custom apps at Content Cloud Summit on May 15

Learn more and register!

Create Folder Lock

Create Folder Lock

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 Locks

When 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 "" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "folder": {
         "type": "folder",
         "id": "33552487093"
       "locked_operations": {
         "move": true,
         "delete": true
client.folders.createLock(folderId: "22222") { (result: Result<FolderLock, BoxSDKError>) in
    guard case let .success(folderLock) = result else {
        print("Error creating folder lock")

    print("Created folder lock with id \"\(\" inside of folder with id \"\(folderLock.folder?.id)\"")
TypeScript (Beta)
await client.folderLocks.createFolderLock({
  folder: {
    type: 'folder',
  } satisfies CreateFolderLockRequestBodyFolderField,
  lockedOperations: {
    move: true,
    delete: true,
  } satisfies CreateFolderLockRequestBodyLockedOperationsField,
} satisfies CreateFolderLockRequestBody);
Python (Beta)
client.folder_locks.create_folder_lock(CreateFolderLockFolder(, type='folder'), locked_operations=CreateFolderLockLockedOperations(move=True, delete=True))
.NET (Beta)
await client.FolderLocks.CreateFolderLockAsync(requestBody: new CreateFolderLockRequestBody(folder: new CreateFolderLockRequestBodyFolderField(id: folder.Id, type: "folder"), lockedOperations: new CreateFolderLockRequestBodyLockedOperationsField(move: true, delete: true)));

Setting Locked Operations

If 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.