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

Folder Lock

Folder locks define access restrictions placed by folder owners to prevent specific folders from being moved or deleted.

id string

example12345678

The unique identifier for this folder lock.

type string

examplefolder_lock

The object type, always folder_lock.

created_at string (date-time)

example2020-09-14T23:12:53Z

When the folder lock object was created.

created_byUser (Base) object

The user or group that created the lock.

folderFolder (Mini) object

The folder that the lock applies to.

lock_type string

examplefreeze

The lock type, always freeze.

locked_operations object

The operations that have been locked. Currently the move and delete operations cannot be locked separately, and both need to be set to true.

locked_operations.delete boolean

exampletrue

Whether deleting the folder is restricted.

locked_operations.move boolean

exampletrue

Whether moving the folder is restricted.

Response Example

{
  "id": "12345678",
  "type": "folder_lock",
  "created_at": "2020-09-14T23:12:53Z",
  "created_by": {
    "id": "11446498",
    "type": "user"
  },
  "folder": {
    "id": "12345",
    "type": "folder",
    "etag": "1",
    "name": "Contracts",
    "sequence_id": "3"
  },
  "lock_type": "freeze",
  "locked_operations": {
    "delete": true,
    "move": true
  }
}