Skip to content

shared_links_folders.md

Latest commit

 

History

History
197 lines (139 loc) · 7.47 KB

shared_links_folders.md

File metadata and controls

197 lines (139 loc) · 7.47 KB

SharedLinksFoldersManager

Find folder for shared link

Return the folder represented by a shared link.

A shared folder can be represented by a shared link, which can originate within the current enterprise or within another.

This endpoint allows an application to retrieve information about a shared folder when only given a shared link.

This operation is performed by calling function find_folder_for_shared_link.

See the endpoint docs at API Reference.

user_client.shared_links_folders.find_folder_for_shared_link(
    "".join(
        [
            "shared_link=",
            folder_from_api.shared_link.url,
            "&shared_link_password=Secret123@",
        ]
    )
)

Arguments

  • fields Optional[List[str]]
    • A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.
  • if_none_match Optional[str]
    • Ensures an item is only returned if it has changed. Pass in the item's last observed etag value into this header and the endpoint will fail with a 304 Not Modified if the item has not changed since.
  • boxapi str
    • A header containing the shared link and optional password for the shared link. The format for this header is as follows: shared_link=[link]&shared_link_password=[password].
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type FolderFull.

Returns a full folder resource if the shared link is valid and the user has access to it.

Get shared link for folder

Gets the information for a shared link on a folder.

This operation is performed by calling function get_shared_link_for_folder.

See the endpoint docs at API Reference.

client.shared_links_folders.get_shared_link_for_folder(folder.id, "shared_link")

Arguments

  • folder_id str
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • fields str
    • Explicitly request the shared_link fields to be returned for this item.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type FolderFull.

Returns the base representation of a folder with the additional shared link information.

Add shared link to folder

Adds a shared link to a folder.

This operation is performed by calling function add_share_link_to_folder.

See the endpoint docs at API Reference.

client.shared_links_folders.add_share_link_to_folder(
    folder.id,
    "shared_link",
    shared_link=AddShareLinkToFolderSharedLink(
        access=AddShareLinkToFolderSharedLinkAccessField.OPEN, password="Secret123@"
    ),
)

Arguments

  • folder_id str
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • shared_link Optional[AddShareLinkToFolderSharedLink]
    • The settings for the shared link to create on the folder. Use an empty object ({}) to use the default settings for shared links.
  • fields str
    • Explicitly request the shared_link fields to be returned for this item.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type FolderFull.

Returns the base representation of a folder with a new shared link attached.

Update shared link on folder

Updates a shared link on a folder.

This operation is performed by calling function update_shared_link_on_folder.

See the endpoint docs at API Reference.

client.shared_links_folders.update_shared_link_on_folder(
    folder.id,
    "shared_link",
    shared_link=UpdateSharedLinkOnFolderSharedLink(
        access=UpdateSharedLinkOnFolderSharedLinkAccessField.COLLABORATORS
    ),
)

Arguments

  • folder_id str
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • shared_link Optional[UpdateSharedLinkOnFolderSharedLink]
    • The settings for the shared link to update.
  • fields str
    • Explicitly request the shared_link fields to be returned for this item.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type FolderFull.

Returns a basic representation of the folder, with the updated shared link attached.

Remove shared link from folder

Removes a shared link from a folder.

This operation is performed by calling function remove_shared_link_from_folder.

See the endpoint docs at API Reference.

client.shared_links_folders.remove_shared_link_from_folder(
    folder.id, "shared_link", shared_link=create_null()
)

Arguments

  • folder_id str
    • The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123. The root folder of a Box account is always represented by the ID 0. Example: "12345"
  • shared_link Optional[RemoveSharedLinkFromFolderSharedLink]
    • By setting this value to null, the shared link is removed from the folder.
  • fields str
    • Explicitly request the shared_link fields to be returned for this item.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type FolderFull.

Returns a basic representation of a folder, with the shared link removed.