Toloka documentation


A pool consists of task suites that are sent out for completion at the same time. In the pool properties, you set the task price, overlap, Toloker selection filters, quality control rules, and so on.

If the project has multiple pools, the order for completing them depends on the parameters:

  • Pools with identical filter settings and price per task are assigned to Tolokers in the order in which they were started. The pool that was started earlier will be completed sooner. You can change the order for completing the pools.

  • Pools with different filter settings and/or a different price per task are sent out for completion when the pool opens.


Wait for the operation completion (changing its status to SUCCESS or FAIL) before performing any other operation except pool creation.


Method Endpoint Overview
POST /pools Creates a pool.
POST /pools/<pool_id>/close-for-update Closes a pool for editing.
PUT /pools/<pool_id> Makes changes to a pool.
POST /pools/<pool_id>/open Opens a pool.
POST /pools/<pool_id>/close Closes a pool.
POST /pools/<pool_id>/archive Moves a pool to the archive.
POST /pools/<pool_id>/clone Creates a duplicate pool.
GET /pools Gets a list of created pools (including archived pools).
GET /pools/<pool_id> Gets the properties of a pool.
PATCH /pools/pool_id> Changes the priority of a pool.
In this article: