Get a list of message threads

  1. Request
  2. Headers
  3. Query parameters

Gets the list of message threads.

Request

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

Headers

Title Overview
Authorization A token for account authorization. Add OAuth as a prefix.
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

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