> This page is for Plataforma, version Herdado.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 experimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Herdado: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Trabalhar com links de revisão

## Visão geral




Os links de revisão são um recurso principal do Frame.io para coletar ativos e enviá-los para obter feedback por meio de um único URL, sem exigir acesso explícito à equipe ou ao projeto.Fundamentalmente, são uma representação de ativos de um único projeto, então este guia pressupõe que:




1. Você tem ativos em mãos ou está familiarizado com o [upload de ativos via API](/workflows-assets/uploading-assets).
2. Você conhece o ID do projeto no qual deseja criar o link de revisão.
3. Sua meta é obter um URL que possa ser distribuído fora do Frame.io (por exemplo, via email, chat ou outro meio).





### Conceitos principais

Os links de revisão pertencem estritamente aos projetos, e um ativo em um link de revisão é representado como um tipo de recurso especial chamado **Item do link de revisão**, que sempre conterá o `review_link_id` e o `asset_id` que está unindo, bem como o conteúdo completo do ativo associado.

Embora os itens do link de revisão não precisem ser rastreados ou gerenciados por conta própria, são uma estrutura útil para entender o fluxo de trabalho completo capturado neste guia.Consequentemente, a família hierárquica de um link de revisão é assim:





Projeto > Link de revisão > Item do link de revisão > Referência do ativo





### Escopos obrigatórios




Antes de começar este guia, você precisará se certificar de que possui um token que inclua, no mínimo, os seguintes escopos:




| Escopo | Motivo |
| ---------- | ---------- |
| **Projetos:** Leitura | Não é estritamente obrigatório, mas é necessário para obter o `root_asset_id` de um projeto. |
| **Ativos:** Leitura | Não é estritamente obrigatório, mas necessário para navegar para `asset_ids` via API. |
| **Links de revisão:** Criação, leitura e atualização | Criar o link de revisão, adicionar ativos e buscar informações (especialmente se estiver rastreando em outro sistema). |



## 1. Reúna seus IDs




Para criar um link de revisão, você precisará reunir:




1. Um ID do projeto
2. Os IDs de um ou muitos ativos nesse projeto

Se você não tem o ID do projeto em mãos, mas tem acesso ao Frame.io e sabe qual projeto gostaria de usar, você pode ver o ID na barra de endereços ao navegar para o projeto: `https://app.frame.io/projects/<project-id></project-id>`. Da mesma forma, se você não tem os IDs do ativo em mãos, navegue para os ativos que deseja e obtenha os IDs da barra de endereços no navegador: `https://app.frame.io/player/<asset-id></asset-id>`.

## 2. Crie o link de revisão

Para fazer a base do seu link, você precisa determinar as opções desejadas do link de revisão e criá-las em um conteúdo JSON.No mínimo, você precisa criar um `name`.Aqui está um exemplo de conteúdo. Por conveniência, ele mostra os padrões para cada campo, caso você escolha gerar apenas com um `name`:

```json
{    
    "name": "New Review Link",
    "allow_approvals": true,
    "current_version_only": false,
    "enable_downloading": true,
    "expires_at": null,
    "has_password": false
}
```

Agora faça um `POST` autorizado `https://api.frame.io/v2/projects/:id/review_links`, usando seu conteúdo como o corpo da solicitação.

Parabéns!Você acabou de criar um link de revisão.No corpo da resposta, você verá dois atributos importantes:



* **`id`**: esta é a referência para o contêiner do link.Guarde isso, pois você precisará na próxima etapa ao adicionar ativos.
* **`short_url`**: este é o URL do seu link de revisão que você distribuirá.Será algo como `https://f.io/_aBcDeF`




## 3. Adicione os ativos ao link de revisão

Agora que você tem um link de revisão, é hora de adicionar alguns ativos a ele.Comece preparando um conteúdo JSON com uma string-array dos `id`(s) do seu ativo:

```json
{
    "asset_ids":[
        "<asset-id-1>",
        "<asset-id-2>",
        "<asset-id-3>"
    ]
}
```

Agora faça um `POST` autorizado para `https://api.frame.io/v2/review_links/:id/assets`, usando o `id` do link de revisão da Etapa 2 no seu caminho e os `id`s do ativo no corpo da solicitação.Pronto!Agora você está pronto para distribuir seu `short_url`.