> This page is for 플랫폼, version 레거시.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 실험적: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - 레거시: 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.

# Frame.io API V3 → V4 마이그레이션 가이드





다음 가이드는 Frame.io API V3(문서에서 "이전" 또는 "v2" 엔드포인트로 지칭되기도 함)에서 Adobe Frame.io API V4로 마이그레이션하는 데 도움을 줍니다. 이 가이드는 Dropbox API 마이그레이션 예시의 스타일과 구조를 반영하여, 엔드포인트 매핑, 페이로드 변경 사항, 인증 업데이트 등을 포괄적으로 살펴볼 수 있도록 구성되었습니다.



---

---


## 엔드포인트: V3 → V4 매핑





아래는 주요 Frame.io V3 엔드포인트(왼쪽)와 그에 해당하는 V4 엔드포인트(오른쪽)를 나란히 비교한 내용입니다. 이 섹션은 Dropbox의 "v1 → v2 매핑" 표에서 영감을 받았습니다.



<blockquote>**팁:** 이 표는 일반적인 파일, 폴더, 그리고 프로젝트 작업에 초점을 맞추고 있습니다. 특수 엔드포인트(예: Camera to Cloud)는 생략되었습니다.</blockquote>



### OAuth 및 인증




| **V3** | **V4** |
| --- | --- |
| 개발자 토큰(Bearer `<token></token>`) 또는 Frame.io OAuth 2.0 및 `Authorization: Bearer<token></token>` | Adobe IMS OAuth 2.0 (반드시 Adobe Developer Console에서 프로젝트를 생성해야 함) 및 다음 사용: `Authorization: Bearer<adobe_access_token></adobe_access_token>` |
**참고:** 이전 개발자 토큰은 자동으로 변환할 수 없습니다. 반드시 새로운 IMS OAuth 흐름을 구현해야 합니다. **문서:**[Adobe Frame.io 액세스 토큰을 발급받는 방법](https://developer.adobe.com/frameio/api/current/)

### 폴더 및 파일 작업





#### 폴더 생성




* **V3(폴더 생성):**

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


  

}