Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Amara

Scalekit connector
Open markdown

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.

Tools
42
What they doRead · write · destructive
23 · 14 · 523 read14 write5 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .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.

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Amara credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • amara_language_getGet one subtitle language of a video with its versions and completion state.Read-only

    Get Subtitle Language

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

    Inputs

    language_codestringrequired
    Language Code. Example: en
    video_idstringrequired
    Video ID. Example: NI1hLjBxuTpk
  • amara_languages_listList the subtitle languages of a video with completion, publish state, versions and limits.Read-only

    List Subtitle Languages

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

    Inputs

    video_idstringrequired
    Video ID. Example: NI1hLjBxuTpk
    limitinteger
    Page size (default 20). Example: 20
    offsetinteger
    Number of results to skip. Example: 0
  • amara_project_getGet one team project with its guidelines.Read-only

    Get Project

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

    Inputs

    project_slugstringrequired
    Project Slug. Example: season-1
    team_slugstringrequired
    Team Slug. Example: my-team
  • amara_projects_listList a team's projects.Read-only

    List Projects

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

    Inputs

    team_slugstringrequired
    Team Slug. Example: my-team
    limitinteger
    Page size (default 20). Example: 20
    offsetinteger
    Number of results to skip. Example: 0
  • amara_subtitle_actions_listList the workflow actions (such as save-draft, publish, approve, reject) available for a subtitle language.Read-only

    List Subtitle Actions

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

    Inputs

    language_codestringrequired
    Language Code. Example: en
    video_idstringrequired
    Video ID. Example: NI1hLjBxuTpk
  • amara_subtitle_notes_listList the editor notes left on a subtitle language.Read-only

    List Subtitle Notes

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

    Inputs

    language_codestringrequired
    Language Code. Example: en
    video_idstringrequired
    Video ID. Example: NI1hLjBxuTpk
  • amara_subtitle_request_getGet one subtitle request with its stage, assignees and due dates.Read-only

    Get Subtitle Request

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

    Inputs

    job_idstringrequired
    Job ID. Example: AbC12dE
    team_slugstringrequired
    Team Slug. Example: my-team
  • amara_subtitle_requests_listList a team's subtitle requests (jobs), by work status, video, language, project or assignee.Read-only

    List Subtitle Requests

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

    Inputs

    team_slugstringrequired
    Team Slug. Example: my-team
    assigneestring
    Filter by assignee. Example: jane
    languagestring
    Filter by subtitle request language. Example: es
    limitinteger
    Page size (default 20). Example: 20
    offsetinteger
    Number of results to skip. Example: 0
    projectstring
    Filter by team project. Example: season-1
    sortstring
    Sort order. Defaults to -creation . See below for values. Example: -creation
    statusstring
    Filter by the overall status (see the request status fields section). Example: in-progress
    typestring
    Activity type to filter by (see Amara's activity types list, for example video-added or subtitles-added). Example: local
    videostring
    Filter by video ID. Example: NI1hLjBxuTpk
    video_languagestring
    Filter by video language. Example: en
    video_titlestring
    Filter by video title. Example: Meet Amara
    work_statusstring
    Filter by the status of work on the subtitles. See below for possible values. Example: complete