# Amara

Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.

- **Category:** video & audio
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 30
- **Triggers:** 0
- **Slug:** `AMARA`
- **Version:** 20260227_00

## Tools

### Add Subtitle Note

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | 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. |
| `video_id` | string | Yes | The unique Amara video identifier. Can be obtained from list videos or view video details actions. |
| `language_code` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Video URL

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The video URL to add (e.g., YouTube, Vimeo, Dailymotion URLs). |
| `primary` | boolean | No | Set to true to mark this URL as the primary URL for the video. |
| `video_id` | string | Yes | The Amara video identifier (e.g., 'GniXaI2Sc5zw'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Subtitle Language

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | Yes | 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). |
| `video_id` | string | Yes | The Amara video ID to add the subtitle language to. Obtain this from list_videos or view_video_details actions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Subtitles

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Optional title or description for this subtitle version. |
| `action` | string | No | Optional action type for the subtitle creation. |
| `metadata` | object | No | Optional metadata object to attach to the subtitles. |
| `video_id` | string | Yes | The Amara video ID to add subtitles to. Obtain this from list_videos or view_video_details actions. |
| `subtitles` | string | No | 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. |
| `sub_format` | string ("json" | "srt" | "dfxp" | "vtt" | "sbv" | "txt" | "ssa") | Yes | The format of the subtitle data being provided. Must match the format of the data in subtitles or at subtitles_url. |
| `description` | string | No | Optional description for this subtitle version. |
| `language_code` | string | Yes | 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. |
| `subtitles_url` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Video

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | string | No | Team slug to assign the video to. The video will belong to this team if specified. |
| `title` | string | Yes | Title of the video. |
| `project` | string | No | Project slug to assign the video to. The video will belong to this project if specified. |
| `duration` | integer | No | Duration of the video in seconds. If not provided, Amara will attempt to detect it automatically. |
| `metadata` | object | No | 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. |
| `thumbnail` | string | No | URL to a custom thumbnail image for the video. If not provided, Amara will use a default or extract one from the video. |
| `video_url` | string | Yes | 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` | string | No | Description about this video. Provides context about the video content. |
| `primary_audio_language_code` | string | No | ISO 639-1 two-letter language code for the main language spoken in the video (e.g., 'en' for English, 'fr' for French). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Video URL

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url_id` | integer | Yes | The internal ID of the video URL resource to delete. |
| `video_id` | string | Yes | The Amara video identifier (e.g., 'GniXaI2Sc5zw'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch Subtitles Data

**Slug:** `AMARA_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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "srt" | "vtt") | No | Subtitle format to retrieve. Defaults to 'json' when omitted. |
| `video_id` | string | Yes | Amara video ID. |
| `language_code` | string | Yes | BCP-47 code for the subtitle language. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Activity

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `activity_id` | integer | Yes | Unique identifier for the activity to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subtitle Language Details

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | Amara video ID. |
| `language_code` | string | Yes | BCP-47 code for the subtitle language. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Team Details

**Slug:** `AMARA_GET_TEAM_DETAILS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | Machine name (slug) of the team to retrieve details for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Team Languages

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | Machine name (slug) of the team to retrieve language preferences for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Activity

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of activity items to return. |
| `offset` | integer | No | Number of activity items to skip for pagination. |
| `identifier` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Data

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Video URL

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url_id` | integer | Yes | URL identifier for the specific video URL to retrieve |
| `video_id` | string | Yes | Amara video identifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Video URL Details

**Slug:** `AMARA_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.).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | A public or embeddable video URL to look up. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Activity

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | string | No | 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. |
| `type` | integer | No | 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. |
| `after` | string | No | Only include activity items after this timestamp (ISO 8601 format). |
| `limit` | integer | No | Maximum number of activity items to return per page. Defaults to 20 if not specified. |
| `video` | string | No | Filter by video ID to show only items related to a given video. Ignored if team parameter is also provided. |
| `before` | string | No | Only include activity items before this timestamp (ISO 8601 format). |
| `offset` | integer | No | Number of activity items to skip before starting to return results. Used for pagination. Defaults to 0. |
| `language` | string | No | Filter by language code (BCP-47) to show only items with a given language code. |
| `team_activity` | boolean | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Available Languages

**Slug:** `AMARA_LIST_AVAILABLE_LANGUAGES`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Subtitle Actions

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | Amara video ID for which to list available subtitle actions. |
| `language_code` | string | Yes | BCP-47 code for the subtitle language (e.g., 'en' for English, 'pt-BR' for Brazilian Portuguese). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Subtitle Languages

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | Amara video ID for which to list subtitle languages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Subtitle Notes

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | The unique Amara video identifier. Can be obtained from list videos or view video details actions. |
| `language_code` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Teams

**Slug:** `AMARA_LIST_TEAMS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of teams to return. |
| `offset` | integer | No | Results offset for pagination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Video Activity

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of activity records to return per page. Defaults to 20 if not specified. |
| `offset` | integer | No | Number of activity records to skip before starting to return results. Used for pagination. Defaults to 0. |
| `video_id` | string | Yes | Amara video identifier to get activity for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Videos

**Slug:** `AMARA_LIST_VIDEOS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sorting order, e.g., '-created' or '-primary_audio_language_code'. |
| `team` | string | No | Filter by team slug. |
| `limit` | integer | No | Maximum number of videos to return per page. Defaults to 20 if not specified. |
| `owner` | string | No | Filter by owner username. |
| `offset` | integer | No | Number of videos to skip before starting to return results. Used for pagination. Defaults to 0. |
| `archive` | boolean | No | If true, only archived videos are returned. |
| `project` | string | No | Filter by project slug. |
| `language` | string | No | Filter by language code (BCP-47), e.g., 'en'. |
| `video_id` | string | No | Comma-separated list of video IDs to filter. |
| `video_url` | string | No | Filter by exact video URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Video URLs

**Slug:** `AMARA_LIST_VIDEO_URLS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of URLs to return. |
| `offset` | integer | No | Index of the first URL to return (0-indexed). |
| `video_id` | string | Yes | Amara video ID for which to list all associated video URLs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Make Video URL Primary

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url_id` | integer | Yes | The internal ID of the video URL resource to mark as primary. |
| `primary` | boolean | Yes | Set to true to mark this URL as the primary URL. |
| `video_id` | string | Yes | The Amara video identifier (e.g., 'NI1hLjBxuTpk'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Perform Subtitle Action

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string | Yes | 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. |
| `video_id` | string | Yes | Amara video ID for which to perform the subtitle action. |
| `language_code` | string | Yes | ISO 639-1 two-letter language code for the subtitle language (e.g., 'en' for English, 'de' for German). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Message

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | string | No | Team slug to send the message to. Either 'user' or 'team' must be provided, but not both. Example: 'my-team-slug'. |
| `user` | string | No | 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'. |
| `content` | string | Yes | Message body text. Required field. Supports multi-line text and Unicode characters. |
| `subject` | string | Yes | Subject line for the message. Required field. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subtitle Language

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | Amara video ID. |
| `language_code` | string | Yes | BCP-47 code for the subtitle language. |
| `soft_limit_cpl` | integer | No | Maximum characters per line; warning shown if exceeded. |
| `soft_limit_cps` | integer | No | Maximum characters per second; warning shown if exceeded. |
| `soft_limit_lines` | integer | No | Maximum number of lines per subtitle; warning shown if exceeded. |
| `subtitles_complete` | boolean | No | Indicates if the subtitles are complete for this language. |
| `soft_limit_max_duration` | integer | No | Maximum subtitle duration in milliseconds; used in guidelines dialog. |
| `soft_limit_min_duration` | integer | No | Minimum subtitle duration in milliseconds; warning shown if violated. |
| `is_primary_audio_language` | boolean | No | Indicates if this is the primary spoken language of the video. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Video

**Slug:** `AMARA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | string | No | Slug of the team the video belongs to |
| `title` | string | No | Video title |
| `project` | string | No | Slug of the project the video belongs to |
| `duration` | integer | No | Video duration in seconds |
| `metadata` | object | No | Metadata key/value pairs for the video |
| `video_id` | string | Yes | Amara video identifier |
| `thumbnail` | string | No | URL to the video thumbnail |
| `description` | string | No | Video description |
| `primary_audio_language_code` | string | No | Language code for the main audio track (BCP-47) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Video Details

**Slug:** `AMARA_VIEW_VIDEO_DETAILS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | Amara video identifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |