> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# client.checks.runLints()

> Run pipeline lints.

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`:

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

## Parameters

**pipelineId** `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.

**checks** `CheckJob[]` *required*

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

**Fields**

**id** `CheckRunId` *required*

Check run ID with prefix `plcr.`.

**pipelineId** `PipelineId` *required*

Pipeline ID with prefix `pl.`.

**nodeId** `string` *required*

Identifier of the pipeline graph node to check.

**checkId** `string` *required*

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

**status** `"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.

**createdAt** `string` *required*

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

**error** `string | null`

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

**result** `object` *required*

Output and structured findings returned by the check.

See the [HTTP endpoint](https://docs.platform.toloka.ai/docs/api-reference/checks/run-pipeline-lints.md) for the complete schema.

**rejected** `object[]` *required*

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

**Fields**

**nodeId** `string` *required*

Identifier of the node whose lint could not start.

**checkId** `string` *required*

Identifier of the lint that could not start.

**message** `string` *required*

Reason the lint could not start.

**nodesInUse** `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`](https://docs.platform.toloka.ai/docs/sdk/errors). The endpoint documents these error responses:

| Status | Description |
| - | - |
| 404 | Pipeline not found |
| 429 | Rate limit exceeded |

HTTP endpoint: [`POST /pipelines/{pipelineId}/lints`](https://docs.platform.toloka.ai/docs/api-reference/checks/run-pipeline-lints).

```ts runLints() theme={null}
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);
```

```json runLints() theme={null}
{
  "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>"
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.