Toloka documentation

Checking completed tasks

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.

You can manually check tasks and reject responses of poor quality. To accept or reject received responses, change the status of the task suite using a PATCH request to the resource /assignments/<task suite assignment ID>:

  • Accept responses: change SUBMITTED to ACCEPTED.
  • Reject responses: change SUBMITTED to REJECTED.
  • Change a rejection decision: change REJECTED to ACCEPTED.

To resend rejected tasks to be completed by other Tolokers, add a quality control rule to the pool (see Recompletion of assignments).

Request

PATCH https://toloka.dev/api/v1/assignments/<task_suite_assignment_id>
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
PATCH https://sandbox.toloka.dev/api/v1/assignments/<task_suite_assignment_id>
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Path parameters

Parameter Overview
task_suite_assignment_id ID of the task suite assignment.

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

{
  "status": "ACCEPTED",
  "public_comment": "Well done!"
}

Parameter

Overview

status

string

Status of an assigned task suite. If you need to list multiple statuses, separate them with commas:

  • ACTIVE — Being completed by a Toloker.
  • SUBMITTED — Completed but not checked.
  • ACCEPTED — Accepted by the requester.
  • REJECTED — Rejected by the requester.
  • SKIPPED — Skipped by the Toloker.
  • EXPIRED — The time for completing the tasks expired.

public_comment

string

A comment for the Toloker.

Maximum length: 2048 characters.

Response

The response contains the changed values of fields:

{
  "status": "ACCEPTED",
  "public_comment": "Well done!",
  "bonus_ids": [10]
}

Parameter

Overview

status

string

Status of an assigned task suite. If you need to list multiple statuses, separate them with commas:

  • ACTIVE — Being completed by a Toloker.
  • SUBMITTED — Completed but not checked.
  • ACCEPTED — Accepted by the requester.
  • REJECTED — Rejected by the requester.
  • SKIPPED — Skipped by the Toloker.
  • EXPIRED — The time for completing the tasks expired.

public_comment

string

A comment for the Toloker.

Maximum length: 2048 characters.

bonus_ids[]

array of strings

IDs of rewards issued.