Connecting external services

If your tasks require images or other files with data, it is convenient to store them on Yandex.Disk. To do this, create a special folder on Yandex.Disk and link it to Toloka. You can use only Yandex.Disk of the same account you are using in Toloka.

Tasks can also use data from other HTTP services. For example, you can enable the geo service and get data from it about objects on the map for displaying in tasks. To do this, you need to link the HTTP service to Toloka.


To use Yandex.Disk as a data source:

  1. Click Add Ya.Disk on the profile page (the External Services Integration tab) and allow Toloka access to Yandex.Disk.

  2. Click Add proxy and fill in the fields:



    Unique name

    Name of the data source. The name will be inserted in the file URLs. Allowed characters: Latin letters, numbers, dash (“-”).


    Choose “Yandex.Disk”.


    Level of access to files:

    • “Public” — All Toloka users (appropriate for files with instructions).

    • “Private” — Only users who received a task with this file (appropriate for task content).

    Folder name

    The name of the folder on Yandex.Disk. A folder with this name will be created on Yandex.Disk automatically (Applications/Yandex.Toloka/<folder name>). It is forbidden to use slash (“/”) in the folder name.

  3. Click Save.

The folder Applications/Yandex.Toloka/<folder name> will be created on Yandex.Disk. Upload images or other files for tasks to it.

Adding images from Yandex.Disk.

To add a file from Yandex.Disk to the project guidelines, use a link /api/proxy/<unique name>/<file name>. For example, /api/proxy/pics/image1.jpg.

To add files from Yandex.Disk to the tasks:

  1. Use the Handlebars helper proxy to place the content of filed in the task interface.

  2. Include relative links to Yandex.Disk files in the TSV file with tasks. For example, pics/image1.jpg.