> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Amara

The Amara connector lets your AI agent act in each user's Amara account. Each user connects their own Amara API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 42 tools.

**Authentication:** API Key
**Categories:** Media, Transcription
**Tools:** 42: 23 read, 14 write, 5 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=AMARA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Amara connection

   In **AgentKit > Connections**, create an Amara connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'amara'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Amara:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'amara_supported_languages_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "amara"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Amara:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="amara_supported_languages_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Amara credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'amara_language_get',
  toolInput: {
    language_code: '<language_code>',
    video_id: '<video_id>',
  },
  connector: 'amara',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="amara_language_get",
    tool_input={
        "language_code": "<language_code>",
        "video_id": "<video_id>",
    },
    connection_name="amara",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `amara_language_get`

Get Subtitle Language · Read-only

Get one subtitle language of a video with its versions and completion state.
Get the video ID from amara_videos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_languages_list`

List Subtitle Languages · Read-only

List the subtitle languages of a video with completion, publish state, versions and limits.
Get the video ID from amara_videos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{"video_id":"<video_id>"}`

### `amara_project_get`

Get Project · Read-only

Get one team project with its guidelines.
Get the project slug from amara_projects_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_slug` (`string`, required): Project Slug. Example: season-1
- `team_slug` (`string`, required): Team Slug. Example: my-team

Example input: `{"project_slug":"<project_slug>","team_slug":"<team_slug>"}`

### `amara_projects_list`

List Projects · Read-only

List a team's projects.
Get the team slug from amara_teams_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{"team_slug":"<team_slug>"}`

### `amara_subtitle_actions_list`

List Subtitle Actions · Read-only

List the workflow actions (such as save-draft, publish, approve, reject) available for a subtitle language.
Run one with amara_subtitle_action_perform.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_subtitle_notes_list`

List Subtitle Notes · Read-only

List the editor notes left on a subtitle language.
Get the video ID from amara_videos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_subtitle_request_get`

Get Subtitle Request · Read-only

Get one subtitle request with its stage, assignees and due dates.
Get the job ID from amara_subtitle_requests_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Job ID. Example: AbC12dE
- `team_slug` (`string`, required): Team Slug. Example: my-team

Example input: `{"job_id":"<job_id>","team_slug":"<team_slug>"}`

### `amara_subtitle_requests_list`

List Subtitle Requests · Read-only

List a team's subtitle requests (jobs), by work status, video, language, project or assignee.
Use amara_subtitle_request_get for one request.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `assignee` (`string`, optional): Filter by assignee. Example: jane
- `language` (`string`, optional): Filter by subtitle request language. Example: es
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `project` (`string`, optional): Filter by team project. Example: season-1
- `sort` (`string`, optional): Sort order. Defaults to -creation . See below for values. Example: -creation
- `status` (`string`, optional): Filter by the overall status (see the request status fields section). Example: in-progress
- `type` (`string`, optional): Activity type to filter by (see Amara's activity types list, for example video-added or subtitles-added). Example: local
- `video` (`string`, optional): Filter by video ID. Example: NI1hLjBxuTpk
- `video_language` (`string`, optional): Filter by video language. Example: en
- `video_title` (`string`, optional): Filter by video title. Example: Meet Amara
- `work_status` (`string`, optional): Filter by the status of work on the subtitles. See below for possible values. Example: complete

Example input: `{"team_slug":"<team_slug>"}`

### `amara_subtitles_get`

Get Subtitles · Read-only

Get the subtitles for a language in a format such as srt, vtt, dfxp, sbv or json, optionally for a given version.
Use amara_languages_list to see versions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `sub_format` (`string`, optional): The format to return the subtitles in. This can be any format that amara supports including dfxp, srt, vtt, and sbv. The default is json, which returns subtitle data encoded list of json dicts. Example: json
- `version_number` (`integer`, optional): version number to fetch. Versions are listed in the VideoLanguageResouce request. If none is specified, the latest public version will be returned. If you want the latest private version (and have access to it) use “last”. Example: 2

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_supported_languages_list`

List Languages · Read-only

List every language code Amara supports with its name.
Use these codes for subtitle and video language fields.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{}`

### `amara_team_activity_list`

List Team Activity · Read-only

List activity on a team's videos, by type, user, video, language or date.
Get the team slug from amara_teams_list. Users are given as a username or as id$ plus the user ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `after` (`string`, optional): Only include activity after. Example: 2026-01-01T00:00:00Z
- `before` (`string`, optional): Only include activity before this date/time. Example: 2026-01-31T00:00:00Z
- `language` (`string`, optional): Filter by the subtitle language. Example: es
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `type` (`string`, optional): Activity type to filter by (see Amara's activity types list, for example video-added or subtitles-added). Example: video-added
- `user` (`string`, optional): Filter by user who performed the action (see Specifying users in request data ). Example: id$jGvdcg-jNoGc32ySWS13tD
- `video` (`string`, optional): Filter by video. Example: NI1hLjBxuTpk
- `video_language` (`string`, optional): Filter by video language. Example: en

Example input: `{"team_slug":"<team_slug>"}`

### `amara_team_applications_list`

List Team Applications · Read-only

List applications to join a team, by status, user or date.
Needs team admin rights.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `after` (`string`, optional): Include only applications submitted after this time (deprecated: UNIX timestamps are also allowed). Example: 2026-01-01T00:00:00Z
- `before` (`string`, optional): Include only applications submitted before this time (deprecated: UNIX timestamps are also allowed). Example: 2026-01-31T00:00:00Z
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `status` (`string`, optional): Include only applications with this status. Example: Approved
- `user` (`string`, optional): Include only applications from this user (see Specifying users in request data ). Example: id$jGvdcg-jNoGc32ySWS13tD

Example input: `{"team_slug":"<team_slug>"}`

### `amara_team_get`

Get Team · Read-only

Get one team's details, visibility, membership and video policies.
Get the team slug from amara_teams_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team

Example input: `{"team_slug":"<team_slug>"}`

### `amara_team_member_get`

Get Team Member · Read-only

Get one team member's role.
Get the team slug from amara_teams_list. Users are given as a username or as id$ plus the user ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `user_identifier` (`string`, required): User Identifier. Example: id$jGvdcg-jNoGc32ySWS13tD

Example input: `{"team_slug":"<team_slug>","user_identifier":"<user_identifier>"}`

### `amara_team_members_list`

List Team Members · Read-only

List a team's members and their roles.
Get the team slug from amara_teams_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{"team_slug":"<team_slug>"}`

### `amara_team_notifications_list`

List Team Notifications · Read-only

List the HTTP callback notifications Amara sent for a team, with response status.
Use this to debug team webhooks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{"team_slug":"<team_slug>"}`

### `amara_teams_list`

List Teams · Read-only

List the teams visible to the API key's user.
Use the team slug with the team tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{}`

### `amara_user_activity_list`

List User Activity · Read-only

List a user's activity, by type, video, language, team or date.
Users are given as a username or as id$ plus the user ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identifier` (`string`, required): Identifier. Example: id$jGvdcg-jNoGc32ySWS13tD
- `after` (`string`, optional): Only include activity after. Example: 2026-01-01T00:00:00Z
- `before` (`string`, optional): Only include activity before this date/time. Example: 2026-01-31T00:00:00Z
- `language` (`string`, optional): Filter by the subtitle language. Example: es
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `team` (`string`, optional): Filter by team. Example: my-team
- `type` (`string`, optional): Activity type to filter by (see Amara's activity types list, for example video-added or subtitles-added). Example: video-added
- `video` (`string`, optional): Filter by video. Example: NI1hLjBxuTpk
- `video_language` (`string`, optional): Filter by video language. Example: en

Example input: `{"identifier":"<identifier>"}`

### `amara_user_get`

Get User · Read-only

Get a user's profile: name, username, languages, bio and avatar.
Pass a username or id$ plus the user ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identifier` (`string`, required): Identifier. Example: id$jGvdcg-jNoGc32ySWS13tD

Example input: `{"identifier":"<identifier>"}`

### `amara_video_activity_list`

List Video Activity · Read-only

List activity on a video (added, subtitled, approved and so on), by type, user, language or date.
Get the video ID from amara_videos_list. Users are given as a username or as id$ plus the user ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `after` (`string`, optional): Only include activity after. Example: 2026-01-01T00:00:00Z
- `before` (`string`, optional): Only include activity before this date/time. Example: 2026-01-31T00:00:00Z
- `language` (`string`, optional): Filter by the subtitle language. Example: es
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `type` (`string`, optional): Activity type to filter by (see Amara's activity types list, for example video-added or subtitles-added). Example: video-added
- `user` (`string`, optional): Filter by user who performed the action (see Specifying users in request data ). Example: id$jGvdcg-jNoGc32ySWS13tD

Example input: `{"video_id":"<video_id>"}`

### `amara_video_get`

Get Video · Read-only

Get one video with title, duration, team, URLs and the subtitle languages started on it.
Get the video ID from amara_videos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"video_id":"<video_id>"}`

### `amara_video_urls_list`

List Video URLs · Read-only

List the media URLs attached to a video, with the primary and original flags.
Get the video ID from amara_videos_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{"video_id":"<video_id>"}`

### `amara_videos_list`

List Videos · Read-only

List videos, filtered by video URL, team, project or audio language, and ordered by title or creation date.
Pass team (and optionally project) to list a team's videos. Use amara_video_get for one video.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Page size (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Change the list ordering. One of: title, -title, created, -created. Example: -created. One of: `title`, `-title`, `created`, `-created`.
- `primary_audio_language_code` (`string`, optional): Filter team videos by video language (only works when the team parameter is also present). Example: en
- `project` (`string`, optional): Filter by team project. Passing in null will return only videos that don’t belong to a project. Example: season-1
- `team` (`string`, optional): Filter by team. Passing in null will return only videos that are in the public area. Example: my-team
- `video_url` (`string`, optional): Filter by video URL. Example: https://www.youtube.com/watch?v=aQ-xe-GSjdA

Example input: `{}`

### `amara_language_create`

Create Subtitle Language · Write

Start a subtitle language on a video, with optional primary-audio and complete flags and editor limits.
Then add subtitles with amara_subtitles_add. Get the video ID from amara_videos_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `is_primary_audio_language` (`boolean`, optional): Is this the primary spoken language of the video? (optional). Example: true
- `language_code` (`string`, optional): bcp-47 code for the language. Example: en
- `soft_limit_cpl` (`integer`, optional): Controls the max characters per line for subtitles. A warning is shown in the editor if this limit is exceeded. Example: 42
- `soft_limit_cps` (`integer`, optional): Controls the max characters per second for subtitles. A warning is shown in the editor if this limit is exceeded. Example: 25
- `soft_limit_lines` (`integer`, optional): Controls the max number of lines per subtitle. A warning is shown in the editor if this limit is exceeded. Example: 2
- `soft_limit_max_duration` (`integer`, optional): Controls max duration of subtitles in milliseconds. This controls the message in the guidelines dialog. Example: 25
- `soft_limit_min_duration` (`integer`, optional): Controls min duration of subtitles in milliseconds. A warning is shown in the editor if this limit is exceeded. Example: 25
- `subtitles_complete` (`boolean`, optional): Are the subtitles for this language complete? (optional). Example: true

Example input: `{"video_id":"<video_id>"}`

### `amara_language_update`

Update Subtitle Language · Write

Update a subtitle language's primary-audio and complete flags or editor limits.
Get the video ID from amara_videos_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `is_primary_audio_language` (`boolean`, optional): Is this the primary spoken language of the video? (optional). Example: true
- `soft_limit_cpl` (`integer`, optional): Controls the max characters per line for subtitles. A warning is shown in the editor if this limit is exceeded. Example: 42
- `soft_limit_cps` (`integer`, optional): Controls the max characters per second for subtitles. A warning is shown in the editor if this limit is exceeded. Example: 25
- `soft_limit_lines` (`integer`, optional): Controls the max number of lines per subtitle. A warning is shown in the editor if this limit is exceeded. Example: 2
- `soft_limit_max_duration` (`integer`, optional): Controls max duration of subtitles in milliseconds. This controls the message in the guidelines dialog. Example: 25
- `soft_limit_min_duration` (`integer`, optional): Controls min duration of subtitles in milliseconds. A warning is shown in the editor if this limit is exceeded. Example: 25
- `subtitles_complete` (`boolean`, optional): Are the subtitles for this language complete? (optional). Example: true

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_message_send`

Send Message · Write

Send an Amara message to a user or to a whole team.
This notifies the recipients. Users are given as a username or as id$ plus the user ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): Content of the message. Example: The Spanish subtitles are due Friday.
- `subject` (`string`, required): Subject of the message. Example: Subtitle deadline
- `team` (`string`, optional): Recipient team. Example: my-team
- `user` (`string`, optional): Recipient user (see Specifying users in request data ). Example: id$jGvdcg-jNoGc32ySWS13tD

Example input: `{"content":"<content>","subject":"<subject>"}`

### `amara_project_create`

Create Project · Write

Create a project in a team with a name, slug, description and guidelines.
Needs team admin rights.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Project name. Example: Season 1
- `slug` (`string`, required): Slug for the project. Example: season-1
- `team_slug` (`string`, required): Team Slug. Example: my-team
- `description` (`string`, optional): Project description. Example: Introduction video
- `guidelines` (`string`, optional): Guidelines for users working on the project. Example: Use sentence case.

Example input: `{"name":"<name>","slug":"<slug>","team_slug":"<team_slug>"}`

### `amara_project_update`

Update Project · Write

Update a team project's name, description or guidelines.
Get the project slug from amara_projects_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_slug` (`string`, required): Project Slug. Example: season-1
- `team_slug` (`string`, required): Team Slug. Example: my-team
- `description` (`string`, optional): Project description. Example: Introduction video
- `guidelines` (`string`, optional): Guidelines for users working on the project. Example: Use sentence case.
- `name` (`string`, optional): Project name. Example: Season 1

Example input: `{"project_slug":"<project_slug>","team_slug":"<team_slug>"}`

### `amara_subtitle_action_perform`

Perform Subtitle Action · Write

Run a workflow action (such as publish, approve or reject) on a subtitle language.
Get valid action names from amara_subtitle_actions_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Action to perform. Example: publish
- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"action":"<action>","language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_subtitle_note_add`

Add Subtitle Note · Write

Add an editor note to a subtitle language.
Get the video ID from amara_videos_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`string`, required): Note body. Example: Please check the timing at 00:42.
- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"body":"<body>","language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_subtitle_request_create`

Create Subtitle Request · Write

Request subtitles for a team video in a language, with due dates, optionally sending the work to another team.
The video must belong to the team.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `language` (`string`, required): Language code for the subtitles. Example: es
- `team_slug` (`string`, required): Team Slug. Example: my-team
- `video` (`string`, required): Video ID. This must be part of the team identified in the URL path. Example: NI1hLjBxuTpk
- `approval_due_date` (`string`, optional): Due date for the approval assignment. Example: 2026-02-14T00:00:00Z
- `due_date` (`string`, optional): Due date for the request. Example: 2026-02-15T00:00:00Z
- `evaluation_teams` (`array`, optional): List of evaluation teams. They can be any team you are an admin of (defaults to the empty list). Example: ["review-team"]
- `review_due_date` (`string`, optional): Due date for the review assignment. Example: 2026-02-12T00:00:00Z
- `subtitles_due_date` (`string`, optional): Due date for the subtitling assignment. Example: 2026-02-10T00:00:00Z
- `team` (`string`, optional): Work team. This can be any team you are an admin of (defaults to the video's team). Example: my-team

Example input: `{"language":"<language>","team_slug":"<team_slug>","video":"<video>"}`

### `amara_subtitle_request_update`

Update Subtitle Request · Write

Assign the subtitler, reviewer, approver or evaluator, move the request to another stage, mark it complete or change due dates.
Get the job ID from amara_subtitle_requests_list. Users are given as a username or as id$ plus the user ID.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Job ID. Example: AbC12dE
- `team_slug` (`string`, required): Team Slug. Example: my-team
- `approval_due_date` (`string`, optional): Due date for the approval assignment. Example: 2026-02-14T00:00:00Z
- `approver` (`string`, optional): User to assign as the approver, or null to unassign the current approver (see Specifying users in request data ). Example: maria
- `due_date` (`string`, optional): Due date for the request. Example: 2026-02-15T00:00:00Z
- `evaluation_due_date` (`string`, optional): Due date for the evaluation assignment. Example: 2026-02-20T00:00:00Z
- `evaluation_teams` (`string`, optional): (source team only) Change the evaluation teams. This is only possible if evaluations have not been started. Example: review-team
- `evaluator` (`string`, optional): User to assign as the evaluator, or null to unassign the current evaluator (see Specifying users in request data ). Example: maria
- `review_due_date` (`string`, optional): Due date for the review assignment. Example: 2026-02-12T00:00:00Z
- `reviewer` (`string`, optional): User to assign as the reviewer, or null to unassign the current reviewer (see Specifying users in request data ). Example: john
- `subtitler` (`string`, optional): User to assign as the subtitler, or null to unassign the current subtitler (see Specifying users in request data ). Example: jane
- `subtitles_due_date` (`string`, optional): Due date for the subtitling assignment. Example: 2026-02-10T00:00:00Z
- `team` (`string`, optional): Change the work team. This is only possible if work has not been started. Example: my-team
- `work_stage` (`string`, optional): Used to change the state of the request. See below for possible values. Example: subtitle
- `work_status` (`string`, optional): Deprecated method to change the state of the request. Set to complete to mark the subtitles complete. Example: complete

Example input: `{"job_id":"<job_id>","team_slug":"<team_slug>"}`

### `amara_subtitles_add`

Add Subtitles · Write

Upload a new subtitle version for a language, as text or a file URL in a given format, optionally running an action such as publish.
Use amara_subtitle_actions_list to see allowed actions.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk
- `action` (`string`, optional): Name of the action to perform - optional, but recommended. If given, the is_complete param will be ignored. For more details, see the subtitle actions documentation. Example: publish
- `description` (`string`, optional): Give a description to the new revision. Example: Introduction video
- `sub_format` (`string`, optional): The format used to parse the subs. The same formats as for fetching subtitles are accepted. (Defaults to dfxp ). Example: srt
- `subtitles` (`string`, optional): The subtitles to submit, as a string. The format depends on the sub_format param. Example: 1
00:00:00,000 --> 00:00:02,000
Hello world
- `subtitles_url` (`string`, optional): Alternatively, subtitles can be given as a text file URL. The format depends on the sub_format param. Example: https://example.com/subs.srt
- `title` (`string`, optional): Give a title to the new revision. Example: Meet Amara

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_team_member_add`

Add Team Member · Write

Add a user to a team with a role (owner, admin, manager, contributor and so on).
Needs team admin rights. Users are given as a username or as id$ plus the user ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `role` (`string`, required): Possible values: owner , admin , manager , proj_lang_manager , contributor , or limited_contributor (for collaboration teams only). Example: contributor
- `team_slug` (`string`, required): Team Slug. Example: my-team
- `user` (`string`, required): User to add (see Specifying users in request data ). Example: id$jGvdcg-jNoGc32ySWS13tD
- `languages_managed` (`array`, optional): (for proj_lang_manager only ) the list of languages managed by the language manager. Example: ["es"]
- `projects_managed` (`array`, optional): (for proj_lang_manager only ) the list of projects managed by the project manager. Example: ["season-1"]

Example input: `{"role":"<role>","team_slug":"<team_slug>","user":"<user>"}`

### `amara_team_member_update`

Change Team Member Role · Write

Change a team member's role and managed languages or projects.
Needs team admin rights.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `user_identifier` (`string`, required): User Identifier. Example: id$jGvdcg-jNoGc32ySWS13tD
- `languages_managed` (`array`, optional): (for proj_lang_manager only ) the list of languages managed by the language manager. Example: ["es"]
- `projects_managed` (`array`, optional): (for proj_lang_manager only ) the list of projects managed by the project manager. Example: ["season-1"]
- `role` (`string`, optional): Possible values: owner , admin , manager , proj_lang_manager , contributor , or limited_contributor (for collaboration teams only). Example: contributor

Example input: `{"team_slug":"<team_slug>","user_identifier":"<user_identifier>"}`

### `amara_user_update`

Update My Account · Write

Update the API key owner's username, email or name.
Only your own account can be updated.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identifier` (`string`, required): Identifier. Example: id$jGvdcg-jNoGc32ySWS13tD
- `email` (`string`, optional): A valid email address. Example: jane@example.com
- `first_name` (`string`, optional): Any chars, max 30 chars. Example: Jane
- `last_name` (`string`, optional): Any chars, max 30 chars. Example: Doe
- `username` (`string`, optional): 30 chars or fewer alphanumeric chars, @, _ and are accepted. Example: jane_doe

Example input: `{"identifier":"<identifier>"}`

### `amara_video_create`

Add Video · Write

Add a video to Amara from a YouTube, Vimeo or direct media URL, optionally into a team and project, with title, description, language and metadata.
Use amara_language_create and amara_subtitles_add to subtitle it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `video_url` (`string`, required): The url for the video. Any url that Amara accepts will work here. You can send the URL for a file (e.g. http:///www.example.com/my-video.ogv), or a link to one of our accepted providers (YouTube, Vimeo). Example: https://www.youtube.com/watch?v=aQ-xe-GSjdA
- `description` (`string`, optional): About this video. Example: Introduction video
- `duration` (`integer`, optional): Duration in seconds, in case it can not be retrieved automatically by Amara. Example: 120
- `metadata` (`object`, optional): Dictionary of metadata key/value pairs. These handle extra information about the video. Right now the type keys supported are speaker-name and location. Values can be any string. Example: {"speaker-name": "Jane Doe"}
- `primary_audio_language_code` (`string`, optional): language code for the main language spoken in the video. Example: en
- `project` (`string`, optional): Project slug for the video or null to put it in the default project. Example: season-1
- `team` (`string`, optional): Team slug for the video or null to remove it from its team. Example: my-team
- `thumbnail` (`string`, optional): URL to the video thumbnail. Example: https://example.com/thumb.jpg
- `title` (`string`, optional): Title of the video. Example: Meet Amara

Example input: `{"video_url":"<video_url>"}`

### `amara_project_delete`

Delete Project · Destructive

Delete a team project. Its videos move to the default project.
Get the project slug from amara_projects_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project_slug` (`string`, required): Project Slug. Example: season-1
- `team_slug` (`string`, required): Team Slug. Example: my-team

Example input: `{"project_slug":"<project_slug>","team_slug":"<team_slug>"}`

### `amara_subtitle_request_delete`

Delete Subtitle Request · Destructive

Delete a subtitle request.
Get the job ID from amara_subtitle_requests_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Job ID. Example: AbC12dE
- `team_slug` (`string`, required): Team Slug. Example: my-team

Example input: `{"job_id":"<job_id>","team_slug":"<team_slug>"}`

### `amara_subtitles_delete`

Delete Subtitles · Destructive

Delete all subtitle versions for a language.
This cannot be undone. Get the video ID from amara_videos_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `language_code` (`string`, required): Language Code. Example: en
- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"language_code":"<language_code>","video_id":"<video_id>"}`

### `amara_team_member_remove`

Remove Team Member · Destructive

Remove a user from a team.
Needs team admin rights.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `team_slug` (`string`, required): Team Slug. Example: my-team
- `user_identifier` (`string`, required): User Identifier. Example: id$jGvdcg-jNoGc32ySWS13tD

Example input: `{"team_slug":"<team_slug>","user_identifier":"<user_identifier>"}`

### `amara_video_delete`

Delete Video · Destructive

Delete a video from Amara (only for team videos you can manage).
Get the video ID from amara_videos_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Video ID. Example: NI1hLjBxuTpk

Example input: `{"video_id":"<video_id>"}`

## Related

Other Media connectors ([all 65](/agentkit/connectors/?category=media)):

- [Spotify](/agentkit/connectors/spotify/): Scalekit connector, OAuth, 47 tools
- [Reddit](/agentkit/connectors/reddit/): Scalekit connector, OAuth, 105 tools
- [Diarize](/agentkit/connectors/diarize/): Scalekit connector, Access token, 3 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
