> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update File Shared Link

Updates a shared link on a file.

## Basic Parameters

<div className="integrations-table">
  | Parameter          | Description                                                                                                                                                                                                                                      |
  | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | File ID            | The unique identifier that represents a file.                                                                                                                                                                                                    |
  | Shared Link Access | The level of access for the shared link. This can be<br />restricted to anyone with the link (`open`), only people<br />within the company (`company`) and only those who<br />have been invited to the folder (`collaborators`).<br />accounts. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                            | Description                                                                                                                                                                           |
  | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Shared Link Password                 | The password required to access the shared link. Set the password to `null` to remove it.                                                                                             |
  | Shared Link Permissions Can Download | If the shared link allows for downloading of files.<br />This can only be set when `access` is set to<br />`open` or `company`.                                                       |
  | Shared Link Permissions Can Edit     | If the shared link allows for editing of files.<br />This can only be set when `access` is set to<br />`open` or `company`.                                                           |
  | Shared Link Permissions Can Preview  | If the shared link allows for previewing of files.<br />This value is always `true`. For shared links on folders<br />this also applies to any items in the folder.                   |
  | Shared Link Unshared At              | The timestamp at which this shared link will<br />expire. This field can only be set by<br />users with paid accounts. The value must be greater than the<br />current date and time. |
  | Shared Link Vanity Name              | Defines a custom vanity name to use in the shared link URL, for example `https://app.box.com/v/my-shared-link`.                                                                       |
</div>

## Example Output

```json theme={"dark"}
{
	"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](https://library.blinkops.com/workflows/update-file-shared-link-with-box-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/update-file-shared-link-with-box-and-send-results-via-email/canvas" />
</div>