Threads, gRPC: ThreadService.Update
Update an existing thread.
gRPC request
rpc Update (UpdateThreadRequest) returns (Thread)
UpdateThreadRequest
{
"thread_id": "string",
"update_mask": "google.protobuf.FieldMask",
"name": "string",
"description": "string",
"expiration_config": {
"expiration_policy": "ExpirationPolicy",
"ttl_days": "int64"
},
"labels": "map<string, string>",
"tools": [
{
// Includes only one of the fields `search_index`, `function`
"search_index": {
"search_index_ids": [
"string"
],
"max_num_results": "google.protobuf.Int64Value"
},
"function": {
"name": "string",
"description": "string",
"parameters": "google.protobuf.Struct"
}
// end of the list of possible fields
}
]
}
Request message for updating an existing thread.
|
Field |
Description |
|
thread_id |
string Required field. ID of the thread to update. |
|
update_mask |
Required field. Field mask specifying which fields to update. |
|
name |
string New name for the thread. |
|
description |
string New description for the thread. |
|
expiration_config |
New expiration configuration for the thread. |
|
labels |
object (map<string, string>) New set of labels for the thread. |
|
tools[] |
A new list of tools that are available for assistants to use in this thread. |
ExpirationConfig
|
Field |
Description |
|
expiration_policy |
enum ExpirationPolicy
|
|
ttl_days |
int64 |
Tool
Represents a general tool that can be one of several types.
|
Field |
Description |
|
search_index |
SearchIndexTool tool that performs search across specified indexes. Includes only one of the fields |
|
function |
Function tool that can be invoked by the assistant. Includes only one of the fields |
SearchIndexTool
Configures a tool that enables Retrieval-Augmented Generation (RAG) by allowing the assistant to search across a specified search index.
|
Field |
Description |
|
search_index_ids[] |
string A list of search index IDs that this tool will query. Currently, only a single index ID is supported. |
|
max_num_results |
The maximum number of results to return from the search. |
FunctionTool
Represents a function tool that can be invoked by the assistant.
|
Field |
Description |
|
name |
string The name of the function. |
|
description |
string A description of the function's purpose or behavior. |
|
parameters |
A JSON Schema that defines the expected parameters for the function. |
Thread
{
"id": "string",
"folder_id": "string",
"name": "string",
"description": "string",
"default_message_author_id": "string",
"created_by": "string",
"created_at": "google.protobuf.Timestamp",
"updated_by": "string",
"updated_at": "google.protobuf.Timestamp",
"expiration_config": {
"expiration_policy": "ExpirationPolicy",
"ttl_days": "int64"
},
"expires_at": "google.protobuf.Timestamp",
"labels": "map<string, string>",
"tools": [
{
// Includes only one of the fields `search_index`, `function`
"search_index": {
"search_index_ids": [
"string"
],
"max_num_results": "google.protobuf.Int64Value"
},
"function": {
"name": "string",
"description": "string",
"parameters": "google.protobuf.Struct"
}
// end of the list of possible fields
}
]
}
|
Field |
Description |
|
id |
string Unique identifier of the thread. |
|
folder_id |
string ID of the folder that the thread belongs to. |
|
name |
string Name of the thread. |
|
description |
string Description of the thread. |
|
default_message_author_id |
string Default user ID that will be used as the author for thread messages if no other author is specified. |
|
created_by |
string Identifier of the subject who created this thread. |
|
created_at |
Timestamp representing when the thread was created. |
|
updated_by |
string Identifier of the subject who last updated this thread. |
|
updated_at |
Timestamp representing the last time this thread was updated. |
|
expiration_config |
Configuration for the expiration of the thread, defining when and how the thread will expire. |
|
expires_at |
Timestamp representing when the thread will expire. |
|
labels |
object (map<string, string>) Set of key-value pairs that can be used to organize and categorize the thread. |
|
tools[] |
List of tools that are available for assistants to use in this thread. |
ExpirationConfig
|
Field |
Description |
|
expiration_policy |
enum ExpirationPolicy
|
|
ttl_days |
int64 |
Tool
Represents a general tool that can be one of several types.
|
Field |
Description |
|
search_index |
SearchIndexTool tool that performs search across specified indexes. Includes only one of the fields |
|
function |
Function tool that can be invoked by the assistant. Includes only one of the fields |
SearchIndexTool
Configures a tool that enables Retrieval-Augmented Generation (RAG) by allowing the assistant to search across a specified search index.
|
Field |
Description |
|
search_index_ids[] |
string A list of search index IDs that this tool will query. Currently, only a single index ID is supported. |
|
max_num_results |
The maximum number of results to return from the search. |
FunctionTool
Represents a function tool that can be invoked by the assistant.
|
Field |
Description |
|
name |
string The name of the function. |
|
description |
string A description of the function's purpose or behavior. |
|
parameters |
A JSON Schema that defines the expected parameters for the function. |