Skip to main content
@toloka-platform/sdk provides a typed client for the platform’s HTTP API, Data Labeling pipeline authoring functions, and local checks and tests. The client covers projects, datasets, pipelines, Training, Models, and Batch Inference.

Install

Use Bun 1.4.0 or newer as the runtime and package manager. The package ships TypeScript source.
In an existing project, bun install installs the locked dependencies. Use bun add @toloka-platform/sdk@latest to update the SDK dependency.
The SDK is 0.x. Its public API can change between minor releases before 1.0. Review and test your source when updating.

Entry points

Install the CLI separately to import, check, plan, and apply pipeline source. Updating the CLI and updating your project’s SDK dependency are separate steps.

Start building

Quickstart

Authenticate, list projects, add dataset rows, and export them.

Client and credentials

Configure authentication, project-scoped tokens, and requests.

Pagination

Read a page or iterate through every result.

Long-running jobs

Wait for uploads, exports, checks, runs, and dataset operations.

Errors

Handle HTTP failures, polling timeouts, and invalid graphs.

Pipelines as code

Define fields, nodes, and connections in TypeScript.

Local testing

Exercise Code nodes and labeling interfaces before applying changes.

Reference

The Reference tab holds the SDK’s method and function documentation alongside the HTTP API reference.

Client reference

Look up client methods, parameters, return values, and examples.

Pipeline authoring

Look up functions for fields, nodes, connections, and graph validation.