TypeScript SDK

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

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

const acceptReviewsResult = await client.reviews.acceptAwaiting({
  runId: "plr.019a0000-0000-7000-8000-000000000001",
  expectedCount: 1
});
console.log(acceptReviewsResult);

curl --request POST \
  --url https://platform.toloka.ai/api/v2-beta/runs/{runId}/reviews/accept \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expectedCount": 123
}
'

import requests

url = "https://platform.toloka.ai/api/v2-beta/runs/{runId}/reviews/accept"

payload = { "expectedCount": 123 }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "count": 123
}

Reviews

Accept the awaiting reviews of a run

Only teams with customer review enabled: other teams get 403 The "customerReview" feature is not enabled for this team. Accept every review of the run, or of one generation node, that takes a decision now: needs_review and returned before their deadline. Pass expectedCount, the number of reviews the user confirmed: when a different number awaits a decision now, the response is 409 with the current number and nothing is accepted. The reviews are fixed at the request, so reviews that open later are not included. They are accepted in the background through the same accept as one by one: each expert is paid, each task is billed, and each item moves on to the next node. A review that is decided, rejected, or past its deadline before its turn is skipped. There is no job to poll: follow the progress in the awaiting list, which shrinks as the reviews are accepted. Rejects stay one by one, each with its own evidence.

POST

runs

{runId}

reviews

TypeScript SDK

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

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

const acceptReviewsResult = await client.reviews.acceptAwaiting({
  runId: "plr.019a0000-0000-7000-8000-000000000001",
  expectedCount: 1
});
console.log(acceptReviewsResult);

curl --request POST \
  --url https://platform.toloka.ai/api/v2-beta/runs/{runId}/reviews/accept \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expectedCount": 123
}
'

import requests

url = "https://platform.toloka.ai/api/v2-beta/runs/{runId}/reviews/accept"

payload = { "expectedCount": 123 }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "count": 123
}

Authorizations

Authorization

string

header

required

Enter ApiKey <your-api-key> in Authorization, including the ApiKey prefix. In cURL and Python samples, <api-key> means this full value. The TypeScript SDK adds the prefix for you.

Path Parameters

runId

string

required

Pipeline run ID with prefix plr..

Pattern: ^plr\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Body

application/json

Which awaiting reviews of the run to accept, and how many the user confirmed.

expectedCount

integer

required

How many awaiting reviews the user confirmed accepting. When a different number awaits a decision now, nothing is accepted.

Required range: x <= 9007199254740991

nodeId

string

Only accept the reviews of this generation node.

Response

The reviews are queued to be accepted

The awaiting reviews queued to be accepted in the background.

count

integer

required

Number of reviews queued to be accepted.

Required range: x <= 9007199254740991

Reference

TypeScript SDK

CLI

HTTP API

Accept the awaiting reviews of a run

Authorizations

Path Parameters

Body

Response