Get the list of task suites
Gets the list of task suites in the pool.
Request
GET https://toloka.yandex.com/api/v1/task-suites
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.yandex.com/api/v1/task-suites
Authorization: OAuth <OAuth token>
Headers
Title | Overview |
---|---|
Authorization | A token for account authorization. Add OAuth as a prefix. |
Query parameters
Specified in the link after the question mark; separated by &
.
Parameter |
Overview |
pool_id |
string ID of the pool to get task suites from. You must specify either |
task_id |
string The task ID in the suites that were generated automatically using "smart mixing". You will get task suites that contain the specified task. You must specify either |
sort |
string Parameters to sort by:
To learn how to configure sorting, see Sorting the list of objects. |
overlap |
integer Suites with an overlap equal to the specified value. |
Standard query parameters |
limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte, overlap_gt, overlap_gte overlap_lt, overlap_lte. |
Query example
You can set up the display of the list of task suites in parts (for example, 10 task suites at a time):
- Show the first 10 task suites, starting from the one with the lowest ID.
- Show the remaining task suites (10 at a time) in ascending order.
Show the first 10 task suites
GET https://toloka.yandex.com/api/v1/task-suites?sort=id&limit=10
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.yandex.com/api/v1/task-suites?sort=id&limit=10
Authorization: OAuth <OAuth token>
Show the remaining tasks sorted by ascending ID
GET https://toloka.yandex.com/api/v1/task-suites?sort=id&limit=10&id_gt=<id of the last task suite from the previous response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.yandex.com/api/v1/task-suites?sort=id&limit=10&id_gt=<id of the last task suite from the previous response>
Authorization: OAuth <OAuth token>
Response
Contains task suite data in the items
array.
{"items" : [{task suite 1}, {task suite 2}, ... {task suite n}], "has_more": true}