client.expertLists.listExpertsPage()

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

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

const page = await client.expertLists.listExpertsPage({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "experts": [
    {
      "expertId": "<string>",
      "status": "pending"
    }
  ],
  "nextAfter": null
}

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

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

const page = await client.expertLists.listExpertsPage({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "experts": [
    {
      "expertId": "<string>",
      "status": "pending"
    }
  ],
  "nextAfter": null
}

Return a page of the experts in a list with their status, sorted by expert ID.

Signature

Method signature on client.expertLists:

listExpertsPage(args: {
  expertListId: string;
  after?: string;
  limit?: number;
}): Promise<{ experts: { expertId: string; status: "pending" | "available" | "unavailable" | "banned" | "not_found" }[]; nextAfter: null | string }>;

Parameters

string

required

ID of the expert list, with prefix exl..

string

Return experts after this expert ID; use nextAfter of the previous page.

number

default:"1000"

Maximum number of experts to return, from 1 to 1000.

Returns

Promise<{ experts: { expertId: string; status: "pending" | "available" | "unavailable" | "banned" | "not_found" }[]; nextAfter: null | string }>

object[]

required

Experts in this page.

Show Fields

string

required

ID of the expert.

"pending" | "available" | "unavailable" | "not_found" | "banned"

required

Status of the expert.

string | null

required

Pass as after to get the next page; null on the last page.

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

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

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

const page = await client.expertLists.listExpertsPage({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "experts": [
    {
      "expertId": "<string>",
      "status": "pending"
    }
  ],
  "nextAfter": null
}

Reference

TypeScript SDK

CLI

HTTP API

client.expertLists.listExpertsPage()

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors