> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# client.expertLists.update()

> Rename, hide or show an expert list.

Calls the [PATCH endpoint](https://docs.platform.toloka.ai/docs/api-reference/expert-lists/update-expert-list.md).

## Signature

Method signature on `client.expertLists`:

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

## Parameters

**expertListId** `string` *required*

ID of the expert list, with prefix `exl.`.

**name** `string`

New name of the list.

**hidden** `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.

**id** `string` *required*

ID of the expert list, with prefix `exl.`.

**projectId** `ProjectId` *required*

Project ID with prefix `pp.`.

**name** `string` *required*

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

**hidden** `boolean` *required*

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

**expertCount** `number` *required*

Number of experts in the list.

**createdAt** `string` *required*

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

**updatedAt** `string` *required*

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

## Errors

HTTP errors throw [`PotatoApiError`](https://docs.platform.toloka.ai/docs/sdk/errors). 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}`](https://docs.platform.toloka.ai/docs/api-reference/expert-lists/update-expert-list).

```ts update() theme={null}
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);
```

```json update() theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.