Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Scale AI

Scalekit connector
Open markdown

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

Tools
20
What they doRead · write · destructive
8 · 10 · 28 read10 write2 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 Scale AI connection

    In AgentKit > Connections, create a Scale AI connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • scaleai_audits_listGet the fixless audits of a task, or one audit by ID, with their feedback items (errors, flags, comments).Read-only

    List Fixless Audits

    Get the fixless audits of a task, or one audit by ID, with their feedback items (errors, flags, comments). Returns audit objects.

    Inputs

    idstring
    Audit ID to get. Example: 6560a1b2c3d4e5f6a7b8c9d0.
    task_idstring
    Task ID to get audits for. Example: 576ba74eec471ff9b01557cc.
  • scaleai_batch_getGet one batch by name with its project, status and callback.Read-only

    Get Batch

    Get one batch by name with its project, status and callback. Returns the batch object. Use scaleai_batch_status_get for task counts.

    Inputs

    batch_namestringrequired
    Batch name, from scaleai_batches_list. Example: kitten_labeling_2020-07.
  • scaleai_batch_status_getGet a batch's status and the count of its tasks by status (pending, completed, error, canceled).Read-only

    Get Batch Status

    Get a batch's status and the count of its tasks by status (pending, completed, error, canceled). Returns the counts.

    Inputs

    batch_namestringrequired
    Batch name, from scaleai_batches_list. Example: kitten_labeling_2020-07.
  • scaleai_batches_listList batches, newest first, optionally by project, status or creation time, with limit and offset paging.Read-only

    List Batches

    List batches, newest first, optionally by project, status or creation time, with limit and offset paging. Returns batches with name, project, status and, with detailed, task counts.

    Inputs

    detailedboolean
    Set to true to include progress details. Example: true.
    end_timestring
    Only batches created at or before this ISO 8601 time. Example: 2026-01-31.
    limitinteger
    Page size, up to 100. Example: 100.
    offsetinteger
    Number of batches to skip. Example: 0.
    projectstring
    Only batches of this project name. Example: kitten_labeling.
    start_timestring
    Only batches created at or after this ISO 8601 time. Example: 2026-01-01.
    statusstring
    Only batches in this status. Example: in_progress.one of stagingin_progresscompleted
  • scaleai_project_getGet one project by name with its task type, current parameters and parameter history.Read-only

    Get Project

    Get one project by name with its task type, current parameters and parameter history. Returns the project object.

    Inputs

    project_namestringrequired
    Project name, from scaleai_projects_list. Example: kitten_labeling.
  • scaleai_projects_listList all projects in the account, optionally only archived or only active ones.Read-only

    List Projects

    List all projects in the account, optionally only archived or only active ones. Returns projects with name, task type, parameters and creation time. Use scaleai_project_get for one project.

    Inputs

    archivedboolean
    Set to true for archived projects only, false for active projects only. Example: false.
  • scaleai_task_getGet one task by ID with its status, parameters, metadata and, when completed, the response (annotations).Read-only

    Get Task

    Get one task by ID with its status, parameters, metadata and, when completed, the response (annotations). Returns the task object.

    Inputs

    task_idstringrequired
    Task ID, from scaleai_tasks_list or the create response. Example: 576ba74eec471ff9b01557cc.
  • scaleai_tasks_listList tasks, newest first, filtered by project, batch, type, status, review status, unique ID, tags or created/completed/updated time, with token paging.Read-only

    List Tasks

    List tasks, newest first, filtered by project, batch, type, status, review status, unique ID, tags or created/completed/updated time, with token paging. Returns tasks and next_token.

    Inputs

    batchstring
    Only tasks of this batch name. Example: kitten_labeling_2026-01.
    completed_afterstring
    Only tasks completed at or after this ISO 8601 time. Example: 2026-01-10.
    completed_beforestring
    Only tasks completed at or before this ISO 8601 time. Example: 2026-01-20.
    customer_review_statusstring
    Only tasks with this audit result; several comma-separated values allowed (accepted, fixed, commented, rejected). Example: accepted.
    end_timestring
    Only tasks created at or before this ISO 8601 time. Example: 2026-01-31.
    include_attachment_urlboolean
    Set to true to include presigned attachment URLs. Example: true.
    limitinteger
    Page size, 1 to 100. Defaults to 100. Example: 100.
    next_tokenstring
    next_token from the previous page. Example: eyJpZCI6IjU3NmJhNzRlIn0.
    projectstring
    Only tasks of this project name. Example: kitten_labeling.
    start_timestring
    Only tasks created at or after this ISO 8601 time. Example: 2026-01-01.
    statusstring
    Only tasks in this status. Example: completed.one of completedpendingcanceled
    tagsstring
    Only tasks with this tag; several comma-separated values allowed. Example: pilot.
    typestring
    Only tasks of this type. Example: imageannotation.one of imageannotationsegmentannotationvideoannotationvideoplaybackannotationtextcollectionnamedentityrecognitionlidarannotationlidarsegmentationlidarlinkinglidartopdownsensorfusionmultistage
    unique_idstring
    Only tasks with this unique_id; several comma-separated values allowed. Example: kitten-01.jpg.
    updated_afterstring
    Only tasks updated at or after this ISO 8601 time. Example: 2026-01-10.
    updated_beforestring
    Only tasks updated at or before this ISO 8601 time. Example: 2026-01-20.