All Products
Search
Document Center

Drive and Photo Service:FileListPermission

Last Updated:Aug 04, 2025

Queries the sharing authorization records of a file.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /v2/file/list_permission HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
bodyobjectNo

The request parameters.

drive_idstringNo

The drive ID.

1
file_idstringNo

The file ID.

4221bf6e6ab43a255edc4463bffa6f5f5d317401

Response parameters

ParameterTypeDescriptionExample
array

The information about the sharing authorization records of a file.

FilePermissionMember

The information about a sharing authorization record of a file.

Examples

Sample success responses

JSONformat

[
  {
    "identity": {
      "identity_type": "IT_User",
      "identity_id": "16435bdf934248b788b7b3771ee9a3dw"
    },
    "role_id": "SystemFileDownloader",
    "expire_time": 1633598085642,
    "disinherit_sub_group": false,
    "action_list": [
      "FILE.CREATE"
    ]
  }
]

Error codes

For a list of error codes, visit the Service error codes.