Lock

POST /wopi/files/(file_id)

Locks file editing by an online office that requested the lock.

This operation works as follows:

  1. The WOPI host checks if a file is currently locked or not.
  2. If the file is unlocked, the host should lock the file and return 200 OK.
  3. If the file is already locked and the X-WOPI-Lock value matches the lock currently on the file, the host should refresh the lock timer and return 200 OK.
  4. In all other cases, the host must return 409 Conflict (“lock mismatch”) and include the X-WOPI-Lock response header containing the value of the current lock on the file.
  5. In the case where the file is locked by a third-party client, hosts should still always include the current lock ID in the X-WOPI-Lock response header.

Parameters

NameDescriptionType
file_idThe file ID that must be URL safe.string

Query parameters

NameDescriptionType
access_tokenAn access token that the host will use to determine whether the request is authorized.string

Request headers

NameDescriptionTypePresence
X-WOPI-OverrideThe requested operation from the WOPI server (LOCK).stringrequired
X-WOPI-LockThe lock ID that the host must use to identify the lock on the file.stringrequired

Response headers

NameDescriptionTypePresence
X-WOPI-LockThe lock ID identifying the current lock on the file. This header must always be included when responding to the request with 409 Conflict. It should not be included when responding to the request with 200 OK.stringoptional
X-WOPI-LockFailureReasonThe cause of the lock failure. This header may be included when responding to the request with 409 Conflict. It must only be used for logging purposes.stringoptional
X-WOPI-ItemVersionThe file version.stringoptional