find_message_threads

toloka.client.TolokaClient.find_message_threads | Source code

Finds message threads that match certain criteria.

The number of returned message threads is limited. To find remaining threads call find_message_threads with updated search criteria.

To iterate over all matching threads you may use the get_message_threads method.

Parameters description

ParametersTypeDescription
folderUnion[str, Folder, List[Union[str, Folder]], None]

A folder where to search threads or a list of folders. Refer to the Folder page for more information on the available folder values.

folder_neUnion[str, Folder, List[Union[str, Folder]], None]

A folder to skip or a list of folders. Supported values are the same as for folder.

id_ltOptional[str]

Threads with IDs less than the specified value.

id_lteOptional[str]

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

id_gtOptional[str]

Threads with IDs greater than the specified value.

id_gteOptional[str]

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

created_ltOptional[datetime]

Threads created before the specified date.

created_lteOptional[datetime]

Threads created before or on the specified date.

created_gtOptional[datetime]

Threads created after the specified date.

created_gteOptional[datetime]

Threads created after or on the specified date.

sortUnion[List[str], MessageThreadSortItems, None]

Sorting options. Default: None.

limitOptional[int]

Returned message threads limit. The maximum allowed value: 300. The default value: 50.

  • Returns:

    Found message threads and a flag showing whether there are more matching threads.

  • Return type:

    MessageThreadSearchResult

Examples:

Finding all message threads in the INBOX folder.

result = toloka_client.find_message_threads(folder='INBOX')
message_threads = result.items
print(len(message_threads), '+' if result.has_more else '')

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