Skip to main content

Update File Shared Link

Updates a shared link on a file.

Basic Parameters

ParameterDescription
File IDThe unique identifier that represents a file.
Shared Link AccessThe level of access for the shared link. This can berestricted to anyone with the link (open), only peoplewithin the company (company) and only those whohave been invited to the folder (collaborators).accounts.

Advanced Parameters

ParameterDescription
Shared Link PasswordThe password required to access the shared link. Set the password to null to remove it.
Shared Link Permissions Can DownloadIf the shared link allows for downloading of files.This can only be set when access is set toopen or company.
Shared Link Permissions Can EditIf the shared link allows for editing of files.This can only be set when access is set toopen or company.
Shared Link Permissions Can PreviewIf the shared link allows for previewing of files.This value is always true. For shared links on foldersthis also applies to any items in the folder.
Shared Link Unshared AtThe timestamp at which this shared link willexpire. This field can only be set byusers with paid accounts. The value must be greater than thecurrent date and time.
Shared Link Vanity NameDefines a custom vanity name to use in the shared link URL, for example https://app.box.com/v/my-shared-link.

Example Output

{
"value": {
"etag": "1",
"id": "12345",
"shared_link": {
"access": "open",
"download_count": 0,
"download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf",
"effective_access": "open",
"effective_permission": "can_download",
"is_password_enabled": false,
"permissions": {
"can_download": true,
"can_edit": true,
"can_preview": true
},
"preview_count": 0,
"unshared_at": "2020-09-21T10:34:41-07:00",
"url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1",
"vanity_name": null,
"vanity_url": null
},
"type": "file"
}
}

Workflow Library Example

Update File Shared Link with Box and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop