Get the list of files

Attention

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

Gets the list of files saved in Toloka.

Warning

Files are downloaded not in the order in which they were uploaded to the server.

Request

Production version

Sandbox

GET https://toloka.dev/api/v1/attachments
Authorization: OAuth <OAuth token>

Title	Overview
Authorization	A token for account authorization. Add OAuth as a prefix.

Query parameters are specified in the link after the question mark and separated by &.

Parameter	Overview
pool_id	string Pool ID.
assignment_id	string ID of the task suite assignment.
name	string File name.
type	string Attachment type. Currently the key can have only one value — `ASSIGNMENT_ATTACHMENT`.
user_id	string ID of the Toloker who uploaded the file(s).
sort	string Parameters to sort by: `id` — The file identifier. `created` — The date when the file was uploaded, in UTC using 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, created_gt, created_gte, created_lt, created_lte.

You can set up the display of the list of files in parts (for example, 10 files at a time):

Show the first 10 files

Production version

Sandbox

GET https://toloka.dev/api/v1/attachments?sort=id&limit=10
Authorization: OAuth <OAuth token>

Show the remaining tasks sorted by ascending ID

Production version

Sandbox

GET https://toloka.dev/api/v1/attachments?sort=id&limit=10&id_gt=<ID of the last file from the previous response>
Authorization: OAuth <OAuth token>

{"items" : [{file #1}, {file #2}, ... {file #n}], "has_more": false}

Property Description

items[] array of objects

Contains information about files.

Property	Description
items[]	array of objects Contains information about files.
has_more	boolean Shows whether the list is complete. Acceptable values: `true` — Not all elements are included in the output due to restrictions in the limit parameter. You can get the rest of the results by using the `_lt(e)` and `_gt(e)` parameters. Learn more about standard query parameters. `false` — The output contains all the items.

has_more

boolean

Shows whether the list is complete.

Acceptable values:

true — Not all elements are included in the output due to restrictions in the limit parameter.
You can get the rest of the results by using the _lt(e) and _gt(e) parameters.
Learn more about standard query parameters.
false — The output contains all the items.

Toloka API

Quick start

Reference

Project

Pools

Training

Subscriptions to events

Toloker selection

Tasks