Editing a project

You can view the list of created projects on the Projects page. Open the project page to view the list of pools, the project rating and the project statistics.

To edit project parameters, click in the list of projects or Project actions → Edit on the project page.


If you edit a required field, the changes apply only to new pools. Existing pools will continue using the previous version of the project.

General information

Name to show Tolokers

Project name. You will see it on your Projects page.

Description for Tolokers

A brief explanation of what will happen in the project.

Private comment

A comment that you write for yourself. Tolokers won't see it.

You can make notes here that only you as a requester need to know about.

Task interface


In this block, you need to create the task interface for users. You can do it manually (using HTML/CSS/JS) or using Template Builder.

To see an example of task display, click Task preview.

Data specification

A block for input data (to be uploaded as tasks), and output data (user task responses) in the task interface.

Settings for displaying field tasks

Specify the settings for field task display if you use one of the field task templates.

The Map provider for tasks parameter allows you to specify which map the Tolokers will use. You can select one of the following options:

  • Set by Toloker
  • Google Maps
  • Yandex.Maps

Common interface elements

You can specify which interface elements the Toloker will see when working on a task. To do this, click Show common interface elements and select the elements you need.

Instructions for Tolokers

Instructions are the basic rules that you need to tell Tolokers about before they start completing your tasks.

This field should contain formatted text with images, links, and tables if they're needed to make the task conditions clear.

Learn more about how to write good instructions.

Personal data policy

If your project assumes the collection of any personal data, provide the information about your company in the Personal data policy section.



If you want labeling to be done by Tolokers from different countries, you can translate your project into their native languages.

How to work via Toloka API

To edit a project using Toloka API, send a PUT request with all the project parameters including the ones you want to modify:

curl -X PUT 'https://toloka.dev/api/v1/projects/118252' \
-H 'Content-Type: application/json' \
-H 'Authorization: ApiKey PlaceYourRealApiKey_Here' \
-d '{"id":"118252","public_name":"Elephant color (advanced)","public_description":"What color is the elephant in the picture?","public_instructions":"<p>Look at the picture and decide what color the elephant is.</p> You can zoom in or out using the buttons:</p> <img src=\"disc/img1.png>\"","private_comment":"My first project","task_spec":{"input_spec":{"image":{"type":"URL","required":true,"hidden":false}},"output_spec":{"result":{"type":"string","required":true,"hidden":false}},"view_spec":{"assets":{"script_urls":["library1.js","library2.js"]},"markup":"<task interface code>","script":"<JavaScript code>","styles":"<CSS code>","settings":{"showSkip":true,"showTimer":true,"showTitle":true,"showSubmit":true,"showFullscreen":true,"showInstructions":true,"showFinish":true,"showMessage":true,"showReward":true}}},"assignments_issuing_type":"AUTOMATED","assignments_automerge_enabled":false,"max_active_assignments_count":15,"quality_control":{"configs":[{"collector_config":{"type":"SKIPPED_IN_ROW_ASSIGNMENTS"},"rules":[{"conditions":[{"key":"skipped_in_row_count","operator":"GTE","value":10}],"action":{"type":"REJECT_ALL_ASSIGNMENTS","parameters":{"public_comment":"Skipped more than 10 task suites in a row"}}}]}]},"localization_config":{"default_language":"EN"}}'

Refer to the Edit project section of the Toloka API documentation for more details about the request, its parameters, and possible responses. You will find examples of the requests for Toloka-Kit and other code samples there.

What's next

See also

For developers

Contact support

Last updated: August 3, 2023

Getting started
Important tips
Useful recommendations
Working with Toloka
Project analysis
Toloka settings
Task interface
Template Builder
HTML/CSS/JS editor
Help and support