> This page is for Agent Handler. > 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.