get https://api.shift.io/v4/sync/links/
Returns a Review Link’s properties
This call requires a link id as a parameter and returns a list of that link’s properties. A link id is the 24 characters at the end of a Review Link URL. The response includes the name of the link creator and the asset id of each file shared in the link. The table below provides an overview of the properties that are returned.
| authorizedUsers | If access to a link is limited to select workspace users, those users are listed here. |
| 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. |
| created | This is the Unix timestamp of the date and time the link was created. |
| modified | This is 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 | This is 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 | This is 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. |
| assetIds | These are the ids of the individual assets shared in the link. |
| folderIds | These are the ids of entire folders 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. |