Toloka documentation

Get a list of message threads

Warning

We recommend that you use the toloka.dev domain for API requests. The toloka.yandex.com domain is still supported but it will be deprecated soon.

Gets the list of message threads.

Request

GET https://toloka.dev/api/v1/message-threads
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/message-threads
Authorization: OAuth <OAuth token>

Headers

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

Query parameters

Specified in the link after the question mark; separated by &.

Parameter

Overview

folder

string

Folders where the thread is located:

  • INBOX — Inbox.
  • OUTBOX — Sent.
  • AUTOMATIC_NOTIFICATION — Notifications.
  • IMPORTANT — Important.
  • UNREAD — Unread.

folder_ne

string Folders to not search for the thread: You can specify multiple comma-separated values.

sort

string

Parameters to sort by:

  • id — The ID of a task suite.
  • created — The task suite creation date 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.