Connect Amara to Your AI Agent

Choose a video and language to read subtitle text, review timing, or upload an explicitly prepared subtitle version.

33 tools API key

Try a Amara Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Amara

Review a Subtitle Track

Read subtitles to flag unclear wording and timing questions without changing the track.

/oo Amara: Read Amara video [video ID] subtitles in [language code] as SRT. Review wording and timing and propose corrections in this conversation.

Compare Subtitle Translations

Read two language tracks and compare their meaning using timing context.

/oo Amara: For Amara video [video ID], compare subtitles in [source language code] and [target language code]. Flag meaning differences with the relevant time ranges.

Upload a Prepared Subtitle Version

Create a new subtitle version from supplied text for an identified language track.

/oo Amara: Create a new SRT subtitle version for Amara video [video ID], language [language code], using this subtitle text [SRT text]. Do not perform a publish or approval action.

Start Working with Amara

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Amara

    Connect your Amara API key.

    Connect Amara →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • An Amara key with access to the video and subtitle language you want to use.
  • Creating a subtitle version needs subtitle content or a subtitle URL, plus its format. Publishing or approval is a separate workflow action.

Amara Tools

The integration reads Amara videos and subtitle tracks, creates subtitle versions, and supports subtitle workflow actions and notes.

Videos and Language Tracks

Find videos, list their subtitle languages, and read subtitle text.

Subtitle Versions and Notes

Create subtitle versions or attach review notes to a video’s language track.

Subtitle Workflow

Read the workflow actions available for a track and explicitly perform a selected action.

33 tools

List Languages

List the languages supported by the Amara API.

amara.list_languages

List Available Languages

List the languages supported by the Amara API.

amara.list_available_languages

List Videos

List Amara videos with optional filters, sorting, and pagination controls.

amara.list_videos

Get Video

Fetch a single Amara video by video ID.

amara.get_video

View Video Details

Fetch a single Amara video by video ID.

amara.view_video_details

Create Video

Create a new Amara video from a source URL and title, with optional metadata.

amara.create_video

Update Video

Update an existing Amara video's metadata, assignment, or language settings.

amara.update_video

List Video Activity

List activity items for a single Amara video with pagination controls.

amara.list_video_activity

List Video Urls

List all source URLs associated with a single Amara video.

amara.list_video_urls

Get Video Url

Fetch a single Amara video URL entry by video ID and URL ID.

amara.get_video_url

Add Video Url

Add a new source URL to an existing Amara video.

amara.add_video_url

Delete Video Url

Delete a source URL from an existing Amara video.

amara.delete_video_url

Make Video Url Primary

Update a video URL entry and mark it as the primary URL when requested.

amara.make_video_url_primary

Get Video Url Details

Look up Amara metadata for a public or embeddable video URL.

amara.get_video_url_details

List Subtitle Languages

List all subtitle language tracks for a single Amara video.

amara.list_subtitle_languages

Create Subtitle Language

Create a new subtitle language track for an Amara video.

amara.create_subtitle_language

Get Subtitle Language Details

Fetch a single subtitle language track for an Amara video.

amara.get_subtitle_language_details

Update Subtitle Language

Update subtitle language settings such as completion flags and soft limits.

amara.update_subtitle_language

Fetch Subtitles Data

Fetch subtitle data for a specific video and language in JSON, SRT, or VTT format.

amara.fetch_subtitles_data

Create Subtitles

Create a new subtitle version for a specific video and language.

amara.create_subtitles

List Subtitle Actions

List the subtitle workflow actions available for a specific video and language.

amara.list_subtitle_actions

Perform Subtitle Action

Perform a subtitle workflow action such as publish, approve, or reject.

amara.perform_subtitle_action

List Subtitle Notes

List all subtitle notes for a specific video and subtitle language.

amara.list_subtitle_notes

Add Subtitle Note

Add a subtitle note for a specific video and subtitle language.

amara.add_subtitle_note

List Activity

List Amara activity items with optional team, video, language, and date filters.

amara.list_activity

Get Activity

Fetch a single Amara activity item by activity ID.

amara.get_activity

Get User

Fetch a single Amara user by username or user ID.

amara.get_user

Get User Data

Fetch a single Amara user by username, `me`, or user ID.

amara.get_user_data

Get User Activity

List activity items for a specific Amara user.

amara.get_user_activity

List Teams

List the Amara teams accessible to the current API key with pagination controls.

amara.list_teams

Get Team Details

Fetch a single Amara team by team slug.

amara.get_team_details

Get Team Languages

Fetch preferred and blacklisted language codes for a single Amara team.

amara.get_team_languages

Send Message

Send a message to an Amara user or team recipient.

amara.send_message

Frequently Asked Questions

How do I find which subtitle languages exist?

Provide the video ID and ask to list its subtitle languages. Use the language code for the track you want to read.

Which formats can I read?

Subtitle retrieval supports JSON, SRT, and VTT. Specify the format suitable for review or use in your AI product.

Does uploading subtitles publish them automatically?

Creating a version and performing workflow actions are separate operations. Ask to inspect available actions before requesting publication or approval.

Connect Amara

About Amara ↗