> This page is for 平台, version V4 (default).
> For other versions, use one of these documentation indexes:
> - V4 (default): https://developer.frame.io/platform/v4/llms.txt
> - V4 实验版: https://developer.frame.io/platform/v4-experimental/llms.txt
> - 旧版: https://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://developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.frame.io/_mcp/server.

# Changelog

## October 4, 2026

### Added

* `GET` [List recently deleted assets](/platform/v4/api-reference/projects/recently-deleted) — sortable by deleted_at_asc, deleted_at_desc, ..., paginated
  *List all recently deleted assets (files, folders, and version stacks) in a project*

## September 13, 2026

### Modified

* `GET` [List webhooks](/platform/v4/api-reference/webhooks/index)
  * Added parameter: `sort`

## August 30, 2026

### Added

* `GET` [List share activity](/platform/v4/api-reference/shares/list-activities) — paginated
  *List all activity events for a share*

* `GET` [List share assets](/platform/v4/api-reference/shares/list-assets) — sortable by name_asc, created_at_asc, ..., supports include: media_links.original, media_links.thumbnail, media_links.thumbnail_high_quality, media_links.video_h264_180, media_links.high_quality, media_links.efficient, media_links.scrub_sheet, creator, project, metadata, paginated
  *List the assets included in a share as a recursively flat list*

* `POST` [Copy files](/platform/v4/api-reference/files/bulk-copy) — filters: copy_metadata, copy_comments
  *Copy a set of files to a single destination folder*

* `POST` [Copy folders](/platform/v4/api-reference/folders/bulk-copy) — filters: copy_metadata, copy_comments
  *Copy a set of folders to a single destination folder*

* `PATCH` [Move files](/platform/v4/api-reference/files/bulk-move)
  *Move a set of files to a single destination folder*

* `PATCH` [Move folders](/platform/v4/api-reference/folders/bulk-move)
  *Move a set of folders to a single destination folder*

* `PATCH` [Update user role for the account](/platform/v4/api-reference/account-user-roles/update)
  *Update user role for the account*

### Modified

* `GET` [List folder children](/platform/v4/api-reference/folders/index)
  * Added parameter: `sort`

* `GET` [List folders](/platform/v4/api-reference/folders/list)
  * Added parameter: `sort`

* `GET` [List version stack children](/platform/v4/api-reference/version-stacks/index)
  * Added parameter: `sort`

* `GET` [List version stacks](/platform/v4/api-reference/version-stacks/list)
  * Added parameter: `sort`

## June 14, 2026

### 添加内容

* `GET` [列出已邀请项目](/platform/v4/api-reference/invited-projects/index) — 按 name_asc、created_at_asc 等排序，支持包括：owner；分页显示

*列出当前用户在指定帐户内受邀参与但没有工作区级别权限的项目…*

* `GET` [按帐户列出项目](/platform/v4/api-reference/account-projects/index) — 可按 name_asc、created_at_asc ... 等排序，支持包括：owner；分页显示

*列出已验证用户在指定帐户内具有访问权限的所有项目*

## May 24, 2026

### 添加内容

* `POST` [搜索帐户](/platform/v4/api-reference/search/search) — 分页显示

*搜索帐户内的资产、文件夹和项目*

## May 17, 2026

### 添加内容

* `GET` [列出收藏集](/platform/v4/api-reference/collections/index) — 分页显示

*列出项目的收藏集*

* `GET` [列出文件夹用户角色](/platform/v4/api-reference/folder-user-roles/index) — 筛选条件：include_deactivated；分页显示

*列出给定文件夹的用户角色*

* `GET` [显示收藏集](/platform/v4/api-reference/collections/show)

*显示收藏集详细信息*

* `PATCH` [更新给定文件夹的用户角色](/platform/v4/api-reference/folder-user-roles/update)

*如果用户已添加到文件夹，则更新给定文件夹的用户角色*

* `DELETE` [从给定文件夹中移除用户](/platform/v4/api-reference/folder-permissions/delete)

*从给定文件夹中移除用户*

### 修改内容

* `GET` [列出帐户](/platform/v4/api-reference/accounts/index)

- 已添加参数：`sort`

## May 10, 2026

### 修改内容

* `GET` [列出帐户级字段定义](/platform/v4/api-reference/metadata/field-definitions.index)

- 已添加参数：`sort`

* `GET` [列出帐户用户角色](/platform/v4/api-reference/account-user-roles/index)

- 已添加参数：`sort`

* `GET` [列出项目用户角色](/platform/v4/api-reference/project-user-roles/index)

- 已添加参数：`sort`

* `GET` [列出项目](/platform/v4/api-reference/projects/index)

- 已添加参数：`sort`

* `GET` [列出共享审阅者](/platform/v4/api-reference/shares/list-reviewers)

- 已添加参数：`sort`

* `GET` [列出共享](/platform/v4/api-reference/shares/index)

- 已添加参数：`sort`

* `GET` [列出工作区用户角色](/platform/v4/api-reference/workspace-user-roles/index)

- 已添加参数：`sort`

* `GET` [列出工作区](/platform/v4/api-reference/workspaces/index)

- 已添加参数：`sort`

## May 3, 2026

### 添加内容

* `GET` [列出操作](/platform/v4/api-reference/custom-actions/actions-index) — 支持包括：creator；分页显示

*列出给定工作区中的操作*

* `GET` [显示自定义操作详细信息](/platform/v4/api-reference/custom-actions/actions-show) — 支持包含：creator

*显示自定义操作详细信息*

## April 26, 2026

### 添加内容

* `GET` [列出组](/platform/v4/api-reference/groups/index) — 支持按 creator_asc、creator_desc 等排序，支持包括：creator；分页显示

*列出帐户中的组*

* `POST` [创建组](/platform/v4/api-reference/groups/create)

*为当前帐户创建组*

## March 22, 2026

### 添加内容

* `POST` [创建评论附件](/platform/v4/api-reference/comments/create-attachment)

*为现有评论创建附件*

* `DELETE` [删除评论附件](/platform/v4/api-reference/comments/delete-attachment)

*删除评论中的附件*

### 修改内容

* `GET` [列出评论](/platform/v4/api-reference/comments/index)

- 已添加参数：`sort`

## February 22, 2026

### 添加内容

* `POST` [导入文件](/platform/v4/api-reference/files/import-file)

*从帐户上配置的存储位置导入文件*

## January 25, 2026

### 添加内容

* `GET` [列出审核日志](/platform/v4/api-reference/auditlog/index) — 支持包括：user；filters: filters，paginated

*通过查询参数提供筛选功能，列出审核日志*

### 修改内容

* `GET` [列出文件](/platform/v4/api-reference/files/list)

- 已添加参数：`sort`

## January 18, 2026

### 修改内容

* `GET` [列出帐户级字段定义](/platform/v4/api-reference/metadata/field-definitions.index)

- 已添加响应：`409 Conflict`

* `GET` [列出帐户用户角色](/platform/v4/api-reference/account-user-roles/index)

- 已添加响应：`409 Conflict`

* `GET` [列出帐户](/platform/v4/api-reference/accounts/index)

- 已添加响应：`409 Conflict`

* `GET` [列出评论](/platform/v4/api-reference/comments/index)

- 已添加响应：`409 Conflict`

* `GET` [列出文件](/platform/v4/api-reference/files/list)

- 已添加响应：`409 Conflict`

* `GET` [列出文件夹次项](/platform/v4/api-reference/folders/index)

- 已添加响应：`409 Conflict`

* `GET` [列出文件夹](/platform/v4/api-reference/folders/list)

- 已添加响应：`409 Conflict`

* `GET` [列出项目用户角色](/platform/v4/api-reference/project-user-roles/index)

- 已添加响应：`409 Conflict`

* `GET` [列出项目](/platform/v4/api-reference/projects/index)

- 已添加响应：`409 Conflict`

* `GET` [列出共享审阅者](/platform/v4/api-reference/shares/list-reviewers)

- 已添加响应：`409 Conflict`

* `GET` [列出共享](/platform/v4/api-reference/shares/index)

- 已添加响应：`409 Conflict`

* `GET` [列出版本堆栈次项](/platform/v4/api-reference/version-stacks/index)

- 已添加响应：`409 Conflict`

* `GET` [列出版本堆栈](/platform/v4/api-reference/version-stacks/list)

- 已添加响应：`409 Conflict`

* `GET` [列出 Webhook](/platform/v4/api-reference/webhooks/index)

- 已添加响应：`409 Conflict`

* `GET` [列出工作区用户角色](/platform/v4/api-reference/workspace-user-roles/index)

- 已添加响应：`409 Conflict`

* `GET` [列出工作区](/platform/v4/api-reference/workspaces/index)

- 已添加响应：`409 Conflict`

* `GET` [显示评论](/platform/v4/api-reference/comments/show)

- 已添加响应：`409 Conflict`

* `GET` [显示文件](/platform/v4/api-reference/files/show)

- 已添加响应：`409 Conflict`

* `GET` [显示文件上传状态](/platform/v4/api-reference/files/show-file-upload-status)

- 已添加响应：`409 Conflict`

* `GET` [显示文件夹](/platform/v4/api-reference/folders/show)

- 已添加响应：`409 Conflict`

* `GET` [显示元数据](/platform/v4/api-reference/metadata/show)

- 已添加响应：`409 Conflict`

* `GET` [显示项目](/platform/v4/api-reference/projects/show)

- 已添加响应：`409 Conflict`

* `GET` [显示共享项](/platform/v4/api-reference/shares/show)

- 已添加响应：`409 Conflict`

* `GET` [显示版本堆栈](/platform/v4/api-reference/version-stacks/show)

- 已添加响应：`409 Conflict`

* `GET` [显示 Webhook](/platform/v4/api-reference/webhooks/show)

- 已添加响应：`409 Conflict`

* `GET` [显示 Workspace](/platform/v4/api-reference/workspaces/show)

- 已添加响应：`409 Conflict`

* `GET` [用户详细信息](/platform/v4/api-reference/users/show)

- 已添加响应：`409 Conflict`

* `POST` [将新资产添加到共享项](/platform/v4/api-reference/shares/add-asset)

- 已添加响应：`409 Conflict`

* `POST` [为安全共享项添加审阅者](/platform/v4/api-reference/shares/add-reviewers)

- 已添加响应：`409 Conflict`

* `POST` [复制文件](/platform/v4/api-reference/files/copy)

- 已添加响应：`409 Conflict`

* `POST` [复制文件夹](/platform/v4/api-reference/folders/copy)

- 已添加响应：`409 Conflict`

* `POST` [复制版本堆栈](/platform/v4/api-reference/version-stacks/copy)

- 已添加响应：`409 Conflict`

* `POST` [创建帐户级字段定义](/platform/v4/api-reference/metadata/field-definitions.create)

- 已添加响应：`409 Conflict`

* `POST` [创建评论](/platform/v4/api-reference/comments/create)

- 已添加响应：`409 Conflict`

* `POST` [创建文件](/platform/v4/api-reference/files/create)

- 已添加响应：`409 Conflict`

* `POST` [创建文件（本地上传）](/platform/v4/api-reference/files/create-local-upload)

- 已添加响应：`409 Conflict`

* `POST` [创建文件（远程上传）](/platform/v4/api-reference/files/create-remote-upload)

- 已添加响应：`409 Conflict`

* `POST` [创建文件夹](/platform/v4/api-reference/folders/create)

- 已添加响应：`409 Conflict`

* `POST` [创建项目](/platform/v4/api-reference/projects/create)

- 已添加响应：`409 Conflict`

* `POST` [创建共享项](/platform/v4/api-reference/shares/create)

- 已添加响应：`409 Conflict`

* `POST` [创建版本堆栈](/platform/v4/api-reference/version-stacks/create)

- 已添加响应：`409 Conflict`

* `POST` [创建 Webhook](/platform/v4/api-reference/webhooks/create)

- 已添加响应：`409 Conflict`

* `POST` [创建工作区](/platform/v4/api-reference/workspaces/create)

- 已添加响应：`409 Conflict`

* `PATCH` [移动文件](/platform/v4/api-reference/files/move)

- 已添加响应：`409 Conflict`

* `PATCH` [移动文件夹](/platform/v4/api-reference/folders/move)

- 已添加响应：`409 Conflict`

* `PATCH` [移动版本堆栈](/platform/v4/api-reference/version-stacks/move)

- 已添加响应：`409 Conflict`

* `PATCH` [更新帐户级自定义字段定义](/platform/v4/api-reference/metadata/field-definitions.update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新评论](/platform/v4/api-reference/comments/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新文件](/platform/v4/api-reference/files/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新文件夹](/platform/v4/api-reference/folders/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新多个文件的元数据](/platform/v4/api-reference/metadata/bulk-update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新项目](/platform/v4/api-reference/projects/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新共享项](/platform/v4/api-reference/shares/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新给定项目的用户角色](/platform/v4/api-reference/project-user-roles/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新给定工作区的用户角色](/platform/v4/api-reference/workspace-user-roles/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新 Webhook](/platform/v4/api-reference/webhooks/update)

- 已添加响应：`409 Conflict`

* `PATCH` [更新工作区](/platform/v4/api-reference/workspaces/update)

- 已添加响应：`409 Conflict`

* `DELETE` [删除帐户级自定义字段定义](/platform/v4/api-reference/metadata/field-definitions.delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除评论](/platform/v4/api-reference/comments/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除文件](/platform/v4/api-reference/files/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除文件夹](/platform/v4/api-reference/folders/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除项目](/platform/v4/api-reference/projects/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除共享](/platform/v4/api-reference/shares/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除 Webhook](/platform/v4/api-reference/webhooks/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [删除工作区](/platform/v4/api-reference/workspaces/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [从给定项目中移除用户](/platform/v4/api-reference/project-permissions/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [从给定工作区中移除用户](/platform/v4/api-reference/workspace-user-roles/delete)

- 已添加响应：`409 Conflict`

* `DELETE` [从共享项中移除资产](/platform/v4/api-reference/shares/remove-asset)

- 已添加响应：`409 Conflict`

* `DELETE` [从安全共享项中移除审阅者](/platform/v4/api-reference/shares/remove-reviewers)

- 已添加响应：`409 Conflict`

## January 11, 2026

### 修改内容

* `POST` [复制文件](/platform/v4/api-reference/files/copy)

- 已添加参数：`copy_comments`

## December 14, 2025

### 修改内容

* `GET` [列出帐户](/platform/v4/api-reference/accounts/index)

- 已移除参数：`sort`

* `GET` [列出文件](/platform/v4/api-reference/files/list)

- 已移除参数：`sort`

* `GET` [列出文件夹](/platform/v4/api-reference/folders/list)

- 已移除参数：`sort`

* `GET` [列出项目](/platform/v4/api-reference/projects/index)

- 已移除参数：`sort`

* `GET` [列出共享](/platform/v4/api-reference/shares/index)

- 已移除参数：`sort`

* `GET` [列出版本堆栈次项](/platform/v4/api-reference/version-stacks/index)

- 已移除参数：`sort`

* `GET` [列出版本堆栈](/platform/v4/api-reference/version-stacks/list)

- 已移除参数：`sort`

* `GET` [列出工作区](/platform/v4/api-reference/workspaces/index)

- 已移除参数：`sort`

## November 30, 2025

### 添加内容

* `GET` [显示版本堆栈](/platform/v4/api-reference/version-stacks/show) — 支持包括：media_links、media_links.original、media_links.thumbnail、media_links.video_h264_180、media_links.high_quality、media_links.efficient、creator、project、metadata

*显示版本堆栈详细信息*

### 修改内容

* `GET` [列出项目](/platform/v4/api-reference/projects/index)

- 已添加参数：`sort`

* `GET` [列出共享](/platform/v4/api-reference/shares/index)

- 已添加参数：`sort`

* `GET` [列出版本堆栈次项](/platform/v4/api-reference/version-stacks/index)

- 已添加参数：`sort`

* `GET` [列出工作区](/platform/v4/api-reference/workspaces/index)

- 已添加参数：`sort`

## November 23, 2025

### 修改内容

* `GET` [列出帐户](/platform/v4/api-reference/accounts/index)

- 已添加参数：`sort`

* `GET` [列出评论](/platform/v4/api-reference/comments/index)

- 已添加参数：`timestamp_as_timecode`

* `GET` [列出文件](/platform/v4/api-reference/files/list)

- 已添加参数：`sort`

* `GET` [列出文件夹](/platform/v4/api-reference/folders/list)

- 已添加参数：`sort`

* `GET` [列出版本堆栈](/platform/v4/api-reference/version-stacks/list)

- 已添加参数：`sort`

* `GET` [显示评论](/platform/v4/api-reference/comments/show)

- 已添加参数：`timestamp_as_timecode`

* `POST` [复制文件](/platform/v4/api-reference/files/copy)

- 已添加参数：`copy_metadata`

* `POST` [复制文件夹](/platform/v4/api-reference/folders/copy)

- 已添加参数：`copy_metadata`

* `POST` [复制版本堆栈](/platform/v4/api-reference/version-stacks/copy)

- 已添加参数：`copy_metadata`

* `POST` [创建评论](/platform/v4/api-reference/comments/create)

- 已添加参数：`timestamp_as_timecode`

* `PATCH` [更新评论](/platform/v4/api-reference/comments/update)

- 已添加参数：`timestamp_as_timecode`

## October 26, 2025

### 修改内容

* `POST` [复制文件夹](/platform/v4/api-reference/folders/copy)

- 已添加响应：`202 Accepted`