> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Frame.io

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List every video in the `Q2 Campaign` project pending review and ping the assigned reviewer.
* Pull the timestamped comments on the latest cut of the brand spot and roll them up in a Notion doc.
* Find assets uploaded in the last 7 days larger than 2GB.

## Available Tools

#### list_accounts

List all Frame.io accounts the authenticated user has access to. Returns account IDs needed for other operations.

#### list_account_users

List users in a Frame.io account with their roles. Use to find team members and their permissions.

#### list_comments

List comments on a file. Includes timecoded video comments with timestamp positions. Supports pagination.

#### create_comment

Add a comment to a file. Set timestamp (frame number) to anchor the comment on the video timeline.

#### get_comment

Get details of a specific comment by ID.

#### update_comment

Update a comment's text or completion status.

#### delete_comment

Delete a comment permanently.

#### list_files

List files in a folder. Use list_projects to find root folder IDs, then list_folders to navigate. Supports pagination.

#### get_file

Get details of a specific file by ID, including download URLs (temporary, expire within 24h).

#### update_file

Update a file's name or properties.

#### delete_file

Delete a file permanently.

#### import_file

Import a file into a folder from a publicly accessible URL. The file is downloaded by Frame.io asynchronously; status...

#### copy_file

Copy a file to a different folder.

#### move_file

Move a file to a different folder.

#### list_folders

List subfolders in a folder. Use list_projects to find root folder IDs, then browse deeper with this tool. Supports...

#### create_folder

Create a new folder inside a parent folder.

#### get_folder

Get details of a specific folder by ID.

#### update_folder

Update a folder's name.

#### delete_folder

Delete a folder and all its contents permanently.

#### list_folder_children

List all children (files, folders, version stacks) in a folder. Returns mixed types. Use list_files or list_folders for...

#### copy_folder

Copy a folder and its contents to a destination folder.

#### move_folder

Move a folder to a different parent folder.

#### get_file_metadata

Get custom metadata values for a file. Use list_metadata_fields to see available field definitions.

#### list_metadata_fields

List custom metadata field definitions for an account. Shows available fields that can be set on files.

#### update_metadata_values

Apply metadata field values to one or more files in a project. The same set of values is applied to every listed file...

#### list_projects

List projects in a workspace. Returns project IDs and root_folder_id needed to browse files. Use list_workspaces to...

#### create_project

Create a new project in a workspace. Use list_workspaces to find workspace IDs.

#### get_project

Get details of a specific project by ID, including its root_folder_id for browsing files.

#### update_project

Update a project's name or settings.

#### delete_project

Delete a project permanently. This removes all files and folders within it.

#### list_shares

List share links for a project. Share links allow external reviewers to view and comment on files.

#### create_share

Create a share link for a project. Optionally set expiration, password, and download permissions. Add assets with...

#### get_share

Get details of a specific share link by ID, including its public URL.

#### update_share

Update a share link's name, expiration, password, or download settings.

#### delete_share

Delete a share link permanently. External reviewers will lose access.

#### add_asset_to_share

Add a file or folder to an existing share link so reviewers can see it.

#### remove_asset_from_share

Remove a file or folder from a share link.

#### get_current_user

Get the currently authenticated user's profile including name, email, and avatar URL.

#### list_version_stacks

List version stacks in a folder. Version stacks group multiple versions of a file together.

#### create_version_stack

Create a version stack from a list of file IDs. Groups file versions together for comparison and review.

#### get_version_stack

Get details of a specific version stack by ID.

#### list_version_stack_children

List file versions within a version stack. Returns individual file versions ordered by version number.

#### list_workspaces

List workspaces in a Frame.io account. Workspaces contain projects. Use cursor from page_info for pagination.

#### create_workspace

Create a new workspace in a Frame.io account. Workspaces organize projects.

#### get_workspace

Get details of a specific workspace by ID.

#### update_workspace

Update a workspace's name or settings.

#### delete_workspace

Delete a workspace permanently. This removes all projects and files within it.