client.trainings.listAll()

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

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

for await (const item of client.trainings.listAll({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
})) {
  console.log(item);
}

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

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

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

{
  "id": "trg.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "modelId": null,
  "name": "<string>",
  "configuration": {
    "method": "sft",
    "source": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    },
    "loraRank": 8,
    "epochs": 1,
    "learningRate": 0.00001,
    "batchSize": 8,
    "maxSequenceLength": 64,
    "training": {
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "itemFilter": {
        "fieldValues": [
          {}
        ],
        "fieldSources": [
          {}
        ],
        "missingRevisionFields": [
          "df.019a0000-0000-7000-8000-000000000001"
        ]
      }
    }
  },
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

{
  "trainings": [
    {
      "id": "trg.019a0000-0000-7000-8000-000000000001",
      "projectId": "pp.019a0000-0000-7000-8000-000000000001",
      "modelId": null,
      "name": "<string>",
      "configuration": {
        "method": "sft",
        "source": {
          "type": "base_model",
          "baseModelId": "qwen3-4b"
        },
        "loraRank": 8,
        "epochs": 1,
        "learningRate": 0.00001,
        "batchSize": 8,
        "maxSequenceLength": 64,
        "training": {
          "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
          "itemFilter": {}
        }
      },
      "archivedAt": null,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

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

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

for await (const item of client.trainings.listAll({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
})) {
  console.log(item);
}

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

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

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

{
  "id": "trg.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "modelId": null,
  "name": "<string>",
  "configuration": {
    "method": "sft",
    "source": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    },
    "loraRank": 8,
    "epochs": 1,
    "learningRate": 0.00001,
    "batchSize": 8,
    "maxSequenceLength": 64,
    "training": {
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "itemFilter": {
        "fieldValues": [
          {}
        ],
        "fieldSources": [
          {}
        ],
        "missingRevisionFields": [
          "df.019a0000-0000-7000-8000-000000000001"
        ]
      }
    }
  },
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

{
  "trainings": [
    {
      "id": "trg.019a0000-0000-7000-8000-000000000001",
      "projectId": "pp.019a0000-0000-7000-8000-000000000001",
      "modelId": null,
      "name": "<string>",
      "configuration": {
        "method": "sft",
        "source": {
          "type": "base_model",
          "baseModelId": "qwen3-4b"
        },
        "loraRank": 8,
        "epochs": 1,
        "learningRate": 0.00001,
        "batchSize": 8,
        "maxSequenceLength": 64,
        "training": {
          "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
          "itemFilter": {}
        }
      },
      "archivedAt": null,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Return a page of non-archived training drafts in the project, with pagination metadata. The listAll* variant yields items across every page. The other variant returns one page with pagination metadata. See Pagination.

Signature

Method signatures on client.trainings:

listAll(args: {
  projectId: string;
  limit?: number;
  offset?: number;
}): AsyncGenerator<Training>;

listPage(args: {
  projectId: string;
  limit?: number;
  offset?: number;
}): Promise<{ trainings: Training[]; pagination: Pagination }>;

Parameters

listAll()

string

required

Project ID with prefix pp..

number

default:"20"

Maximum number of results to return; defaults to 20.

number

default:"0"

Number of results to skip before this page; defaults to 0.

listPage()

string

required

Project ID with prefix pp..

number

default:"20"

Maximum number of results to return; defaults to 20.

number

default:"0"

Number of results to skip before this page; defaults to 0.

Returns

listAll() result

AsyncGenerator<Training> Yields one item at a time. The fields below describe each yielded item. A project-owned mutable Training draft. The output Model is bound on the first Training Run.

TrainingId

required

Training draft ID with prefix trg..

ProjectId

required

Project ID with prefix pp..

ModelId | null

required

Output model ID with prefix mdl., or null before the first training run.

string

required

Name of the training draft.

TrainingConfiguration

required

A normalized method-specific Training draft.

Show method: "sft"

"sft"

required

Training method; sft learns a LoRA adapter from prompt and target examples.

TrainingModelSource

required

The exact Base Model or Model Version used as the source.

Show type: "base_model"

"base_model"

required

Training source: base_model uses a catalog model; model_version uses a published project model version.

"qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b"

required

Catalog base model identifier.

Show type: "model_version"

"model_version"

required

Training source: base_model uses a catalog model; model_version uses a published project model version.

string

required

Source model version ID with prefix mdv..

string

The dataset slice to train on. It must freeze a split field. Training uses its train parts and validation uses its validate parts at the slice cutoff. Rows marked as test by any split field are excluded, except validation rows in a part with both validate and test roles in the selected split field.

string

The split field to use, identified by field ID. Required when the slice freezes more than one split field.

string[]

The train parts to learn on. Defaults to every part with the train role.

8 | 16 | 32

required

LoRA adapter rank: 8, 16, or 32. Defaults to 16. Alpha is twice the rank.

number

required

Passes over the training selection, 1 through 5. The cost estimate grows linearly with epochs.

number

required

Optimizer learning rate, 0.00001 through 0.001. The default is 0.00015.

8 | 16 | 32 | 64

required

Sequences per optimizer step across all GPUs: 8, 16, 32, or 64. The default is 8.

number

required

Token budget per training example, prompt and target together: 64 through 16384. The cost estimate is blocked when the longest example exceeds it. Defaults: 12288 for SFT, 3072 for gisting.

TrainingDatasetSelection

required

A Dataset and normalized filter selected for one Training input purpose.

Show Fields

string

required

Dataset ID with prefix ds. containing the selected examples.

TrainingDatasetItemFilter

required

Conditions selecting dataset rows; omitted conditions do not restrict the selection.See the HTTP endpoint for the complete schema.

TrainingDatasetSelection

A Dataset and normalized filter selected for one Training input purpose.

Show Fields

string

required

Dataset ID with prefix ds. containing the selected examples.

TrainingDatasetItemFilter

required

Conditions selecting dataset rows; omitted conditions do not restrict the selection.See the HTTP endpoint for the complete schema.

Show method: "gisting"

"gisting"

required

Training method; gisting learns tokens that replace a reusable prompt.

TrainingModelSource

required

The exact Base Model or Model Version used as the source.

Show type: "base_model"

"base_model"

required

Training source: base_model uses a catalog model; model_version uses a published project model version.

"qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b"

required

Catalog base model identifier.

Show type: "model_version"

"model_version"

required

Training source: base_model uses a catalog model; model_version uses a published project model version.

string

required

Source model version ID with prefix mdv..

string

The split field to use, identified by field ID. Required when the slice freezes more than one split field.

string[]

The train parts to learn on. Defaults to every part with the train role.

string

required

Project file ID with prefix ppf. containing the finalized UTF-8 prompt to compress.

8 | 32 | 64 | "1/4" | "1/8" | "1/16" | "1/32"

required

Number of learned tokens that replace the prompt: 8, 32, 64, or a fraction of the prompt length: “1/4”, “1/8”, “1/16”, or “1/32”. Fractions are rounded up to a whole token and limited to 8 through 256 tokens. Defaults to “1/8”.

number

required

Passes over the training selection, 1 through 5. The cost estimate grows linearly with epochs.

number

required

Optimizer learning rate for the soft tokens, 0.001 through 0.3. The default is 0.03.

8 | 16 | 32 | 64

required

Sequences per optimizer step across all GPUs: 8, 16, 32, or 64. The default is 8.

number

required

Token budget per training example, prompt and target together: 64 through 16384. The cost estimate is blocked when the longest example exceeds it. Defaults: 12288 for SFT, 3072 for gisting.

TrainingDatasetSelection

required

A Dataset and normalized filter selected for one Training input purpose.

Show Fields

string

required

Dataset ID with prefix ds. containing the selected examples.

TrainingDatasetItemFilter

required

Conditions selecting dataset rows; omitted conditions do not restrict the selection.See the HTTP endpoint for the complete schema.

TrainingDatasetSelection

A Dataset and normalized filter selected for one Training input purpose.

Show Fields

string

required

Dataset ID with prefix ds. containing the selected examples.

TrainingDatasetItemFilter

required

Conditions selecting dataset rows; omitted conditions do not restrict the selection.See the HTTP endpoint for the complete schema.

string | null

required

Time the training was archived, as an ISO 8601 timestamp, or null while it is active.

string

required

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

string

required

Time the training was last updated, as an ISO 8601 timestamp.

listPage() result

Promise<{ trainings: Training[]; pagination: Pagination }>

Training[]

required

Training drafts in this page.

Show Fields

TrainingId

required

Training draft ID with prefix trg..

ProjectId

required

Project ID with prefix pp..

ModelId | null

required

Output model ID with prefix mdl., or null before the first training run.

string

required

Name of the training draft.

TrainingConfiguration

required

A normalized method-specific Training draft.See the HTTP endpoint for the complete schema.

string | null

required

Time the training was archived, as an ISO 8601 timestamp, or null while it is active.

string

required

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

string

required

Time the training was last updated, as an ISO 8601 timestamp.

Pagination

required

Pagination information for this page.

Show Fields

number

required

Total number of matching results.

number

required

Maximum number of results requested for this page.

number

required

Number of results skipped before this page.

boolean

required

Whether more matching results follow this page.

Errors

HTTP errors throw PotatoApiError. The endpoint documents these error responses:

Status	Description
404	Project not found
429	Rate limit exceeded

HTTP endpoint: GET /projects/{projectId}/trainings.

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

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

for await (const item of client.trainings.listAll({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
})) {
  console.log(item);
}

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

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

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

Nested values in this example are abbreviated. The HTTP endpoint has the complete schema.

{
  "id": "trg.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "modelId": null,
  "name": "<string>",
  "configuration": {
    "method": "sft",
    "source": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    },
    "loraRank": 8,
    "epochs": 1,
    "learningRate": 0.00001,
    "batchSize": 8,
    "maxSequenceLength": 64,
    "training": {
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "itemFilter": {
        "fieldValues": [
          {}
        ],
        "fieldSources": [
          {}
        ],
        "missingRevisionFields": [
          "df.019a0000-0000-7000-8000-000000000001"
        ]
      }
    }
  },
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

{
  "trainings": [
    {
      "id": "trg.019a0000-0000-7000-8000-000000000001",
      "projectId": "pp.019a0000-0000-7000-8000-000000000001",
      "modelId": null,
      "name": "<string>",
      "configuration": {
        "method": "sft",
        "source": {
          "type": "base_model",
          "baseModelId": "qwen3-4b"
        },
        "loraRank": 8,
        "epochs": 1,
        "learningRate": 0.00001,
        "batchSize": 8,
        "maxSequenceLength": 64,
        "training": {
          "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
          "itemFilter": {}
        }
      },
      "archivedAt": null,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

listAll()

listPage()

Returns

listAll() result

listPage() result

Errors

​Signature

​Parameters

​listAll()

​listPage()

​Returns

​listAll() result

​listPage() result

​Errors

Signature

Parameters

listAll()

listPage()

Returns

listAll() result

listPage() result

Errors