Checking completed tasks

Attention

The toloka.yandex.com domain will be disabled starting April 1, 2023. Please use the toloka.dev domain for API requests.

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 /assignments/<task_suite_assignment_ID> resource:

  • 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

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

Path parameters

ParameterOverview
task_suite_assignment_idID of the task suite assignment.

Headers

TitleOverview
AuthorizationA token for account authorization. Add OAuth as a prefix.
Content-TypeSpecifies the data format in the request body.

Request body

{
"status": "ACCEPTED",
"public_comment": "Well done!"
}
ParameterOverview
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_commentstring

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]
}
ParameterOverview
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_commentstring

A comment for the Toloker.

Maximum length: 2048 characters.
bonus_ids[]array of strings

IDs of rewards issued.

See also

Contact support
Toloka API
OverviewAccessing the APIRate limiting
Quick start
Reference
Project
Pools
Training
Subscriptions to events
Toloker selection
Ways to upload tasks
Tasks
Task suites
Tracking operations
Getting responses
Checking completed tasks
Rewards
Messages for Tolokers
Various parameters
Libraries