Review Links are a core Frame.io feature for collecting Assets, and sending them around for feedback via a single URL without requiring explicit Team or Project access. Fundamentally, they're a representation of Assets from within a single Project, so this guide will assume that:
- You either have Assets at hand, or are familiar with uploading Assets via API.
- You know the ID of the Project in which you'd like to create the Review Link.
- Your goal is to end up with a URL that you can distribute outside of Frame.io (e.g. via email, chat, or other dispatch).
Review Links strictly belong to Projects, and an Asset in a Review Link is represented as a special resource type called a Review Link Item, which will always contain the
asset_id it's joining, as well as the full payload of the associated Asset.
While Review Link Items do not need to be tracked or managed on their own, they're a helpful structure to understand the full workflow captured in this guide. Accordingly, the hierarchical family of a Review Link looks like this:
Project > Review Link > Review Link Item > Asset reference
Before beginning this guide, you'll need to make sure you have a token that includes at least the following scopes:
|Projects: Read||Not strictly required, but necessary for fetching the |
|Assets: Read||Not strictly required, but necessary for navigating to |
|Review Links: Create, Read, Update||Create the Review Link, add Assets, and fetch information (especially if tracking in another system).|
To create a Review Link, you'll need to gather:
- A Project ID
- The IDs of one or many Assets in that Project
If you don't have the Project ID handy, but do have access to Frame.io and know which Project you'd like to use, you can see the ID on your address bar when navigating to the project:
Similarly, if you don't have the Asset ID(s) handy, navigate to the asset(s) you want, and pull the ID(s) from the address bar in your browser: