Stream processing of task items

For projects with a constant stream of new tasks that don't need to be grouped into batches, task items can be uploaded in streaming mode. They will be processed immediately after uploading.

This mode is suitable, for example, for moderation tasks.

Add a task item

Request

curl -X POST 'https://toloka.dev/api/app/v0/app-projects/{app_project_id}/items/bulk' \
     -H 'Authorization: ApiKey PlaceYourRealApiKey_Here' \
     -H 'Content-Type: application/json' \
     -d '{
           "items": [
             {
               "id": "1",
               "image_url": "https://example.com/dogs_1.jpg"
             }
           ]
         }'

Path parameters

Parameter	Overview
app_project_id	string Project ID.

Body parameters

Key	Overview
items	array of objects Array of task items according to the `input_spec` value of the solution. You can upload an array from a single task item or from several task items within a single request.

Response

Contains an array of IDs assigned to created task items.

Check the status of task items

Note

When you upload items without a batch, processing starts immediately. You can learn about the completion of processing from each item's status.

To get the results, request the list of task items sorted by processing completion time.

After the request is completed, find the last labeled item with the latest finished_at value. Use its ID as last_saved_item_id in the next request.

Request

curl -X POST 'https://toloka.dev/api/app/v0/app-projects/{app_project_id}/items?sort=finished&after_id={last_saved_item_id}' \
     -H 'Authorization: ApiKey PlaceYourRealApiKey_Here' \

Path parameters

Parameter	Overview
app_project_id	string Project ID.
last_saved_item_id	string ID of the item used to request more recent results.

Response

Contains already processed task items.

200 OK
{
  "content": [
    {
      "id": "QlvdZj5d53QHj5Nvx9Vd",
      "app_project_id": "6Vv8kdlrjLYu7ZgPdezj",
      "status": "COMPLETED",
      "input_data": {
        "id": "1",
        "text": "Kate likes dogs."
      },
      "output_data": {
        "text": "Kate likes dogs.",
        "result": ["OK"],
        "confidence": 0.9998542274
      },
      "errors": [],
      "created_at": "2021-10-03T09:49:14.028",
      "started_at": "2021-10-03T10:10:27.561182",
      "finished_at": "2021-10-03T11:24:46.818213"
    },
    {
      "id": "nbeya74y4PpU1NkbaxA4",
      "app_project_id": "6Vv8kdlrjLYu7ZgPdezj",
      "status": "COMPLETED",
      "input_data": {
        "id": "2",
        "text": "I don’t like honey."
      },
      "output_data": {
        "text": "I don’t like honey.",
        "result": ["BAD"],
        "confidence": 0.9998542274
      },
      "errors": [],
      "created_at": "2021-10-03T09:49:14.028",
      "started_at": "2021-10-03T10:10:27.561182",
      "finished_at": "2021-10-03T11:24:47.704265"
    }
  ],
  "has_more": false
}

Contact support

Last updated: July 5, 2023

Bespoke API

Accessing the API API quick start Stream processing of task items Iterating results

Reference

Overview

Bespoke

Bespoke-project

Item

Batch