> 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.

# Guia de migração da API V3 → V4 do Frame.io





O guia a seguir ajuda na migração da API V3 do Frame.io (às vezes chamada de ponto de acesso "legado" ou "v2" na documentação) para a API V4 do Adobe Frame.io.Isso reflete o estilo e a estrutura do exemplo de migração da API do Dropbox, oferecendo uma visão abrangente dos mapeamentos de pontos de acesso, alterações de conteúdo, atualizações de autenticação e muito mais.



---

---


## Pontos de acesso: mapeamento V3 → V4





A seguir, uma comparação lado a lado dos principais pontos de acesso V3 do Frame.io (à esquerda) e seus equivalentes V4 (à direita).Esta seção é inspirada na tabela "mapeamento v1 → v2" do Dropbox.



<blockquote>**Dica:** esta tabela foca nas operações típicas de arquivo, pasta e projeto.Pontos de acesso especializados (por exemplo, Camera to Cloud) são omitidos.</blockquote>



### OAuth e autenticação




| **V3** | **V4** |
| --- | --- |
| Token do desenvolvedor (Bearer `<token></token>`) ou Frame.io OAuth 2.0 com `Authorization: Bearer<token></token>` | Adobe IMS OAuth 2.0 (é preciso criar um projeto no Adobe Developer Console) e usar: `Authorization: Bearer<adobe_access_token></adobe_access_token>` |
**Observação:** tokens de desenvolvedor legados não podem ser convertidos automaticamente.É preciso implementar o novo fluxo OAuth do IMS.**Documentação:** [Como obter um token de acesso do Adobe Frame.io](https://developer.adobe.com/frameio/api/current/)

### Operações de pasta e arquivo





#### Criar uma pasta




* **V3 (Criar pasta):**

```http

POST /v2/assets/{parent_asset_id}/children


  

Content-Type: application/json



  

{


    

&quot;name&quot;: &quot;My New Folder&quot;,


    

&quot;type&quot;: &quot;folder&quot;


  

}