Aggregate responses in a pool

  1. Request
  2. Headers
  3. Request body
  4. Response

Starts aggregating responses to all completed tasks in the pool.

Request

POST https://toloka.yandex.com/api/v1/aggregated-solutions/aggregate-by-pool
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.
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

{
  "pool_id": "283",
  "type": "WEIGHTED_DYNAMIC_OVERLAP", 
  "answer_weight_skill_id": "1289",
  "fields": [
    {
      "name": "result"
    }
  ]
}
Copied to clipboard
Parameter Overview
pool_id

string

Pool ID.
type

string

  • WEIGHTED_DYNAMIC_OVERLAP — Aggregation of responses in a pool with dynamic overlap (incremental relabeling, IRL) based on the performer's skill.
  • 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 performer's response.

Required if the WEIGHTED_DYNAMIC_OVERLAP aggregation type is selected.
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.

If the DAWID_SKENE aggregation type is selected, you can only specify one value.

fields.name

string

The output data field name.
Parameter Overview
pool_id

string

Pool ID.
type

string

  • WEIGHTED_DYNAMIC_OVERLAP — Aggregation of responses in a pool with dynamic overlap (incremental relabeling, IRL) based on the performer's skill.
  • 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 performer's response.

Required if the WEIGHTED_DYNAMIC_OVERLAP aggregation type is selected.
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.

If the DAWID_SKENE aggregation type is selected, you can only specify one value.

fields.name

string

The output data field name.

Response

Contains operation details: Check the operation status. When it is completed get the aggregation results.

{
  "id": "fadfe3jk-fdafue2-fda32890-fdafdi23",
  "type": "SOLUTION.AGGREGATE",
  "status": "PEDNDING",
  "submitted": "2018-22-10T14:18:35",
  "progress" : 0,
  "parameters": {
    "pool_id": "283"
  }
}
Parameter Overview
id

string

Operation ID.
type

string

Operation type:

  • POOL.OPEN — Opening a pool.

  • POOL.CLOSE — Closing a pool.

  • PROJECT.ARCHIVE — Archiving a project.

  • POOL.ARCHIVE — Archiving a pool.

  • SOLUTION.AGGREGATE — Aggregating responses.

  • TASK_SUITE.BATCH_CREATE — Creating multiple task suites.
status

string

The status of the operation:

  • PENDING — Not started yet.
  • RUNNING — In progress.
  • SUCCESS — Completed successfully.
  • FAIL — Not completed.
submitted

string

The UTC date and time the request was sent, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].
progress

integer

The percentage of the operation completed.
parameters

object

Parameters of the operation in the request.
Parameter Overview
id

string

Operation ID.
type

string

Operation type:

  • POOL.OPEN — Opening a pool.

  • POOL.CLOSE — Closing a pool.

  • PROJECT.ARCHIVE — Archiving a project.

  • POOL.ARCHIVE — Archiving a pool.

  • SOLUTION.AGGREGATE — Aggregating responses.

  • TASK_SUITE.BATCH_CREATE — Creating multiple task suites.
status

string

The status of the operation:

  • PENDING — Not started yet.
  • RUNNING — In progress.
  • SUCCESS — Completed successfully.
  • FAIL — Not completed.
submitted

string

The UTC date and time the request was sent, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].
progress

integer

The percentage of the operation completed.
parameters

object

Parameters of the operation in the request.