send_message
Send Message
Send a message to an individual user or an entire team through the Amara messaging system. Provide either a user or a team as the recipient, not both.
send_message
Send a message to an individual user or an entire team through the Amara messaging system. Provide either a user or a team as the recipient, not both.
list_team_members
List all members of a team with their roles. Results are paginated.
update_video
Update a video's metadata such as title, description, thumbnail, or move it to a different team/project. Only provided fields will be updated.
manage_project
Create, update, or delete a project within a team. Projects organize team videos and can optionally have task workflows enabled.
list_teams
List teams on the Amara platform. Returns paginated team details including visibility settings and policies.
list_videos
Search and list videos on the Amara platform. Filter by team, project, or video URL. Results are paginated and sorted by the specified order.
delete_video
Permanently delete a video and all associated subtitles from the Amara platform. Requires team admin permissions for team videos.
manage_team
Create a new team or update an existing team's settings including name, description, visibility, and membership/video policies. For creation, provide "name" and "slug". For updates, provide "teamSlug" and the fields to change.
list_projects
List all projects within a team. Projects organize videos and may have task workflows enabled.
get_video
Retrieve detailed information about a specific video, including its metadata, URLs, and available subtitle languages.
delete_subtitles
Delete all subtitle versions for a specific language on a video. Only allowed for team videos where the API user is a team admin.
subtitle_actions
List available workflow actions or perform a workflow action on subtitles. Actions include save-draft, publish, approve, reject, etc. Available actions depend on team configuration and current subtitle state.
manage_subtitle_request
Create, update, or delete subtitle requests for collaboration teams. Requests track subtitle work through a multi-stage workflow: subtitling, review, approval, and completion. Assignees and status can be managed.
upload_subtitles
Upload or update subtitles for a video in a specific language. Provide subtitle content inline or via URL in any supported format. Optionally perform a workflow action (save draft, publish, approve, etc.) together with the upload.
team_languages
Set preferred or blacklisted languages for a team. Preferred languages auto-create tasks for new videos. Blacklisted languages disallow subtitle creation.
manage_team_member
Add, update, or remove a team member. Use "add" to invite a user, "update" to change their role, or "remove" to remove them from the team.
list_subtitle_requests
List subtitle requests for a collaboration team. Filter by work status, video, language, project, or assignee. Requests represent subtitle work items tracking through subtitling, review, approval, and completion stages.
get_activity
View activity logs scoped to a video, team, or user. Activity types include video additions/deletions, subtitle version changes, URL changes, team membership changes, and more. Provide exactly one of videoId, teamSlug, or userIdentifier to scope the query.
list_languages
Retrieve the full list of languages supported by the Amara platform, with their BCP-47 codes and names.
list_subtitle_languages
List all subtitle languages available for a video, including their completion status, version count, and assigned reviewer/approver.
manage_application
List, view, approve, or deny membership applications for teams that use application-based membership policies. Provide applicationId to view/update a specific application, or omit it to list all applications.
get_subtitles
Fetch subtitles for a video in a specific language. Returns subtitle content in the requested format (JSON, DFXP, SRT, VTT, SBV, SSA), along with metadata such as version, author, and title.
subtitle_notes
List or add notes on a subtitle set for communication between collaborators during the editing process. Omit "noteBody" to list existing notes, or provide it to add a new note.
get_user
View a user's profile information including their name, biography, video count, languages, and avatar.
create_video
Add a new video to the Amara platform by providing a URL from a supported provider (YouTube, Vimeo) or a direct file link. Optionally associate the video with a team and project.
Manage video subtitles, captions, and translations on the Amara platform. Add and manage videos from YouTube, Vimeo, or direct URLs. Create, upload, download, and edit subtitles in multiple formats (DFXP, SRT, VTT, SSA, SBV) across any supported language. Perform subtitle workflow actions including saving drafts, publishing, approving, and rejecting. Add notes to subtitle sets for collaborator communication. Manage teams with configurable membership policies and role-based access control. Organize videos into projects, handle team membership applications, and configure team language preferences. Track and manage multi-stage subtitle requests with assignees and due dates across collaborating teams. View activity logs for videos, teams, and users. Create and manage user accounts, send messages to users or teams, and retrieve supported languages.
Common questions about connecting Amara to AI agents with Metorial.