All Products
Search

This Product

    Drive and Photo Service:FileRemovePermission

    Document Center

    Drive and Photo Service:FileRemovePermission

    Last Updated:May 27, 2026

    Revokes a file sharing permission.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request syntax

    POST /v2/file/remove_permission HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    domain_id

    string

    Yes

    body

    object

    Yes

    The request body parameters.

    drive_id

    string

    Yes

    The drive ID.

    1
    file_id

    string

    Yes

    The file ID.

    4221bf6e6ab43c255edc4463bf3a6f5f5d317406
    member_list

    array<object>

    Yes

    The members whose permissions you want to remove.

    object

    Yes

    identity Identity

    Yes

    The identity from which to revoke the permission. An identity can be a user or a user group.

    role_id

    string

    Yes

    The ID of the role to remove. This parameter is mutually exclusive with action_list. If both are specified, role_id takes precedence.

    Valid values:

    SystemFileOwner (file collaborator)

    SystemFileDownloader (downloader)

    SystemFileEditor (editor)

    SystemFileEditorWithoutDelete (editor without delete permission)

    SystemFileEditorWithoutShareLink (editor without share permission)

    SystemFileMetaViewer (list viewer)

    SystemFileUploader (uploader), and SystemFileUploaderAndDownloader (uploader/downloader)

    SystemFileDownloaderWithShareLink (downloader/sharer)

    SystemFileUploaderAndDownloaderWithShareLink (uploader/downloader/sharer)

    SystemFileUploaderAndViewer (viewer/uploader)

    SystemFileUploaderWithShareLink (uploader/sharer)

    SystemFileViewer (viewer)

    SystemFileDownloader

    Response elements

    Element

    Type

    Description

    Example

    None defined.

    Examples

    Success response

    JSON format

    {}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.