client.models.get()

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

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

const model = await client.models.get({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.019a0000-0000-7000-8000-000000000001"
});
console.log(model);

{
  "id": "mdl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "description": null,
  "baseModelId": "qwen3-4b",
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

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

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

const model = await client.models.get({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.019a0000-0000-7000-8000-000000000001"
});
console.log(model);

{
  "id": "mdl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "description": null,
  "baseModelId": "qwen3-4b",
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Return model metadata, including its base model and archive status.

Signature

Method signature on client.models:

get(args: {
  projectId: string;
  modelId: string;
}): Promise<Model>;

Parameters

string

required

Project ID with prefix pp..

string

required

Model ID with prefix mdl..

Returns

Promise<Model> A project-owned logical Model containing immutable versions.

ModelId

required

Model ID with prefix mdl..

ProjectId

required

Project ID with prefix pp..

string

required

Name of the model.

string | null

required

Description of the model, or null when none was provided.

BaseModelId

required

The stable product identifier of a catalog base model.

string | null

required

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

string

required

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

string

required

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

Errors

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

Status	Description
429	Rate limit exceeded

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

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

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

const model = await client.models.get({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  modelId: "mdl.019a0000-0000-7000-8000-000000000001"
});
console.log(model);

{
  "id": "mdl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "description": null,
  "baseModelId": "qwen3-4b",
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors