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 users, 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

Path parameters

Parameter Overview
task_suite_assignment_id ID of the task suite assignment.
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.
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!"
}
Copied to clipboard
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 user.

  • SUBMITTED — Completed but not checked.

  • ACCEPTED — Accepted by the requester.

  • REJECTED — Rejected by the requester.

  • SKIPPED — Skipped by the user.

  • EXPIRED — The time for completing the tasks expired.

public_comment

string

A comment for the user.

Maximum length: 2048 characters.

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 user.

  • SUBMITTED — Completed but not checked.

  • ACCEPTED — Accepted by the requester.

  • REJECTED — Rejected by the requester.

  • SKIPPED — Skipped by the user.

  • EXPIRED — The time for completing the tasks expired.

public_comment

string

A comment for the user.

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 user.

  • SUBMITTED — Completed but not checked.

  • ACCEPTED — Accepted by the requester.

  • REJECTED — Rejected by the requester.

  • SKIPPED — Skipped by the user.

  • EXPIRED — The time for completing the tasks expired.

public_comment

string

A comment for the user.

Maximum length: 2048 characters.

bonus_ids[]

array of strings

IDs of rewards issued.

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 user.

  • SUBMITTED — Completed but not checked.

  • ACCEPTED — Accepted by the requester.

  • REJECTED — Rejected by the requester.

  • SKIPPED — Skipped by the user.

  • EXPIRED — The time for completing the tasks expired.

public_comment

string

A comment for the user.

Maximum length: 2048 characters.

bonus_ids[]

array of strings

IDs of rewards issued.