client.models.listAllVersions()

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.models.listAllVersions({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.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.models.listVersionsPage({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "id": "mdv.019a0000-0000-7000-8000-000000000001",
  "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "revision": 1,
  "content": {
    "runtimeBase": "qwen3-4b",
    "manifest": [
      {
        "path": "example",
        "byteSize": 0,
        "mediaType": "application/octet-stream",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "kind": "lora_adapter",
    "parent": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    }
  },
  "producer": {
    "type": "training_run",
    "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

{
  "versions": [
    {
      "id": "mdv.019a0000-0000-7000-8000-000000000001",
      "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
      "name": "<string>",
      "revision": 1,
      "content": {
        "runtimeBase": "qwen3-4b",
        "manifest": [
          {}
        ],
        "kind": "lora_adapter",
        "parent": {
          "type": "base_model",
          "baseModelId": "qwen3-4b"
        }
      },
      "producer": {
        "type": "training_run",
        "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
      },
      "createdAt": "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.models.listAllVersions({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.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.models.listVersionsPage({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "id": "mdv.019a0000-0000-7000-8000-000000000001",
  "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "revision": 1,
  "content": {
    "runtimeBase": "qwen3-4b",
    "manifest": [
      {
        "path": "example",
        "byteSize": 0,
        "mediaType": "application/octet-stream",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "kind": "lora_adapter",
    "parent": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    }
  },
  "producer": {
    "type": "training_run",
    "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

{
  "versions": [
    {
      "id": "mdv.019a0000-0000-7000-8000-000000000001",
      "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
      "name": "<string>",
      "revision": 1,
      "content": {
        "runtimeBase": "qwen3-4b",
        "manifest": [
          {}
        ],
        "kind": "lora_adapter",
        "parent": {
          "type": "base_model",
          "baseModelId": "qwen3-4b"
        }
      },
      "producer": {
        "type": "training_run",
        "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
      },
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Return a page of immutable versions belonging to the specified model, 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.models:

listAllVersions(args: {
  projectId: string;
  modelId: string;
  limit?: number;
  offset?: number;
}): AsyncGenerator<ModelVersion>;

listVersionsPage(args: {
  projectId: string;
  modelId: string;
  limit?: number;
  offset?: number;
}): Promise<{ versions: ModelVersion[]; pagination: Pagination }>;

Parameters

listAllVersions()

string

required

Project ID with prefix pp..

string

required

Model ID with prefix mdl..

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.

listVersionsPage()

string

required

Project ID with prefix pp..

string

required

Model ID with prefix mdl..

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

listAllVersions() result

AsyncGenerator<ModelVersion> Yields one item at a time. The fields below describe each yielded item. One immutable version of a project Model.

ModelVersionId

required

Model version ID with prefix mdv..

ModelId

required

Model ID with prefix mdl..

string

required

Name of this model version.

number

required

Positive revision number assigned to this version within its model.

object

required

Model weights or LoRA adapter, its base model, parent, and file manifest.

Show kind: "lora_adapter"

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

required

Catalog base model required to run these weights or this adapter.

ModelVersionManifest

required

Files that make up the model version, with sizes and checksums.See the HTTP endpoint for the complete schema.

"lora_adapter"

required

Content kind: lora_adapter contains an adapter; full contains complete model weights.

ModelVersionParent

required

Parent model source; may be absent for full weights with no recorded parent.

Show type: "base_model"

"base_model"

required

Parent source: base_model for a catalog model or model_version for a published project version.

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

required

Catalog base model identifier.

Show type: "model_version"

"model_version"

required

Parent source: base_model for a catalog model or model_version for a published project version.

string

required

Parent model version ID with prefix mdv..

Show kind: "full"

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

required

Catalog base model required to run these weights or this adapter.

ModelVersionManifest

required

Files that make up the model version, with sizes and checksums.See the HTTP endpoint for the complete schema.

"full"

required

Content kind: lora_adapter contains an adapter; full contains complete model weights.

ModelVersionParent

Parent model source; may be absent for full weights with no recorded parent.

Show type: "base_model"

"base_model"

required

Parent source: base_model for a catalog model or model_version for a published project version.

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

required

Catalog base model identifier.

Show type: "model_version"

"model_version"

required

Parent source: base_model for a catalog model or model_version for a published project version.

string

required

Parent model version ID with prefix mdv..

object

required

Training run that produced this model version.

Show Fields

"training_run"

required

Producer kind; training_run means this version was produced by a training run.

string

required

ID of the training run that produced the version, with prefix trn..

string

required

Time the model version was created, as an ISO 8601 timestamp.

listVersionsPage() result

Promise<{ versions: ModelVersion[]; pagination: Pagination }>

ModelVersion[]

required

Model versions in this page.

Show Fields

ModelVersionId

required

Model version ID with prefix mdv..

ModelId

required

Model ID with prefix mdl..

string

required

Name of this model version.

number

required

Positive revision number assigned to this version within its model.

object

required

Model weights or LoRA adapter, its base model, parent, and file manifest.See the HTTP endpoint for the complete schema.

object

required

Training run that produced this model version.See the HTTP endpoint for the complete schema.

string

required

Time the model version was created, 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
429	Rate limit exceeded

HTTP endpoint: GET /projects/{projectId}/models/{modelId}/versions.

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.models.listAllVersions({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.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.models.listVersionsPage({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "id": "mdv.019a0000-0000-7000-8000-000000000001",
  "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "revision": 1,
  "content": {
    "runtimeBase": "qwen3-4b",
    "manifest": [
      {
        "path": "example",
        "byteSize": 0,
        "mediaType": "application/octet-stream",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "kind": "lora_adapter",
    "parent": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    }
  },
  "producer": {
    "type": "training_run",
    "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

{
  "versions": [
    {
      "id": "mdv.019a0000-0000-7000-8000-000000000001",
      "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
      "name": "<string>",
      "revision": 1,
      "content": {
        "runtimeBase": "qwen3-4b",
        "manifest": [
          {}
        ],
        "kind": "lora_adapter",
        "parent": {
          "type": "base_model",
          "baseModelId": "qwen3-4b"
        }
      },
      "producer": {
        "type": "training_run",
        "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
      },
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Reference

TypeScript SDK

CLI

HTTP API

client.models.listAllVersions()

Signature

Parameters

listAllVersions()

listVersionsPage()

Returns

listAllVersions() result

listVersionsPage() result

Errors

​Signature

​Parameters

​listAllVersions()

​listVersionsPage()

​Returns

​listAllVersions() result

​listVersionsPage() result

​Errors

Signature

Parameters

listAllVersions()

listVersionsPage()

Returns

listAllVersions() result

listVersionsPage() result

Errors