Overview
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 (i.e. the context for URL distribution will not be Frame.io's API or templates).
Core concepts
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 review_link_id
and 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
- Review Link Item
- Review Link
Required scopes
Before beginning this guide, you'll need to make sure you have a token that includes the following scopes:
Scope | Reason |
---|---|
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). |
Step 1: gather your IDs
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: https://app.frame.io/projects/<project-id>
.
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: https://app.frame.io/player/<asset-id>
.
Step 2: create the Review Link
To make the base for your link, you'll need to determine your desired Review Link options, and build them into a JSON payload. At the minimum, you'll need to come up with a name
.
Here's an example payload -- for convenience, it shows the defaults for each field, should you choose to generate with a name
only:
{
"name": "New Review Link",
"allow_approvals": true,
"current_version_only": false,
"enable_downloading": true,
"expires_at": null,
"has_password": false
}
Now make an authorized POST
https://api.frame.io/v2/projects/:id/review_links
, using your payload as the request body.
Congratulations! You've just made a Review Link. In the response body, you'll see an id
attribute. Hang onto that, as you'll need it in the next step.
Step 3: add the Assets to the Review Link
Now that you have a Review Link, it's time to add some Assets to it. Start by prepping a JSON payload with a string-array of your Asset id
(s):
{
"asset_ids":[
"<asset-id-1>",
"<asset-id-2>",
"<asset-id-3>"
]
}
Now make an authorized POST
to https://api.frame.io/v2/review_links/:id/assets
, using the Review Link id
from Step 2 in your path, and your Asset id
(s) in the request body.
Ok! You're ready for distribution.
Step 4: construct the URL to distribute
This is the easiest part.
Remember that Review Link id
from Step 2? Add it to the standard URL structure for a Frame.io Review Link, and you're ready for distribution:
https://app.frame.io/reviews/<review-link-id>
For more information on Review Links, please see our Review Links documentation.
Updated about a year ago