curl --request PUT \
--url https://api.example.com/api/chat/threads/{thread_id}/subject \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "<string>",
"label": "<string>"
}
'import requests
url = "https://api.example.com/api/chat/threads/{thread_id}/subject"
payload = {
"id": "<string>",
"label": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({id: '<string>', label: '<string>'})
};
fetch('https://api.example.com/api/chat/threads/{thread_id}/subject', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/chat/threads/{thread_id}/subject",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => '<string>',
'label' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/chat/threads/{thread_id}/subject"
payload := strings.NewReader("{\n \"id\": \"<string>\",\n \"label\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.example.com/api/chat/threads/{thread_id}/subject")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"<string>\",\n \"label\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/chat/threads/{thread_id}/subject")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"<string>\",\n \"label\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "regular",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"created_by": "<string>",
"can_post": true,
"can_manage": true,
"can_share": true,
"title": "<string>",
"workspace_id": "<string>",
"instructions": "<string>",
"defaults": {
"trino_catalog": "<string>",
"trino_schema": "<string>",
"datahub_domain": "<string>",
"decisions_workspace": "<string>"
},
"subject": {
"type": "dataeng_query",
"id": "<string>",
"label": "<string>"
}
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}Move a chat onto the item it produced
Re-binds a chat started for a new transform to the query it saved, so the same conversation carries on beside the saved item.
curl --request PUT \
--url https://api.example.com/api/chat/threads/{thread_id}/subject \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "<string>",
"label": "<string>"
}
'import requests
url = "https://api.example.com/api/chat/threads/{thread_id}/subject"
payload = {
"id": "<string>",
"label": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({id: '<string>', label: '<string>'})
};
fetch('https://api.example.com/api/chat/threads/{thread_id}/subject', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/chat/threads/{thread_id}/subject",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => '<string>',
'label' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/chat/threads/{thread_id}/subject"
payload := strings.NewReader("{\n \"id\": \"<string>\",\n \"label\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.example.com/api/chat/threads/{thread_id}/subject")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"<string>\",\n \"label\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/chat/threads/{thread_id}/subject")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"<string>\",\n \"label\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "regular",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"created_by": "<string>",
"can_post": true,
"can_manage": true,
"can_share": true,
"title": "<string>",
"workspace_id": "<string>",
"instructions": "<string>",
"defaults": {
"trino_catalog": "<string>",
"trino_schema": "<string>",
"datahub_domain": "<string>",
"decisions_workspace": "<string>"
},
"subject": {
"type": "dataeng_query",
"id": "<string>",
"label": "<string>"
}
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}{
"error": "<string>",
"code": 500
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
Body
Move a chat onto the item it produced — a new transform onto its query.
The item's kind.
dataeng_query, dataeng_new, semantic_model, semantic_new, decision, data_access, registry_agent_test, dq_table, dq_new, function, function_new, ontology, ontology_new, feature_engineering, feature_engineering_new, airouter_builder, maintenance, spark_app The item's id.
1 - 200200Response
Successful Response
A chat thread as the thread list shows it, with what you may do with it.
Thread ID.
Active or archived.
regular, archived When the thread was created.
Last activity in the thread.
Who started the thread.
Whether you can send messages in it.
Whether you can rename, archive or delete it.
Whether you can create share links for it.
Display title; null until the first message.
The workspace the thread belongs to; null for a personal thread.
Standing instructions for the assistant, as Markdown. Added to the base prompt, never replacing it, and added to rather than replacing any the workspace sets. Cannot change which tools exist or which need approval.
What the assistant reaches for first in this thread.
Show child attributes
Show child attributes
The item this thread is about, if it is bound to one.
Show child attributes
Show child attributes
Was this page helpful?

