Toloka documentation

Checking completed tasks

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.yandex.com/api/v1/assignments/<task_suite_assignment_id>
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

PATCH https://sandbox.toloka.yandex.com/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.
In this article: