All Products
Search

This Product

    Drive and Photo Service:FileAddPermission

    Document Center

    Drive and Photo Service:FileAddPermission

    Last Updated:Jun 26, 2026

    Grants folder-level authorization. Each drive supports a maximum of 1000 authorization records. Authorization records that exceed this limit do not take effect.

    Operation description

    Each drive supports a maximum of 1000 authorization records. Authorization records that exceed this limit do not take effect.

    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/add_permission HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    domain_id

    string

    Yes

    body

    object

    No

    The request body parameters.

    drive_id

    string

    Yes

    The ID of the drive.

    1
    file_id

    string

    Yes

    The ID of the folder. To authorize an entire team drive, set this parameter to root. Setting this parameter to root is not supported for personal drive sharing.

    4221bf6e6ab43c255edc4463bf3a6f5f5d317406
    member_list

    array

    Yes

    The list of members to be authorized.

    FilePermissionMember

    No

    The authorization information.

    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.