client.expertLists.create()

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

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

const expertList = await client.expertLists.create({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example"
});
console.log(expertList);

{
  "id": "exl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "expertCount": 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 expertList = await client.expertLists.create({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example"
});
console.log(expertList);

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

Create an empty expert list in a project. Add experts with addExpertListExperts.

Signature

Method signature on client.expertLists:

create(args: {
  projectId: string;
  name: string;
}): Promise<ExpertList>;

Parameters

string

required

Project ID with prefix pp..

string

required

Name of the new expert list.

Returns

Promise<ExpertList> A project expert list: a fixed set of experts a node can take its workforce from.

string

required

ID of the expert list, with prefix exl..

ProjectId

required

Project ID with prefix pp..

string

required

Name of the expert list, shown when picking a list for a node.

boolean

required

Experts cannot be added to or removed from a hidden list until it is shown again. Nodes that use it keep working.

number

required

Number of experts in the list.

string

required

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

string

required

Time the list was last changed, as an ISO 8601 timestamp.

Errors

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

Status	Description
404	Project or expert list not found, or not available for it
429	Rate limit exceeded

HTTP endpoint: POST /projects/{projectId}/expert-lists.

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

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

const expertList = await client.expertLists.create({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example"
});
console.log(expertList);

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

Reference

TypeScript SDK

CLI

HTTP API

client.expertLists.create()

Signature

Parameters

Returns

Errors