Recompletion of assignments

Toloka can resend tasks for completion if:

The Toloker lost access to the pool because of the skill filter.
The requester banned the Toloker from tasks.
The tasks didn't pass review during post-acceptance.

Request body

Re-assign task suites if a quality control rule or skill filter was triggered.

{
  "configs": [
    {
      "collector_config": {
        "type": "USERS_ASSESSMENT"
      },
      "rules": [
        {
          "conditions": [
            {
              "key": "pool_access_revoked_reason",
              "operator": "EQ",
              "value": "SKILL_CHANGE"
            },
            {
              "key": "skill_id",
              "operator": "EQ",
              "value": "2626"
            }
          ],
          "action": {
            "type": "CHANGE_OVERLAP",
            "parameters": {
                "delta": 1,
                "open_pool": true
            }
          }
        }
      ]
    }
  ]
}

Parameter	Overview
configs[]	array of objects \| required Array of quality control settings.
configs[].collector_config	object \| required Parameters for collecting statistics (for example, the number of tasks skipped in the pool).
configs[].collector_config.type	A condition for performing the action in the then field: Toloker banned — The Toloker's access to tasks is blocked by a quality control rule (such as control tasks, majority vote, fast responses, or skipping tasks). Toloker filtered out — The Toloker no longer meets one or more filters. skill — The Toloker no longer meets the specific skill filter. To add multiple conditions, click .
configs[].collector_config. parameters	Action performed under the If condition: extend overlap by — Resend the task suite for completion to other Tolokers. If you want an assignment to be automatically reassigned even if your pool is already completed and closed, turn on the option Open pool if closed. reduce overlap by — Decrease the number of times a task suite can be completed by Tolokers. For example, use this action to cancel the recompletion of accepted assignments.
configs[].collector_config. parameters.history_size	integer \| required The maximum number of the Toloker's recent responses in the project to use for calculating the percentage of correct responses. If this field is omitted, the calculation is based on all the Toloker's responses in the pool.
configs[].rules	object \| required Parameters for the control rule conditions and actions.
configs[].rules.conditions	object \| required Conditions (for example, 10 task suites skipped in a row). Multiple conditions are combined with the "OR" operator.
configs[].rules.conditions.key	string \| required The value that is checked in the rule: `pool_access_revoked_reason` — The reason the Toloker lost access to the pool.
configs[].rules.conditions. operator	string \| required Comparison operator (the `key` data is compared with the threshold value from `value`): `EQ` ("Equal") — Equal to. `NE` ("Not equal to") — Not equal to. `GT` ("Greater than") — Greater than. `LT` ("Less than") — Less than. `GTE` ("Greater than equal to") — Greater than or equal to. `LTE` ("Less than equal to") — Less than or equal to.
configs[].rules.conditions. value	string \| required The reason the Toloker lost access to the pool: `SKILL_CHANGE` — The skill level changed. `RESTRICTION` — The Toloker was blocked by a quality control rule (for example, for fast responses).
configs[].rules.action	object \| required The action to perform if conditions are met (for example, block access to the project).
configs[].rules.action.type	string \| required `CHANGE_OVERLAP` — Change the overlap. For example, to re-assign a task suite to other Tolokers or cancel the recompletion of accepted task suites.
configs[].rules.action. parameters	object \| required Action parameters.
configs[].rules.action. parameters.scope	string \| required Scope: `POOL` — pool. Affects the Toloker's rating. `PROJECT` — The project. Affects the Toloker's rating. `ALL_PROJECTS` — All the requester's projects.
configs[].rules.action. parameters.skill_id	string \| required if Required if `type=SET_SKILL_FROM_OUTPUT_FIELD`. ID of the skill to update as tasks are completed.
configs[].rules.action. parameters.from_field	string \| required if Required if `type=SET_SKILL_FROM_OUTPUT_FIELD`. The value to assign to the skill: `correct_answers_rate` — The percentage of correct responses. `wrong_answers_rate` — The percentage of incorrect responses.
configs[].rules.action. parameters.skill_value	integer \| required if Required if `type=SET_SKILL_FROM_OUTPUT_FIELD`. A fixed value to assign to the skill (a number from 0 to 100).
configs[].rules.action. parameters.delta	integer \| required if Required if `type=CHANGE_OVERLAP`. The value determines the amount to change the overlap by.
configs[].rules.action. parameters.public_comment	string \| required if Required if `type=REJECT_ALL_ASSIGNMENTS`. Comments (the reason for rejecting responses). Available to the requester and the Toloker.
configs[].rules.action. parameters.duration_unit	string Ban duration unit: `MINUTES` — Minutes. `HOURS` — Hours. `DAYS` — Days. `PERMANENT` — Permanent ban.
configs[].rules.action. parameters.duration	integer Ban duration.
configs[].rules.action. parameters.private_comment	string Comments (the reason for blocking access). Visible only to the requester.
configs[].rules.action. parameters.open_pool	boolean Determines whether to re-open a closed pool: `true` — Open the pool after making changes if it is closed. `false` — Don't open the pool after making changes, if it is closed.

Recompletion of assignments

Request body

See also