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 for sorting in ascending order:

  • id — The ID of a task suite.

  • created — Date of task suite creation, in UTC in the format YYYY-MM-DD.

You can separate parameters with a comma.

To change the sorting direction to descending, add a hyphen before the parameter. For example, sort=-id.

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 for sorting in ascending order:

  • id — The ID of a task suite.

  • created — Date of task suite creation, in UTC in the format YYYY-MM-DD.

You can separate parameters with a comma.

To change the sorting direction to descending, add a hyphen before the parameter. For example, sort=-id.

Standard query parameters

limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte