Toloka documentation

Get the list of operations

Warning

We recommend that you use the toloka.dev domain for API requests. The toloka.yandex.com domain is still supported but it will be deprecated soon.

Gets the list of operations.

Request

GET https://toloka.dev/api/v1/operations
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/operations
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

type

string

Operation type:

  • POOL.OPEN — Opening a pool.
  • POOL.CLOSE — Closing a pool.
  • PROJECT.ARCHIVE — Archiving a project.
  • POOL.ARCHIVE — Archiving a pool.
  • TASK_SUITE.BATCH_CREATE — Creating multiple task suites.
  • KNOWN_SOLUTIONS.GENERATE — Generating control tasks.

status

string

The status of the operation:

  • PENDING — Not started yet.
  • RUNNING — In progress.
  • SUCCESS — Completed successfully.
  • FAIL — Not completed.

sort

string

Parameters to sort by:

  • id — Operation ID.
  • submitted — The UTC date and time when the request was sent, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].
  • finished — The UTC date and time when the operation was finished, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

To learn how to configure sorting, see Sorting the list of objects.

Standard query parameters

limit, id_gt, id_gte, id_lt, id_lte, submitted_gt, submitted_gte, submitted_lt, submitted_lte, finished_gt, finished_gte, finished_lt, finished_lte.

Response

Contains a list of operations in the items array:

{"items": [{operation details 1}, {operation details 2}, ... {operation details n}], "has_more": false}