CheckFileInfo operation returns information about a file, a user's permissions on that file, and general information about the capabilities that the WOPI host has on the file.
CheckFileInfo operation is one of the most important WOPI operations.
CheckFileInfo must be implemented for all WOPI actions. This operation returns information about a file, a user’s permissions on that file, and general information about the capabilities that the WOPI host has on the file. Also, some
CheckFileInfo properties can influence the appearance and behavior of WOPI clients.
Some properties aren't supported within the Office 365 - Cloud Storage Partner Program. These operations are marked 🔒
Not supported in the CSPP.
- file_id (string) – A string that specifies a file ID of a file managed by the host. This string must be URL safe.
- access_token (string) – An access token that the host uses to determine whether the request is authorized.
- X-WOPI-SessionContext – The value of the session context, if provided on the initial WOPI action URL.
200 OK – Success.
404 Not Found – Resource not found or user unauthorized.
500 Internal Server Error – Server error.
In addition to the request and response headers listed here, this operation might also use the Standard WOPI request and response headers. For more information see Standard WOPI request and response headers.
CheckFileInfo response properties are a key way that a WOPI host communicates capabilities and expected behaviors to WOPI clients. Many of the properties in the
CheckFileInfo response are required. Even properties that are optional provide important ways for the host to direct the end-user client experience.
PostMessage properties for web-based WOPI clients
CheckFileInfo supports a number of properties that web-based WOPI clients can use, such as Office for the web to customize the user interface and experience when using those clients. For more information on these properties and how to use them, see PostMessage properties.
CheckFileInfo properties for CSPP Plus
CSPP Plus extends
CheckFileInfo with additional properties intended to support WOPI+ hosts.
For more information, see CSPP Plus CheckFileInfo properties.
These are additional properties supported by
CheckFileInfo but aren't central to the operation of a WOPI host. Properties that are pre-release and not supported by any WOPI client or have been previously deprecated are also listed here.
For more information on other supported properties, see Other CheckFileInfo property reference.