Box Developer Documentation

Join BoxWorks 2024 to discover what's possible with content and AI!

Register now!

Get Folder Lock

Get Folder Lock

To get a list of the current locks on a folder in Box, call the GET /folder_locks/ API with the id of the folder supplied as a folder_id query string parameter.

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
curl -i -X GET "https://api.box.com/2.0/folder_locks?folder_id=33552487093" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
TypeScript Gen
await client.folderLocks.getFolderLocks({
  folderId: folder.id,
} satisfies GetFolderLocksQueryParams);
Python Gen
client.folder_locks.get_folder_locks(folder.id)
.NET Gen
await client.FolderLocks.GetFolderLocksAsync(queryParams: new GetFolderLocksQueryParams(folderId: folder.Id));
Swift Gen (Beta)
try await client.folderLocks.getFolderLocks(queryParams: GetFolderLocksQueryParams(folderId: folder.id))
iOS
client.folders.listLocks(folderId: "22222") { results in
    switch results {
    case let .success(iterator):
        for i in 1 ... 10 {
            iterator.next { result in
                switch result {
                case let .success(folderLock):
                    print("- \(folderLock.id)")
                case let .failure(error):
                    print(error)
                }
            }
        }
    case let .failure(error):
        print(error)
    }
}

Folder ID

The id of any folder can be determined by visiting a 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.