> This page is for Platform, version V4 (default). > For other versions, use one of these documentation indexes: > - V4 (default): https://developer.frame.io/platform/v4/llms.txt > - V4 Experimental: https://developer.frame.io/platform/v4-experimental/llms.txt > - Legacy: 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 ### Added * `GET` [List invited projects](/platform/v4/api-reference/invited-projects/index) — sortable by name_asc, created_at_asc, ..., supports include: owner, paginated *List projects that the current user has been invited to within the specified account, but does not have workspace-lev...* * `GET` [List projects by account](/platform/v4/api-reference/account-projects/index) — sortable by name_asc, created_at_asc, ..., supports include: owner, paginated *List all projects the authenticated user has access to within the specified account* ## May 24, 2026 ### Added * `POST` [Search account](/platform/v4/api-reference/search/search) — paginated *Search across assets, folders, and projects within an account* ## May 17, 2026 ### Added * `GET` [List collections](/platform/v4/api-reference/collections/index) — paginated *List collections for a project* * `GET` [List folder user roles](/platform/v4/api-reference/folder-user-roles/index) — filters: include_deactivated, paginated *List user roles for a given folder* * `GET` [Show collection](/platform/v4/api-reference/collections/show) *Show collection details* * `PATCH` [Update user roles for the given folder](/platform/v4/api-reference/folder-user-roles/update) *Update user roles for the given folder if the user is already added to the folder* * `DELETE` [Remove a user from a given folder](/platform/v4/api-reference/folder-permissions/delete) *Remove a user from a given folder* ### Modified * `GET` [List accounts](/platform/v4/api-reference/accounts/index) * Added parameter: `sort` ## May 10, 2026 ### Modified * `GET` [List account level field definitions](/platform/v4/api-reference/metadata/field-definitions.index) * Added parameter: `sort` * `GET` [List account user roles](/platform/v4/api-reference/account-user-roles/index) * Added parameter: `sort` * `GET` [List project user roles](/platform/v4/api-reference/project-user-roles/index) * Added parameter: `sort` * `GET` [List projects](/platform/v4/api-reference/projects/index) * Added parameter: `sort` * `GET` [List share reviewers](/platform/v4/api-reference/shares/list-reviewers) * Added parameter: `sort` * `GET` [List shares](/platform/v4/api-reference/shares/index) * Added parameter: `sort` * `GET` [List workspace user roles](/platform/v4/api-reference/workspace-user-roles/index) * Added parameter: `sort` * `GET` [List workspaces](/platform/v4/api-reference/workspaces/index) * Added parameter: `sort` ## May 3, 2026 ### Added * `GET` [List actions](/platform/v4/api-reference/custom-actions/actions-index) — supports include: creator, paginated *List actions in a given workspace* * `GET` [Show custom action details](/platform/v4/api-reference/custom-actions/actions-show) — supports include: creator *Show custom action details* ## April 26, 2026 ### Added * `GET` [List groups](/platform/v4/api-reference/groups/index) — sortable by creator_asc, creator_desc, ..., supports include: creator, paginated *List groups in account* * `POST` [Create group](/platform/v4/api-reference/groups/create) *Create group for the current account* ## March 22, 2026 ### Added * `POST` [Create comment attachment](/platform/v4/api-reference/comments/create-attachment) *Create an attachment for an existing comment* * `DELETE` [Delete comment attachment](/platform/v4/api-reference/comments/delete-attachment) *Delete an attachment from a comment* ### Modified * `GET` [List comments](/platform/v4/api-reference/comments/index) * Added parameter: `sort` ## February 22, 2026 ### Added * `POST` [Import file](/platform/v4/api-reference/files/import-file) *Import a file from a storage location configured on the account* ## January 25, 2026 ### Added * `GET` [List audit logs](/platform/v4/api-reference/auditlog/index) — supports include: user, filters: filters, paginated *List audit logs with filtering capabilities via query params* ### Modified * `GET` [List files](/platform/v4/api-reference/files/list) * Added parameter: `sort` ## January 18, 2026 ### Modified * `GET` [List account level field definitions](/platform/v4/api-reference/metadata/field-definitions.index) * Added response: `409 Conflict` * `GET` [List account user roles](/platform/v4/api-reference/account-user-roles/index) * Added response: `409 Conflict` * `GET` [List accounts](/platform/v4/api-reference/accounts/index) * Added response: `409 Conflict` * `GET` [List comments](/platform/v4/api-reference/comments/index) * Added response: `409 Conflict` * `GET` [List files](/platform/v4/api-reference/files/list) * Added response: `409 Conflict` * `GET` [List folder children](/platform/v4/api-reference/folders/index) * Added response: `409 Conflict` * `GET` [List folders](/platform/v4/api-reference/folders/list) * Added response: `409 Conflict` * `GET` [List project user roles](/platform/v4/api-reference/project-user-roles/index) * Added response: `409 Conflict` * `GET` [List projects](/platform/v4/api-reference/projects/index) * Added response: `409 Conflict` * `GET` [List share reviewers](/platform/v4/api-reference/shares/list-reviewers) * Added response: `409 Conflict` * `GET` [List shares](/platform/v4/api-reference/shares/index) * Added response: `409 Conflict` * `GET` [List version stack children](/platform/v4/api-reference/version-stacks/index) * Added response: `409 Conflict` * `GET` [List version stacks](/platform/v4/api-reference/version-stacks/list) * Added response: `409 Conflict` * `GET` [List webhooks](/platform/v4/api-reference/webhooks/index) * Added response: `409 Conflict` * `GET` [List workspace user roles](/platform/v4/api-reference/workspace-user-roles/index) * Added response: `409 Conflict` * `GET` [List workspaces](/platform/v4/api-reference/workspaces/index) * Added response: `409 Conflict` * `GET` [Show comment](/platform/v4/api-reference/comments/show) * Added response: `409 Conflict` * `GET` [Show file](/platform/v4/api-reference/files/show) * Added response: `409 Conflict` * `GET` [Show file upload status](/platform/v4/api-reference/files/show-file-upload-status) * Added response: `409 Conflict` * `GET` [Show folder](/platform/v4/api-reference/folders/show) * Added response: `409 Conflict` * `GET` [Show metadata](/platform/v4/api-reference/metadata/show) * Added response: `409 Conflict` * `GET` [Show project](/platform/v4/api-reference/projects/show) * Added response: `409 Conflict` * `GET` [Show Share](/platform/v4/api-reference/shares/show) * Added response: `409 Conflict` * `GET` [Show version stack](/platform/v4/api-reference/version-stacks/show) * Added response: `409 Conflict` * `GET` [Show webhook](/platform/v4/api-reference/webhooks/show) * Added response: `409 Conflict` * `GET` [Show workspace](/platform/v4/api-reference/workspaces/show) * Added response: `409 Conflict` * `GET` [User details](/platform/v4/api-reference/users/show) * Added response: `409 Conflict` * `POST` [Add new asset to share](/platform/v4/api-reference/shares/add-asset) * Added response: `409 Conflict` * `POST` [Add reviewers to secure share](/platform/v4/api-reference/shares/add-reviewers) * Added response: `409 Conflict` * `POST` [Copy file](/platform/v4/api-reference/files/copy) * Added response: `409 Conflict` * `POST` [Copy folder](/platform/v4/api-reference/folders/copy) * Added response: `409 Conflict` * `POST` [Copy version stack](/platform/v4/api-reference/version-stacks/copy) * Added response: `409 Conflict` * `POST` [Create account level field definitions](/platform/v4/api-reference/metadata/field-definitions.create) * Added response: `409 Conflict` * `POST` [Create comment](/platform/v4/api-reference/comments/create) * Added response: `409 Conflict` * `POST` [Create file](/platform/v4/api-reference/files/create) * Added response: `409 Conflict` * `POST` [Create file (local upload)](/platform/v4/api-reference/files/create-local-upload) * Added response: `409 Conflict` * `POST` [Create file (remote upload)](/platform/v4/api-reference/files/create-remote-upload) * Added response: `409 Conflict` * `POST` [Create folder](/platform/v4/api-reference/folders/create) * Added response: `409 Conflict` * `POST` [Create project](/platform/v4/api-reference/projects/create) * Added response: `409 Conflict` * `POST` [Create share](/platform/v4/api-reference/shares/create) * Added response: `409 Conflict` * `POST` [Create version stack](/platform/v4/api-reference/version-stacks/create) * Added response: `409 Conflict` * `POST` [Create webhook](/platform/v4/api-reference/webhooks/create) * Added response: `409 Conflict` * `POST` [Create workspace](/platform/v4/api-reference/workspaces/create) * Added response: `409 Conflict` * `PATCH` [Move file](/platform/v4/api-reference/files/move) * Added response: `409 Conflict` * `PATCH` [Move folder](/platform/v4/api-reference/folders/move) * Added response: `409 Conflict` * `PATCH` [Move version stack](/platform/v4/api-reference/version-stacks/move) * Added response: `409 Conflict` * `PATCH` [Update account level custom field definitions](/platform/v4/api-reference/metadata/field-definitions.update) * Added response: `409 Conflict` * `PATCH` [Update comment](/platform/v4/api-reference/comments/update) * Added response: `409 Conflict` * `PATCH` [Update file](/platform/v4/api-reference/files/update) * Added response: `409 Conflict` * `PATCH` [Update folder](/platform/v4/api-reference/folders/update) * Added response: `409 Conflict` * `PATCH` [Update metadata across multiple files](/platform/v4/api-reference/metadata/bulk-update) * Added response: `409 Conflict` * `PATCH` [Update project](/platform/v4/api-reference/projects/update) * Added response: `409 Conflict` * `PATCH` [Update share](/platform/v4/api-reference/shares/update) * Added response: `409 Conflict` * `PATCH` [Update user roles for the given project](/platform/v4/api-reference/project-user-roles/update) * Added response: `409 Conflict` * `PATCH` [Update user roles for the given workspace](/platform/v4/api-reference/workspace-user-roles/update) * Added response: `409 Conflict` * `PATCH` [Update webhook](/platform/v4/api-reference/webhooks/update) * Added response: `409 Conflict` * `PATCH` [Update workspace](/platform/v4/api-reference/workspaces/update) * Added response: `409 Conflict` * `DELETE` [Delete account level custom field definitions](/platform/v4/api-reference/metadata/field-definitions.delete) * Added response: `409 Conflict` * `DELETE` [Delete comment](/platform/v4/api-reference/comments/delete) * Added response: `409 Conflict` * `DELETE` [Delete file](/platform/v4/api-reference/files/delete) * Added response: `409 Conflict` * `DELETE` [Delete folder](/platform/v4/api-reference/folders/delete) * Added response: `409 Conflict` * `DELETE` [Delete project](/platform/v4/api-reference/projects/delete) * Added response: `409 Conflict` * `DELETE` [Delete share](/platform/v4/api-reference/shares/delete) * Added response: `409 Conflict` * `DELETE` [Delete webhook](/platform/v4/api-reference/webhooks/delete) * Added response: `409 Conflict` * `DELETE` [Delete workspace](/platform/v4/api-reference/workspaces/delete) * Added response: `409 Conflict` * `DELETE` [Remove a user from a given project](/platform/v4/api-reference/project-permissions/delete) * Added response: `409 Conflict` * `DELETE` [Remove a user from a given workspace](/platform/v4/api-reference/workspace-user-roles/delete) * Added response: `409 Conflict` * `DELETE` [Remove asset from share](/platform/v4/api-reference/shares/remove-asset) * Added response: `409 Conflict` * `DELETE` [Removes reviewers from secure share](/platform/v4/api-reference/shares/remove-reviewers) * Added response: `409 Conflict` ## January 11, 2026 ### Modified * `POST` [Copy file](/platform/v4/api-reference/files/copy) * Added parameter: `copy_comments` ## December 14, 2025 ### Modified * `GET` [List accounts](/platform/v4/api-reference/accounts/index) * Removed parameter: `sort` * `GET` [List files](/platform/v4/api-reference/files/list) * Removed parameter: `sort` * `GET` [List folders](/platform/v4/api-reference/folders/list) * Removed parameter: `sort` * `GET` [List projects](/platform/v4/api-reference/projects/index) * Removed parameter: `sort` * `GET` [List shares](/platform/v4/api-reference/shares/index) * Removed parameter: `sort` * `GET` [List version stack children](/platform/v4/api-reference/version-stacks/index) * Removed parameter: `sort` * `GET` [List version stacks](/platform/v4/api-reference/version-stacks/list) * Removed parameter: `sort` * `GET` [List workspaces](/platform/v4/api-reference/workspaces/index) * Removed parameter: `sort` ## November 30, 2025 ### Added * `GET` [Show version stack](/platform/v4/api-reference/version-stacks/show) — supports include: media_links, media_links.original, media_links.thumbnail, media_links.video_h264_180, media_links.high_quality, media_links.efficient, creator, project, metadata *Show version stack details* ### Modified * `GET` [List projects](/platform/v4/api-reference/projects/index) * Added parameter: `sort` * `GET` [List shares](/platform/v4/api-reference/shares/index) * Added parameter: `sort` * `GET` [List version stack children](/platform/v4/api-reference/version-stacks/index) * Added parameter: `sort` * `GET` [List workspaces](/platform/v4/api-reference/workspaces/index) * Added parameter: `sort` ## November 23, 2025 ### Modified * `GET` [List accounts](/platform/v4/api-reference/accounts/index) * Added parameter: `sort` * `GET` [List comments](/platform/v4/api-reference/comments/index) * Added parameter: `timestamp_as_timecode` * `GET` [List files](/platform/v4/api-reference/files/list) * Added parameter: `sort` * `GET` [List folders](/platform/v4/api-reference/folders/list) * Added parameter: `sort` * `GET` [List version stacks](/platform/v4/api-reference/version-stacks/list) * Added parameter: `sort` * `GET` [Show comment](/platform/v4/api-reference/comments/show) * Added parameter: `timestamp_as_timecode` * `POST` [Copy file](/platform/v4/api-reference/files/copy) * Added parameter: `copy_metadata` * `POST` [Copy folder](/platform/v4/api-reference/folders/copy) * Added parameter: `copy_metadata` * `POST` [Copy version stack](/platform/v4/api-reference/version-stacks/copy) * Added parameter: `copy_metadata` * `POST` [Create comment](/platform/v4/api-reference/comments/create) * Added parameter: `timestamp_as_timecode` * `PATCH` [Update comment](/platform/v4/api-reference/comments/update) * Added parameter: `timestamp_as_timecode` ## October 26, 2025 ### Modified * `POST` [Copy folder](/platform/v4/api-reference/folders/copy) * Added response: `202 Accepted`