Overview

  1. Overview
  2. Methods
  3. Merging tasks
  4. Learn more

Overview

In order to upload tasks to a pool, you need to create JSON objects that contain:

  • The input data for the tasks (such as text or image URLs).
  • Correct responses (for control tasks).
  • Hints (for training tasks).

Toloka automatically combines tasks into suites. You only need to specify the number of tasks to include in each suite (the mixer_config key in the pool).

If you want to create the task suites yourself, follow the instructions in Overview.

Methods

Method End point Overview
POST api/v1/tasks

Creates a task.

POST api/v1/tasks

Creates multiple tasks.

GET api/v1/tasks/<task_id>

Gets task data.

GET api/v1/tasks

Gets the list of tasks in the pool.

PATCH api/v1/tasks/<task_id>

Changes the task overlap.

PATCH api/v1/tasks/<task_id>

Stops assigning a task to users.

Method End point Overview
POST api/v1/tasks

Creates a task.

POST api/v1/tasks

Creates multiple tasks.

GET api/v1/tasks/<task_id>

Gets task data.

GET api/v1/tasks

Gets the list of tasks in the pool.

PATCH api/v1/tasks/<task_id>

Changes the task overlap.

PATCH api/v1/tasks/<task_id>

Stops assigning a task to users.

Merging tasks

Tasks with identical input data can be merged. This allows you to save money if the same task was uploaded to different pools.

Restriction.
  • You can only merge tasks in open pools. If a new pool got a task that was previously completed in a pool that has been closed or archived, the tasks won't be merged.
  • You can only merge your main tasks.

The response to the task received will be automatically assigned to another task if:

  • Both tasks have the same input data.
  • The tasks are located in different pools of the same project.
  • An identical task is available to the performer responding.
  • It has fewer responses than the overlap.

The response will be recorded with a zero price, and the overlap will be reduced by one.

This option is only available for main tasks without  automatic acceptance that were uploaded using “smart mixing” .

To activate task merging in a  project, specify "assignments_automerge_enabled": true in the project.