client.projects.create()

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

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

const project = await client.projects.create({
  teamId: "your-team-id",
  name: "Text labeling"
});
console.log(project);

{
  "id": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "teamId": "<string>",
  "status": "draft",
  "createdAt": "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 project = await client.projects.create({
  teamId: "your-team-id",
  name: "Text labeling"
});
console.log(project);

{
  "id": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "teamId": "<string>",
  "status": "draft",
  "createdAt": "2026-01-01T00:00:00Z"
}

Send a teamId and optional name. Returns the active project. Use a team where your API key has write access.

Signature

Method signature on client.projects:

create(args: {
  teamId: string;
  name?: string;
}): Promise<Project>;

Parameters

string

required

The team that will own the project.

string

Name of the project; defaults to New Project.

Returns

Promise<Project> A project: a team-scoped container for pipelines and datasets.

ProjectId

required

Project ID with prefix pp..

string

required

Name of the project.

string

required

Identifier of the team that owns the project.

"draft" | "active"

required

Project state: draft before activation or active after activation.

string

required

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

Errors

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

Status	Description
400	The project request is invalid for the selected team.
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 project. Verify your account to unlock full access.” Complete verification in the web app to lift the limit.
429	Rate limit exceeded

HTTP endpoint: POST /projects.

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

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

const project = await client.projects.create({
  teamId: "your-team-id",
  name: "Text labeling"
});
console.log(project);

{
  "id": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "teamId": "<string>",
  "status": "draft",
  "createdAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors