Toloka documentation

Edit a task

Warning

We recommend that you use the toloka.dev domain for API requests. The toloka.yandex.com domain is still supported but it will be deprecated soon.

Changes the task overlap.

You can:

  • Set a numeric value or an infinite overlap to assign a task to all Tolokers (for example, for training tasks).

  • Add preliminary responses or change their values if they were set.

    Preliminary responses are used to calculate  response confidence when dynamic overlap (incremental relabeling, IRL) is enabled.

  • Make control and training tasks from regular ones or edit responses and hints for existing tasks.

Request

PATCH https://toloka.dev/api/v1/tasks/<task_id>
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
PATCH https://sandbox.toloka.dev/api/v1/tasks/<task ID>
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.

Path parameters

Parameter Overview
task_id Task ID.

Request body

Numeric overlap value

{
  "overlap": <new overlap value>,
  "infinite_overlap": false
}

Infinite overlap

{
  "overlap": null,
  "infinite_overlap": true
}

Preliminary responses

{
  "baseline_solutions":[
    {
      "output_values":{<output data values>},
      "confidence_weight":<from 0 to 1>
    }
  ]
}

Responses and hints for control tasks and training tasks

{
  "known_solutions":[
    {
      "output_values":{<output data values>},
      "correctness_weight":<from 0 to 1>
    }
  ],
  "message_on_unknown_solution": <message string>
}

Response

Contains task data in JSON format.