client.checks.runLints()

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

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

const lints = await client.checks.runLints({
  pipelineId: "pl.019a0000-0000-7000-8000-000000000001"
});
console.log(lints);

{
  "checks": [
    {
      "id": "plcr.019a0000-0000-7000-8000-000000000001",
      "pipelineId": "pl.019a0000-0000-7000-8000-000000000001",
      "nodeId": "<string>",
      "checkId": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z",
      "result": {}
    }
  ],
  "rejected": [
    {
      "nodeId": "<string>",
      "checkId": "<string>",
      "message": "<string>"
    }
  ],
  "nodesInUse": [
    "<string>"
  ]
}

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

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

const lints = await client.checks.runLints({
  pipelineId: "pl.019a0000-0000-7000-8000-000000000001"
});
console.log(lints);

{
  "checks": [
    {
      "id": "plcr.019a0000-0000-7000-8000-000000000001",
      "pipelineId": "pl.019a0000-0000-7000-8000-000000000001",
      "nodeId": "<string>",
      "checkId": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z",
      "result": {}
    }
  ],
  "rejected": [
    {
      "nodeId": "<string>",
      "checkId": "<string>",
      "message": "<string>"
    }
  ],
  "nodesInUse": [
    "<string>"
  ]
}

Start missing, failed, or timed-out lints for the current graph and rerun dataset-content lints. Running lints are retained. Returns checks, rejected starts, and nodesInUse. Poll the checks for nodes from Start to End before starting a pipeline run.

Signature

Method signature on client.checks:

runLints(args: {
  pipelineId: string;
}): Promise<{ checks: CheckJob[]; rejected: { nodeId: string; checkId: string; message: string }[]; nodesInUse: string[] }>;

Parameters

string

required

Pipeline ID with prefix pl..

Returns

Promise<{ checks: CheckJob[]; rejected: { nodeId: string; checkId: string; message: string }[]; nodesInUse: string[] }> The lints of a pipeline after a request to run them.

CheckJob[]

required

The current lint checks after this request, including retained results and newly started checks.

Show Fields

CheckRunId

required

Check run ID with prefix plcr..

PipelineId

required

Pipeline ID with prefix pl..

string

required

Identifier of the pipeline graph node to check.

string

required

Identifier of the check defined for this node, such as dataset-lint on the Start node.

"pending" | "running" | "succeeded" | "failed"

required

Check state: pending while queued, running while executing, succeeded when execution finishes, or failed after an execution error; inspect result.report for findings.

string

required

Time the check was started, as an ISO 8601 timestamp.

string | null

Execution error message, or absent or null when no error is recorded.

object

required

Output and structured findings returned by the check.See the HTTP endpoint for the complete schema.

object[]

required

Lints that could not start, usually because their node has configuration errors.

Show Fields

string

required

Identifier of the node whose lint could not start.

string

required

Identifier of the lint that could not start.

string

required

Reason the lint could not start.

string[]

required

Nodes on the path from Start to End. Only lints of these nodes block a deploy; lints of other nodes are reported but never block.

Errors

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

Status	Description
404	Pipeline not found
429	Rate limit exceeded

HTTP endpoint: POST /pipelines/{pipelineId}/lints.

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

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

const lints = await client.checks.runLints({
  pipelineId: "pl.019a0000-0000-7000-8000-000000000001"
});
console.log(lints);

{
  "checks": [
    {
      "id": "plcr.019a0000-0000-7000-8000-000000000001",
      "pipelineId": "pl.019a0000-0000-7000-8000-000000000001",
      "nodeId": "<string>",
      "checkId": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z",
      "result": {}
    }
  ],
  "rejected": [
    {
      "nodeId": "<string>",
      "checkId": "<string>",
      "message": "<string>"
    }
  ],
  "nodesInUse": [
    "<string>"
  ]
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors