Amara

Tools (30)

• Add Subtitle Note

  Adds a note/comment to a specific subtitle language for a video. Notes are used for collaboration and providing feedback on subtitles during the editing process. Requires a valid video ID and language code. Use this tool to document issues, provide suggestions, or communicate with other subtitle editors.

  Inputs: body, video_id, language_code

• Add Video URL

  Tool to add a new URL to a video, allowing association with multiple video providers (YouTube, Vimeo, etc.). Use when you need to add alternative URLs for the same video content on different platforms.

  Inputs: url, primary, video_id

• Create Subtitle Language

  Creates a new subtitle language track for an Amara video. This is the first step before adding or uploading subtitles - you must create the language track before you can add subtitle content. Each video can have multiple subtitle languages, but you cannot create the same language twice for the same video. Use list_subtitle_languages to check existing languages before creating a new one.

  Inputs: language, video_id

• Create Subtitles

  Tool to create new subtitles for a video in a specific language. Accepts subtitle data in multiple formats (SRT, VTT, DFXP, etc.) either as a string or via URL. The subtitle language must already exist for the video - use create_subtitle_language first if needed. Use when you need to add subtitle content to a video.

  Inputs: title, action, metadata, video_id, subtitles, sub_format, description, language_code, subtitles_url

• Create Video

  Tool to add a new video to Amara. Use when you need to create a video entry from a URL. Supports URLs from YouTube, Vimeo, Dailymotion, or direct video file URLs.

  Inputs: team, title, project, duration, metadata, thumbnail, video_url, description, primary_audio_language_code

• Delete Video URL

  Tool to remove a video URL from a video. Use when you need to delete an unwanted or incorrect URL from a video's list of URLs. The video must have at least one other URL remaining.

  Inputs: url_id, video_id

• Fetch Subtitles Data

  Fetch subtitle data for a video in a specific language. Returns a list of subtitle segments with start/end timestamps and text content. Use this after obtaining a video ID (from List Videos) and confirming available language codes (from List Subtitle Languages).

  Inputs: format, video_id, language_code

• Get Activity

  Tool to retrieve detailed information about a specific activity by its ID. Use when you need to fetch metadata for a particular activity event.

  Inputs: activity_id

• Get Subtitle Language Details

  Tool to retrieve details for a single subtitle language. Use when you have video ID and language code and need metadata about that language track.

  Inputs: video_id, language_code

• Get Team Details

  Tool to get details on a specific team by slug. Use when you need metadata for a single team.

  Inputs: slug

• Get Team Languages

  Tool to get language preferences for a specific team by slug. Use when you need to retrieve preferred and blacklisted languages for a team.

  Inputs: slug

• Get User Activity

  Tool to retrieve activity log for a specific user on Amara. Use when you need to view a user's recent actions such as video additions, subtitle edits, or comments. Returns a paginated list of activity items with details about what actions the user performed, on which videos, and in which languages.

  Inputs: limit, offset, identifier

• Get User Data

  Retrieves detailed user profile information from Amara, including username, avatar, biography, languages spoken, and video counts. Use this tool when you need to: - Fetch a user's profile details by their username or user ID - Get information about the authenticated user using 'me' as identifier - Look up user metadata like languages, biography, or avatar - Obtain user resource URIs for further API operations Note: User IDs (with 'id$' prefix) are more reliable than usernames since usernames can be changed by users.

  Inputs: identifier

• Get Video URL

  Tool to get details for a specific video URL. Use when you need to retrieve metadata about a specific URL entry in Amara's system by video_id and url_id.

  Inputs: url_id, video_id

• Get Video URL Details

  Tool to get details for a specific video URL. Use when you have a public or embeddable video URL and need its Amara metadata (ID, title, duration, thumbnails, etc.).

  Inputs: url

• List Activity

  Tool to list activity across Amara. Use when you need to retrieve activity logs with optional filters by team, video, or activity type.

  Inputs: team, type, after, limit, video, before, offset, language, team_activity

• List Available Languages

  Tool to get a list of all supported languages. Use when you need to know available language options from Amara.

• List Subtitle Actions

  Tool to list available actions for subtitles based on current workflow state. Use when you need to determine what operations can be performed on a subtitle (e.g., approve, reject, publish) for a specific video and language.

  Inputs: video_id, language_code

• List Subtitle Languages

  Tool to list all subtitle languages for a video. Use when you have a video ID and need to fetch its available subtitle languages.

  Inputs: video_id

• List Subtitle Notes

  List notes for subtitles in a specific language. Use this to retrieve all notes/comments added to a subtitle language for collaboration and feedback purposes.

  Inputs: limit, offset, video_id, language_code

• List Teams

  Tool to list all teams. Use when you need to retrieve your accessible teams with pagination.

  Inputs: limit, offset

• List Video Activity

  Tool to list activity for a specific video. Use when you need to fetch the activity log or history of actions performed on a video.

  Inputs: limit, offset, video_id

• List Videos

  Tool to list all videos. Use when you need to fetch a paginated list of videos with optional filters.

  Inputs: sort, team, limit, owner, offset, archive, project, language, video_id, video_url

• List Video URLs

  Tool to list all URLs associated with a video. Use when you need to retrieve every URL for embedding or processing.

  Inputs: limit, offset, video_id

• Make Video URL Primary

  Tool to set a video URL as the primary URL. Use when you need to designate one of a video's URLs as primary for embedding and display. Call after listing video URLs to confirm the URL ID.

  Inputs: url_id, primary, video_id

• Perform Subtitle Action

  Tool to perform an action on subtitles such as publish, unpublish, approve, reject, send-back, or endorse. Use when you need to change the workflow state of subtitles for a specific video and language. The available actions depend on the current workflow state and team settings.

  Inputs: action, video_id, language_code

• Send Message

  Sends a message to a user or team member in Amara. Use this tool to send notifications, updates, or communicate with other users or teams on the platform. You must specify either a recipient user (by username or user ID) or a team (by team slug), but not both.

  Inputs: team, user, content, subject

• Update Subtitle Language

  Tool to update a subtitle language for a video. Use after reviewing existing subtitle language settings and needing to adjust completeness flags or soft-limit constraints.

  Inputs: video_id, language_code, soft_limit_cpl, soft_limit_cps, soft_limit_lines, subtitles_complete, soft_limit_max_duration, soft_limit_min_duration, is_primary_audio_language

• Update Video

  Tool to update an existing video's metadata including title, description, team, and project assignment. Use when you need to modify video information after creation.

  Inputs: team, title, project, duration, metadata, video_id, thumbnail, description, primary_audio_language_code

• View Video Details

  Tool to view details of a specific video by ID. Use when you need complete metadata for a given video.

  Inputs: video_id