client.expertLists.list()

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

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

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

[
  {
    "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 expertLists = await client.expertLists.list({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
});
console.log(expertLists);

[
  {
    "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"
  }
]

Return the expert lists of a project, newest first. Available only to teams with expert lists enabled.

Signature

Method signature on client.expertLists:

list(args: {
  projectId: string;
}): Promise<ExpertList[]>;

Parameters

string

required

Project ID with prefix pp..

Returns

Promise<ExpertList[]> Expert lists. Returns an array. Each item has these fields:

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: GET /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 expertLists = await client.expertLists.list({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
});
console.log(expertLists);

[
  {
    "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

Signature

Parameters

Returns

Errors