Aggregate responses to a single task

Attention

The toloka.yandex.com domain will be disabled starting July 1, 2023. Please use the toloka.dev domain for API requests.

Starts aggregating responses to a single task.

Request

Tip

Try our new API reference: more parameter details, request/response examples, and code samples in various programming languages, including the Toloka-Kit usage samples.

Production version

Sandbox

POST https://toloka.dev/api/v1/aggregated-solutions/aggregate-by-task
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Headers

Title	Overview
Authorization	A token for account authorization. Add OAuth as a prefix.
Content-Type	Specifies the data format in the request body.

Request body

{
  "task_id": "afd1234d-12314a-cfd1424d-31214b",
  "pool_id": "283",
  "type": "WEIGHTED_DYNAMIC_OVERLAP",
  "answer_weight_skill_id": "1289",
  "fields": [
    {
      "name": "result"
    }
  ]
}

Parameter	Overview
task_id	string Task ID.
pool_id	string Pool ID.
type	string Aggregation type. `WEIGHTED_DYNAMIC_OVERLAP` — Aggregation of responses in a pool with dynamic overlap (also known as incremental relabeling or IRL). `DAWID_SKENE` — Aggregation of responses in a pool without dynamic overlap. The `answer_weight_skill_id` key for this aggregation type is ignored.
answer_weight_skill_id	string A skill that determines the weight of the Toloker's response.
fields	object Output data fields to use for aggregating responses. For best results, each of these fields must have a limited number of response options.
fields.name	string The output data field name.

Response

Contains the aggregated task response.

{
  "confidence": 0.937152,
  "output_values": {
    "result": "OK"
  },
  "pool_id": "283",
  "task_id": "afd1234d-12314a-cfd1424d-31214b"
}

Parameter	Overview
confidence	integer Confidence in the aggregate response.
output_values	object Output data fields and aggregate response.
pool_id	string Pool ID.
task_id	string Task ID.