> ## 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.expertBanList.addExperts()

> Ban experts in a project.

Ban experts so they cannot be invited to the project and are removed from the work they are already in. The request is rejected when any of the experts is already banned.

## Signature

Method signature on `client.expertBanList`:

```ts theme={null}
addExperts(args: {
  projectId: string;
  expertIds: string[];
  reason: string;
}): Promise<ExpertChangeResult>;
```

## Parameters

**projectId** `string` *required*

Project ID with prefix `pp.`.

**expertIds** `string[]` *required*

IDs of the experts to ban.

**reason** `string` *required*

Why the experts are banned; applied to every expert in the request.

## Returns

`Promise<ExpertChangeResult>`

**changedCount** `number` *required*

Number of experts added or removed.

## 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: [`POST /projects/{projectId}/expert-ban-list/experts/add`](https://docs.platform.toloka.ai/docs/api-reference/expert-ban-list/add-expert-ban-list-experts).

```ts addExperts() theme={null}
import { createClient } from "@toloka-platform/sdk";

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

const expertChangeResult = await client.expertBanList.addExperts({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  expertIds: [
    "example"
  ],
  reason: "example"
});
console.log(expertChangeResult);
```

```json addExperts() theme={null}
{
  "changedCount": 0
}
```


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