Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Crowdin

Scalekit connector
Open markdown

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

Tools
57
What they doRead · write · destructive
36 · 16 · 536 read16 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 Crowdin connection

    In AgentKit > Connections, create a Crowdin 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 = 'crowdin'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Crowdin:', 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: 'crowdin_glossaries_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Crowdin 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
  • crowdin_approvals_listList translation approvals.Read-only

    List Approvals

    List translation approvals. Returns data[] (each with id, user, translationId, languageId, createdAt, stringId) plus pagination. Use crowdin_approvals_list to see what was proofread.

    Inputs

    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
    exclude_label_idsstring
    Label Identifiers. Get via List Labels. Example: abc123
    file_idinteger
    File ID, from crowdin_files_list. Example: 44
    label_idsstring
    Label IDs, comma-separated. Example: 13,27
    language_idstring
    Crowdin language ID, from crowdin_languages_list. Example: de
    limitinteger
    Maximum number of items to return (1 to 500, default 25). Example: 100
    offsetinteger
    Number of items to skip. Example: 0
    order_bystring
    Sort, as field and direction pairs. One of: id, createdAt. Example: createdAt descone of idcreatedAt
    string_idinteger
    String ID, from crowdin_strings_list. Example: 2814
    translation_idinteger
    Translation Identifier. Get via List String Translations Note: Can't be used with languageId in the same request. Example: 12345
  • crowdin_branches_listList the version branches of a project.Read-only

    List Branches

    List the version branches of a project. Returns data[] (each with id, projectId, name, title, createdAt, updatedAt, exportPattern, priority) plus pagination. Use crowdin_branches_list to find a branchId.

    Inputs

    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
    limitinteger
    Maximum number of items to return (1 to 500, default 25). Example: 100
    namestring
    Filter by branch name. Example: main
    offsetinteger
    Number of items to skip. Example: 0
    order_bystring
    Sort, as field and direction pairs. One of: id, name, title, createdAt, updatedAt, exportPattern, priority. Example: createdAt descone of idnametitlecreatedAtupdatedAtexportPatternpriority
  • crowdin_build_download_url_getGet a temporary download link for a finished build ZIP.Read-only

    Get Build Download Link

    Get a temporary download link for a finished build ZIP. Returns data with url, expireIn. Use crowdin_build_download_url_get once crowdin_build_get reports finished.

    Inputs

    build_idintegerrequired
    Build ID. Example: 2
    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
  • crowdin_build_getGet the status and progress of a translation build.Read-only

    Get Build Status

    Get the status and progress of a translation build. Returns data with id, projectId, status, progress, createdAt, updatedAt, finishedAt, error, attributes. Use crowdin_build_get to poll a build.

    Inputs

    build_idintegerrequired
    Build ID. Example: 2
    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
  • crowdin_builds_listList the translation builds of a project.Read-only

    List Builds

    List the translation builds of a project. Returns data[] (each with id, projectId, status, progress, createdAt, updatedAt, finishedAt, error) plus pagination. Use crowdin_builds_list to find a recent build.

    Inputs

    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
    branch_idinteger
    Branch ID, from crowdin_branches_list. Example: 34
    limitinteger
    Maximum number of items to return (1 to 500, default 25). Example: 100
    offsetinteger
    Number of items to skip. Example: 0
  • crowdin_comments_listList string comments and issues.Read-only

    List Comments

    List string comments and issues. Returns data[] (each with id, text, userId, user, projectId, languageId, type, issueType) plus pagination. Use crowdin_comments_list to read translator questions.

    Inputs

    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
    file_idinteger
    File ID, from crowdin_files_list. Example: 44
    issue_statusstring
    Issue status. One of: resolved, unresolved. Example: unresolvedone of resolvedunresolved
    issue_typestring
    Defines issue type. It can be one issue type or a list of comma-separated ones. One of: general_question, translation_mistake, context_request, source_mistake. Example: general_question,translation_mistakeone of general_questiontranslation_mistakecontext_requestsource_mistake
    limitinteger
    Maximum number of items to return (1 to 500, default 25). Example: 100
    offsetinteger
    Number of items to skip. Example: 0
    order_bystring
    Sort, as field and direction pairs. One of: id, text, type, createdAt, resolvedAt, issueStatus, issueType. Example: createdAt descone of idtexttypecreatedAtresolvedAtissueStatusissueType
    string_idinteger
    String ID, from crowdin_strings_list. Example: 2814
    typestring
    Comment type. One of: comment, issue. Example: issueone of commentissue
  • crowdin_directories_listList the directories of a project.Read-only

    List Directories

    List the directories of a project. Returns data[] (each with id, projectId, branchId, directoryId, name, title, exportPattern, path) plus pagination. Use crowdin_directories_list to find a directoryId.

    Inputs

    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456
    branch_idinteger
    Branch ID, from crowdin_branches_list. Example: 34
    directory_idinteger
    Directory ID, from crowdin_directories_list. Example: 4
    filterstring
    Filter by directory name. Example: docs
    limitinteger
    Maximum number of items to return (1 to 500, default 25). Example: 100
    offsetinteger
    Number of items to skip. Example: 0
    order_bystring
    Sort, as field and direction pairs. One of: id, name, title, createdAt, updatedAt, exportPattern, priority. Example: createdAt descone of idnametitlecreatedAtupdatedAtexportPatternpriority
    recursionboolean
    Set to 1 to include nested directories. Example: 1
  • crowdin_file_download_url_getGet a temporary download link for a source file.Read-only

    Get File Download Link

    Get a temporary download link for a source file. Returns data with url, expireIn. Use crowdin_file_download_url_get to fetch the original source file.

    Inputs

    file_idintegerrequired
    File ID, from crowdin_files_list. Example: 44
    project_idintegerrequired
    Project ID, from crowdin_projects_list. Example: 123456