Toloka documentation

create_task_suite

toloka.client.TolokaClient.create_task_suite | Source code

Creates a new task suite

Generally, you don't need to create a task set yourself, because you can create tasks and Toloka will create task suites for you. Use this method only then you need to group specific tasks in one suite or to set a different parameters on different tasks suites. It's better to use "create_task_suites", if you need to insert several task suites. You can send a maximum of 100,000 requests of this kind per minute and 2,000,000 requests per day.

Parameters Description

Parameters Type Description
task_suite TaskSuite

Task suite that need to be created.

operation_id Optional[UUID]

Operation ID for asynchronous loading of task suites.

skip_invalid_items Optional[bool]

Validation parameters:

  • True - Create the task suites that passed validation. Skip the rest of the task suites.
  • False - If at least one of the task suites didn't pass validation, stop the operation and don't create the task suites.
allow_defaults Optional[bool]

Overlap settings:

  • True - Use the overlap that is set in the pool parameters.
  • False - Use the overlap that is set in the task suite parameters (in the overlap field).
open_pool Optional[bool]

Open the pool immediately after creating a task suite, if the pool is closed.

async_mode Optional[bool]

How the request is processed:

  • True — deferred. The query results in an asynchronous operation running in the background. Answer contains information about the operation (start and end time, status, number of sets).
  • False — synchronous. Answer contains information about the generated sets of tasks. You can send a maximum of 5000 task sets in a single request.
  • Returns:

    Created task suite.

  • Return type:

    TaskSuite

Examples:

new_task_suite = toloka.task_suite.TaskSuite(
    pool_id='1',
    tasks=[toloka.task.Task(input_values={'label': 'Cats vs Dogs'})],
    overlap=2
)
toloka_client.create_task_suite(new_task_suite)