client.expertLists.update()

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.update({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
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.update({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
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"
}

Calls the PATCH endpoint.

Signature

Method signature on client.expertLists:

update(args: {
  expertListId: string;
  name?: string;
  hidden?: false | true;
}): Promise<ExpertList>;

Parameters

string

required

ID of the expert list, with prefix exl..

string

New name of the list.

false | true

Hide the list, or show it again.

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: PATCH /expert-lists/{expertListId}.

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.update({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
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.update()

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors