client.pipelines.import()

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const snapshot = await client.pipelines.getGraph({ pipelineId: "pl.019a0000-0000-7000-8000-000000000001" });

const pipeline = await client.pipelines.import({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "Imported pipeline",
  graph: snapshot.graph
});
console.log(pipeline);

{
  "id": "pl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "version": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const snapshot = await client.pipelines.getGraph({ pipelineId: "pl.019a0000-0000-7000-8000-000000000001" });

const pipeline = await client.pipelines.import({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "Imported pipeline",
  graph: snapshot.graph
});
console.log(pipeline);

{
  "id": "pl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "version": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Send an exported pipeline document containing name and graph, up to 2 MiB. Returns the new pipeline. Returns 400 for an invalid graph or a reference to a secret missing from the project.

Signature

Method signature on client.pipelines:

import(args: {
  projectId: string;
  name: string;
  graph: PipelineGraphV1;
}): Promise<Pipeline>;

Parameters

string

required

Project ID with prefix pp..

string

required

Name of the pipeline.

PipelineGraphV1

required

Pipeline graph in version 1 of the public graph format.

Show Fields

required

Graph format version; always 1.

object[]

required

Fields used by the pipeline, with names and JSON Schemas.See the HTTP endpoint for the complete schema.

(RootNode | CodeNode | GenerationNode | MatchNode | QuorumNode)[]

required

Nodes that make up the pipeline.See the HTTP endpoint for the complete schema.

object[]

required

Directed connections between node handles.See the HTTP endpoint for the complete schema.

object

Optional node positions for the visual editor, keyed by node ID and block group; each position is an [x, y] pair.

Show Fields

object

Returns

Promise<Pipeline> A pipeline within a project.

PipelineId

required

Pipeline ID with prefix pl..

ProjectId

required

Project ID with prefix pp..

string

required

Name of the pipeline.

number

required

Pipeline version number; copying a pipeline increments the source version.

string

required

Time the pipeline was created, as an ISO 8601 timestamp.

string

required

Time the pipeline was last updated, as an ISO 8601 timestamp.

Errors

HTTP errors throw PotatoApiError. The endpoint documents these error responses:

Status	Description
400	Pipeline graph is too large, invalid, or references secrets missing from the project
403	Trial limit reached. An account that has not completed identity or business verification may hold one project and one pipeline, and cannot start a run. The body message reads “Your trial allows a single pipeline. Verify your account to unlock full access.” Complete verification in the web app to lift the limit.
404	Project not found
429	Rate limit exceeded

HTTP endpoint: POST /projects/{projectId}/pipelines/import.

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const snapshot = await client.pipelines.getGraph({ pipelineId: "pl.019a0000-0000-7000-8000-000000000001" });

const pipeline = await client.pipelines.import({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "Imported pipeline",
  graph: snapshot.graph
});
console.log(pipeline);

{
  "id": "pl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "version": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors