Change pool priority

Attention

The toloka.yandex.com domain will be disabled starting July 1, 2023. Please use the toloka.dev domain for API requests.

Changes the priority of a pool.

If you have multiple pools and want Tolokers to be offered one pool before another, change the pool priority. You don't need to stop the pool for that, it must have the "open" or "closed" status.

Priority is a number on a scale from 0 to 100. The larger the number, the faster the pool will be labeled compared to your other pools.

Request

Tip

Try our new API reference: more parameter details, request/response examples, and code samples in various programming languages, including the Toloka-Kit usage samples.

Production version

Sandbox

PATCH https://toloka.dev/api/v1/pools/<pool_id>
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Path parameters

Parameter	Overview
pool_id	Pool ID.

Headers

Title	Overview
Authorization	A token for account authorization. Add OAuth as a prefix.
Content-Type	Specifies the data format in the request body.

Request body

{
  "priority": <from 0 to 100>
}

Parameter	Overview
Priority	integer The priority of the pool in relation to other pools in the project with the same task price and set of filters. Users are assigned tasks with a higher priority first. Possible values: from `0` to `100`. By default the value is `0`.

Response

Note

If the pool is archived, an empty response with status 409 is returned.