Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.
Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content. On Nagent, Amara is exposed as a fully-configurable video & audio integration that any agent can call — 30 actions, and API key authentication. No code is required to wire Amara into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Amara to automate the kinds of tasks video & audio teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Amara into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Amara, with input parameters and output schema. Drop these into any step of an agent built in Helix.
AMARA_ADD_SUBTITLE_NOTEAdds 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.
Input parameters
The text content of the note. Supports multi-line text, special characters, and Unicode. Use this to provide feedback, suggestions, or document issues with the subtitles.
The unique Amara video identifier. Can be obtained from list videos or view video details actions.
BCP-47 language code for the subtitle language (e.g., 'en' for English, 'es' for Spanish, 'fr' for French). Must correspond to an existing subtitle language for the video.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_ADD_VIDEO_URLTool 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.
Input parameters
The video URL to add (e.g., YouTube, Vimeo, Dailymotion URLs).
Set to true to mark this URL as the primary URL for the video.
The Amara video identifier (e.g., 'GniXaI2Sc5zw').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_CREATE_SUBTITLE_LANGUAGECreates 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.
Input parameters
ISO 639-1 two-letter language code for the subtitle language (e.g., 'en' for English, 'fr' for French, 'es' for Spanish, 'ja' for Japanese).
The Amara video ID to add the subtitle language to. Obtain this from list_videos or view_video_details actions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_CREATE_SUBTITLESTool 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.
Input parameters
Optional title or description for this subtitle version.
Optional action type for the subtitle creation.
Optional metadata object to attach to the subtitles.
The Amara video ID to add subtitles to. Obtain this from list_videos or view_video_details actions.
Subtitle content as a string in the format specified by sub_format. For SRT format, use the standard format with numbering, timestamps, and text. Provide either this field or subtitles_url, but not both.
The format of the subtitle data being provided. Must match the format of the data in subtitles or at subtitles_url.
Optional description for this subtitle version.
ISO 639-1 two-letter language code for the subtitle language (e.g., 'en' for English, 'de' for German, 'fr' for French). The language must already exist for this video - use create_subtitle_language first if needed.
URL to a subtitle file to import. Provide either this field or subtitles, but not both. The file at the URL must be accessible and in the format specified by sub_format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_CREATE_VIDEOTool 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.
Input parameters
Team slug to assign the video to. The video will belong to this team if specified.
Title of the video.
Project slug to assign the video to. The video will belong to this project if specified.
Duration of the video in seconds. If not provided, Amara will attempt to detect it automatically.
Dictionary of additional metadata key-value pairs (e.g., 'speaker-name', 'location'). Use this to store custom information about the video. All keys and values must be strings.
URL to a custom thumbnail image for the video. If not provided, Amara will use a default or extract one from the video.
The URL for the video. Supports YouTube, Vimeo, Dailymotion URLs, or direct video file URLs (e.g., 'https://vimeo.com/123456789' or 'https://example.com/video.mp4').
Description about this video. Provides context about the video content.
ISO 639-1 two-letter language code for the main language spoken in the video (e.g., 'en' for English, 'fr' for French).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_DELETE_VIDEO_URLTool 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.
Input parameters
The internal ID of the video URL resource to delete.
The Amara video identifier (e.g., 'GniXaI2Sc5zw').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_FETCH_SUBTITLES_DATAFetch 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).
Input parameters
Subtitle format to retrieve. Defaults to 'json' when omitted.
Amara video ID.
BCP-47 code for the subtitle language.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_ACTIVITYTool to retrieve detailed information about a specific activity by its ID. Use when you need to fetch metadata for a particular activity event.
Input parameters
Unique identifier for the activity to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_SUBTITLE_LANGUAGE_DETAILSTool to retrieve details for a single subtitle language. Use when you have video ID and language code and need metadata about that language track.
Input parameters
Amara video ID.
BCP-47 code for the subtitle language.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_TEAM_DETAILSTool to get details on a specific team by slug. Use when you need metadata for a single team.
Input parameters
Machine name (slug) of the team to retrieve details for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_TEAM_LANGUAGESTool to get language preferences for a specific team by slug. Use when you need to retrieve preferred and blacklisted languages for a team.
Input parameters
Machine name (slug) of the team to retrieve language preferences for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_USER_ACTIVITYTool 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.
Input parameters
Maximum number of activity items to return.
Number of activity items to skip for pagination.
User identifier - can be a username (e.g., 'Composio'), 'me' for authenticated user, or user ID with 'id$' prefix (e.g., 'id$abc123'). Note: User IDs are more reliable than usernames since usernames can change.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_USER_DATARetrieves 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.
Input parameters
User identifier - can be a username (e.g., 'bendk'), 'me' for authenticated user, or user ID with 'id$' prefix (e.g., 'id$abc123'). Note: User IDs are more reliable than usernames since usernames can change.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_VIDEO_URLTool 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.
Input parameters
URL identifier for the specific video URL to retrieve
Amara video identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_GET_VIDEO_URL_DETAILSTool 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.).
Input parameters
A public or embeddable video URL to look up.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_ACTIVITYTool to list activity across Amara. Use when you need to retrieve activity logs with optional filters by team, video, or activity type.
Input parameters
Filter by team slug to show only items related to a given team. If both team and video are provided, team takes precedence and video is ignored.
Filter by activity type. Valid values are 1-15 corresponding to different actions: 1=Add video, 2=Change title, 3=Comment, 4=Add version, 5=Add video URL, 6=Add translation, 7=Subtitle request, 8=Approve version, 9=Member joined, 10=Reject version, 11=Member left, 12=Review version, 13=Accept version, 14=Decline version, 15=Delete video.
Only include activity items after this timestamp (ISO 8601 format).
Maximum number of activity items to return per page. Defaults to 20 if not specified.
Filter by video ID to show only items related to a given video. Ignored if team parameter is also provided.
Only include activity items before this timestamp (ISO 8601 format).
Number of activity items to skip before starting to return results. Used for pagination. Defaults to 0.
Filter by language code (BCP-47) to show only items with a given language code.
If team is given, normally returns activity on the team's videos. Set to true to see activity for the team itself (members joining/leaving and team video deletions). Only applies when team parameter is provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_AVAILABLE_LANGUAGESTool to get a list of all supported languages. Use when you need to know available language options from Amara.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_SUBTITLE_ACTIONSTool 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.
Input parameters
Amara video ID for which to list available subtitle actions.
BCP-47 code for the subtitle language (e.g., 'en' for English, 'pt-BR' for Brazilian Portuguese).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_SUBTITLE_LANGUAGESTool to list all subtitle languages for a video. Use when you have a video ID and need to fetch its available subtitle languages.
Input parameters
Amara video ID for which to list subtitle languages.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_SUBTITLE_NOTESList notes for subtitles in a specific language. Use this to retrieve all notes/comments added to a subtitle language for collaboration and feedback purposes.
Input parameters
Maximum number of notes to return per page. Defaults to 20 if not specified.
Number of notes to skip before starting to return results. Used for pagination. Defaults to 0.
The unique Amara video identifier. Can be obtained from list videos or view video details actions.
BCP-47 language code for the subtitle language (e.g., 'en' for English, 'es' for Spanish, 'fr' for French). Must correspond to an existing subtitle language for the video.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_TEAMSTool to list all teams. Use when you need to retrieve your accessible teams with pagination.
Input parameters
Maximum number of teams to return.
Results offset for pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_VIDEO_ACTIVITYTool to list activity for a specific video. Use when you need to fetch the activity log or history of actions performed on a video.
Input parameters
Maximum number of activity records to return per page. Defaults to 20 if not specified.
Number of activity records to skip before starting to return results. Used for pagination. Defaults to 0.
Amara video identifier to get activity for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_VIDEOSTool to list all videos. Use when you need to fetch a paginated list of videos with optional filters.
Input parameters
Sorting order, e.g., '-created' or '-primary_audio_language_code'.
Filter by team slug.
Maximum number of videos to return per page. Defaults to 20 if not specified.
Filter by owner username.
Number of videos to skip before starting to return results. Used for pagination. Defaults to 0.
If true, only archived videos are returned.
Filter by project slug.
Filter by language code (BCP-47), e.g., 'en'.
Comma-separated list of video IDs to filter.
Filter by exact video URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_LIST_VIDEO_URLSTool to list all URLs associated with a video. Use when you need to retrieve every URL for embedding or processing.
Input parameters
Maximum number of URLs to return.
Index of the first URL to return (0-indexed).
Amara video ID for which to list all associated video URLs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_MAKE_VIDEO_URL_PRIMARYTool 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.
Input parameters
The internal ID of the video URL resource to mark as primary.
Set to true to mark this URL as the primary URL.
The Amara video identifier (e.g., 'NI1hLjBxuTpk').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_PERFORM_SUBTITLE_ACTIONTool 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.
Input parameters
Action to perform on the subtitles. Common actions include 'publish' (make subtitles public), 'unpublish' (make subtitles private), 'approve' (approve subtitles in workflow), 'reject' (reject subtitles), 'send-back' (send back for revision), 'endorse' (endorse and move to next stage), 'save-draft' (save as draft). The available actions depend on the video's workflow state and team settings. Use list_subtitle_actions to discover available actions for a specific video and language.
Amara video ID for which to perform the subtitle action.
ISO 639-1 two-letter language code for the subtitle language (e.g., 'en' for English, 'de' for German).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_SEND_MESSAGESends 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.
Input parameters
Team slug to send the message to. Either 'user' or 'team' must be provided, but not both. Example: 'my-team-slug'.
Username or user ID (with 'id$' prefix) to send the message to. Either 'user' or 'team' must be provided, but not both. Example: 'bendk' or 'id$abc123'.
Message body text. Required field. Supports multi-line text and Unicode characters.
Subject line for the message. Required field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_UPDATE_SUBTITLE_LANGUAGETool 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.
Input parameters
Amara video ID.
BCP-47 code for the subtitle language.
Maximum characters per line; warning shown if exceeded.
Maximum characters per second; warning shown if exceeded.
Maximum number of lines per subtitle; warning shown if exceeded.
Indicates if the subtitles are complete for this language.
Maximum subtitle duration in milliseconds; used in guidelines dialog.
Minimum subtitle duration in milliseconds; warning shown if violated.
Indicates if this is the primary spoken language of the video.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_UPDATE_VIDEOTool to update an existing video's metadata including title, description, team, and project assignment. Use when you need to modify video information after creation.
Input parameters
Slug of the team the video belongs to
Video title
Slug of the project the video belongs to
Video duration in seconds
Metadata key/value pairs for the video
Amara video identifier
URL to the video thumbnail
Video description
Language code for the main audio track (BCP-47)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AMARA_VIEW_VIDEO_DETAILSTool to view details of a specific video by ID. Use when you need complete metadata for a given video.
Input parameters
Amara video identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 74 agents privately built on Nagent that already use Amara.
Build on Nagent
Connect Amara to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Amara, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Amara is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Amara is connected, you configure its 30 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Amara steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Amara event fires, the agent kicks off automatically.
Every Amara action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Amara ships with 30 pre-built video & audio actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Amara together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Amara-based workflows tailored to your business.