find_attachments

toloka.client.TolokaClient.find_attachments | Source code

Finds attachments that match certain criteria and returns their metadata.

The number of returned attachments is limited. To find remaining attachments call find_attachments with updated search criteria.

To iterate over all matching attachments you may use the get_attachments method.

Parameters description

ParametersTypeDescription
nameOptional[str]

An attachment file name.

typeOptional[Attachment.Type]

An attachment type. Refer to the Attachment.Type page for more information on the available type values.

user_idOptional[str]

The ID of a Toloker who uploaded attachments.

assignment_idOptional[str]

The ID of an assignment with attachments. Either assignment_id of pool_id is required in a search request.

pool_idOptional[str]

The ID of a pool with attachments. Either assignment_id of pool_id is required in a search request.

id_ltOptional[str]

Attachments with IDs less than the specified value.

id_lteOptional[str]

Attachments with IDs less than or equal to the specified value.

id_gtOptional[str]

Attachments with IDs greater than the specified value.

id_gteOptional[str]

Attachments with IDs greater than or equal to the specified value.

created_ltOptional[datetime]

Attachments uploaded by Tolokers before the specified date.

created_lteOptional[datetime]

Attachments uploaded by Tolokers before or on the specified date.

created_gtOptional[datetime]

Attachments uploaded by Tolokers after the specified date.

created_gteOptional[datetime]

Attachments uploaded by Tolokers after or on the specified date.

sortUnion[List[str], AttachmentSortItems, None]

Sorting options. Default: None.

limitOptional[int]

Returned attachments limit. The maximum allowed value: 100.

  • Returns:

    Found attachments and a flag showing whether there are more matching attachments exceeding the limit.

  • Return type:

    AttachmentSearchResult

Examples:

Let's find attachments in the pool and sort them by the ID and the date of creation in the descending order.

attachments = toloka_client.find_attachments(pool_id='1080020', sort=['-created', '-id'], limit=10)

If there are attachments exceeding the limit, then attachments.has_more is set to True.

Last updated: August 28, 2023

Toloka-Kit
OverviewGetting API keyQuick start
Recipes
Reference
toloka.client
toloka.async_client
toloka.autoquality [autoquality]
toloka.metrics
toloka.streaming