Threads, REST: Thread.List
List threads in a specific folder.
HTTP request
GET https://rest-assistant.api.cloud.yandex.net/assistants/v1/threads
Query parameters
Request message for listing threads in a specific folder.
|
Field |
Description |
|
folderId |
string Required field. Folder ID from which to list threads. |
|
pageSize |
string (int64) Maximum number of threads to return per page. |
|
pageToken |
string Token to retrieve the next page of results. |
Response
HTTP Code: 200 - OK
{
"threads": [
{
"id": "string",
"folderId": "string",
"name": "string",
"description": "string",
"defaultMessageAuthorId": "string",
"createdBy": "string",
"createdAt": "string",
"updatedBy": "string",
"updatedAt": "string",
"expirationConfig": {
"expirationPolicy": "string",
"ttlDays": "string"
},
"expiresAt": "string",
"labels": "object"
}
],
"nextPageToken": "string"
}
Response message for the list operation.
|
Field |
Description |
|
threads[] |
List of threads in the specified folder. |
|
nextPageToken |
string Token to retrieve the next page of results. |
Thread
|
Field |
Description |
|
id |
string Unique identifier of the thread. |
|
folderId |
string ID of the folder that the thread belongs to. |
|
name |
string Name of the thread. |
|
description |
string Description of the thread. |
|
defaultMessageAuthorId |
string Default user ID that will be used as the author for thread messages if no other author is specified. |
|
createdBy |
string Identifier of the subject who created this thread. |
|
createdAt |
string (date-time) Timestamp representing when the thread was created. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
updatedBy |
string Identifier of the subject who last updated this thread. |
|
updatedAt |
string (date-time) Timestamp representing the last time this thread was updated. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
expirationConfig |
Configuration for the expiration of the thread, defining when and how the thread will expire. |
|
expiresAt |
string (date-time) Timestamp representing when the thread will expire. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
labels |
object (map<string, string>) Set of key-value pairs that can be used to organize and categorize the thread. |
ExpirationConfig
|
Field |
Description |
|
expirationPolicy |
enum (ExpirationPolicy)
|
|
ttlDays |
string (int64) |