> This page is for Piattaforma, version Versione precedente.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 sperimentale: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Versione precedente: 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.

# Guida alla migrazione dell'API di Frame.io da V3 a V4





Questa guida ti aiuterà a eseguire la migrazione dall'API V3 di Frame.io (talvolta denominata endpoint "tradizionale" o "v2" nella documentazione) all'API V4 di Adobe Frame.io .Rispecchia lo stile e la struttura dell'esempio di migrazione dell'API Dropbox: fornisce una panoramica completa delle mappature degli endpoint, delle modifiche del payload, degli aggiornamenti dell'autenticazione e altro ancora.



---

---


## Endpoint: mappatura da V3 a V4





Di seguito è riportato un confronto degli endpoint chiave di Frame.io V3 (a sinistra) e dei loro equivalenti V4 (a destra).Questa sezione è ispirata alla tabella "Mappatura v1 → v2" di Dropbox.



<blockquote>**Suggerimento:** questa tabella si concentra sulle tipiche operazioni per file, cartelle e progetti. Gli endpoint speciali (ad esempio Camera to Cloud) sono omessi.</blockquote>



### OAuth e autenticazione




| **V3** | **V4** |
| --- | --- |
| Token sviluppatore (bearer `<token></token>`) o Frame.io OAuth 2.0 con `Authorization: Bearer<token></token>` | Adobe IMS OAuth 2.0 (devi creare un progetto in Adobe Developer Console) e utilizzare: `Authorization: Bearer<adobe_access_token></adobe_access_token>` |
**Nota:** i token sviluppatore tradizionali non possono essere convertiti automaticamente.Devi implementare il nuovo flusso OAuth IMS.**Documentazione:** [Come ottenere un token di accesso Adobe Frame.io](https://developer.adobe.com/frameio/api/current/)

### Operazioni per cartelle e file





#### Crea una cartella




* **V3 (Crea cartella):**

```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;


  

}