get https://api.shift.io/v4/sync/links/
Returns a Review Link’s properties
This call requires a link id as a path parameter, and it returns a list of that link’s properties, such as the link creator and the asset id of each asset in the link.
The link id is the 24 characters at the end of a Review Link URL.
The table below provides an overview of the link properties that are returned.
| title | The Review Link title appears in the recipient’s MediaSilo Feed, in the link’s “Information” window, and in the subject line of the notification email sent from MediaSilo (if you choose to send one). |
| description | The description appears in the recipient’s MediaSilo Feed, in the link’s “Information” window, and in the notification email sent from MediaSilo (if you choose to send one). If the value is “null,” no description was submitted. |
| authorizedUsers | If access to a link is limited to select workspace users, those users are listed here by user id, email, first name, and last name. |
| audience | The first property in the configuration object is “audience.” This refers to the link’s access setting and is either “public,” “password,” or “private” (workspace users only). |
| password | If the link is password-protected, the password is displayed here. |
| allowDownload | If “true,” the link creator has allowed viewers to download files from the link. |
| allowFeedback | If “true,” the link creator has enabled commenting and approving on the link. |
| emailNotification | If “true,” the link creator has chosen to receive an email notification each time the link is viewed. |
| limitCommentsToLink | If “true,” comments are only visible in the Review Link. If “false,” comments are made visible in both the Review Link and in Projects. |
| watermarked | If “true,” the sender applied an on-demand watermark to the contents of the link. |
| defaultConfiguration | This object provides the default link settings that an administrator selected for the workspace. Users can override these settings if they have the required permissions. |
| created | The Unix timestamp of the date and time the link was created |
| modified | The Unix timestamp of the date and time the link was last edited. An edit can include changing the expiration date or adding more files to the link. |
| lastActivityDate | The Unix timestamp of the date and time the link was last accessed. This includes the last time someone viewed or downloaded an asset from the link. |
| expires | The Unix timestamp of the date and time the link expires. This timestamp can be in the future or, if the link has already expired, in the past. A value of zero indicates that the link does not expire. |
| url | The web-accessible Review Link URL that displays the files and folders you are sharing. |
| thumbnail | This URL directs you to the link’s thumbnail image, which appears in the link recipient’s MediaSilo Feed and in the link-notification email sent from MediaSilo (if you choose to send one). |
| assetIds | The ids of each asset shared in the link |
| folderIds | The ids of each folder shared in the link. If “null,” the link does not contain any folders. |
| projectIds | These are the projects that correspond to the assets and folders in the link. |
| owner | The properties in this object provide the name, email, and user id of the person who created the link. |