SharedLinksFilesManager

• Find file for shared link
• Get shared link for file
• Add shared link to file
• Update shared link on file
• Remove shared link from file

Find file for shared link

Returns the file represented by a shared link.

A shared file 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 file when only given a shared link.

The shared_link_permission_options array field can be returned by requesting it in the fields query parameter.

This operation is performed by calling function findFileForSharedLink.

See the endpoint docs at API Reference.

try await userClient.sharedLinksFiles.findFileForSharedLink(queryParams: FindFileForSharedLinkQueryParams(), headers: FindFileForSharedLinkHeaders(boxapi: "\("shared_link=")\(fileFromApi.sharedLink!.url)\("&shared_link_password=Secret123@")"))

Arguments

• queryParams FindFileForSharedLinkQueryParams
  • Query parameters of findFileForSharedLink method
• headers FindFileForSharedLinkHeaders
  • Headers of findFileForSharedLink method

Returns

This function returns a value of type FileFull.

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

Get shared link for file

Gets the information for a shared link on a file.

This operation is performed by calling function getSharedLinkForFile.

See the endpoint docs at API Reference.

try await client.sharedLinksFiles.getSharedLinkForFile(fileId: fileId, queryParams: GetSharedLinkForFileQueryParams(fields: "shared_link"))

Arguments

• fileId String
  • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
• queryParams GetSharedLinkForFileQueryParams
  • Query parameters of getSharedLinkForFile method
• headers GetSharedLinkForFileHeaders
  • Headers of getSharedLinkForFile method

Returns

This function returns a value of type FileFull.

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

Add shared link to file

Adds a shared link to a file.

This operation is performed by calling function addShareLinkToFile.

See the endpoint docs at API Reference.

try await client.sharedLinksFiles.addShareLinkToFile(fileId: fileId, requestBody: AddShareLinkToFileRequestBody(sharedLink: AddShareLinkToFileRequestBodySharedLinkField(access: AddShareLinkToFileRequestBodySharedLinkAccessField.open, password: "Secret123@")), queryParams: AddShareLinkToFileQueryParams(fields: "shared_link"))

Arguments

• fileId String
  • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
• requestBody AddShareLinkToFileRequestBody
  • Request body of addShareLinkToFile method
• queryParams AddShareLinkToFileQueryParams
  • Query parameters of addShareLinkToFile method
• headers AddShareLinkToFileHeaders
  • Headers of addShareLinkToFile method

Returns

This function returns a value of type FileFull.

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

Update shared link on file

Updates a shared link on a file.

This operation is performed by calling function updateSharedLinkOnFile.

See the endpoint docs at API Reference.

try await client.sharedLinksFiles.updateSharedLinkOnFile(fileId: fileId, requestBody: UpdateSharedLinkOnFileRequestBody(sharedLink: UpdateSharedLinkOnFileRequestBodySharedLinkField(access: UpdateSharedLinkOnFileRequestBodySharedLinkAccessField.collaborators)), queryParams: UpdateSharedLinkOnFileQueryParams(fields: "shared_link"))

Arguments

• fileId String
  • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
• requestBody UpdateSharedLinkOnFileRequestBody
  • Request body of updateSharedLinkOnFile method
• queryParams UpdateSharedLinkOnFileQueryParams
  • Query parameters of updateSharedLinkOnFile method
• headers UpdateSharedLinkOnFileHeaders
  • Headers of updateSharedLinkOnFile method

Returns

This function returns a value of type FileFull.

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

Remove shared link from file

Removes a shared link from a file.

This operation is performed by calling function removeSharedLinkFromFile.

See the endpoint docs at API Reference.

Currently we don't have an example for calling removeSharedLinkFromFile in integration tests

Arguments

• fileId String
  • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
• requestBody RemoveSharedLinkFromFileRequestBody
  • Request body of removeSharedLinkFromFile method
• queryParams RemoveSharedLinkFromFileQueryParams
  • Query parameters of removeSharedLinkFromFile method
• headers RemoveSharedLinkFromFileHeaders
  • Headers of removeSharedLinkFromFile method

Returns

This function returns a value of type FileFull.

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