curl --request POST \
--url https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"agent_id": "11111111-1111-1111-1111-111111111111",
"messages": [
{
"role": "user",
"content": "Research recent approaches to agent memory and summarize the main tradeoffs."
}
],
"stream_mode": [
"updates"
],
"stream_subgraphs": true,
"user_timezone": "America/Los_Angeles"
}
'import requests
url = "https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream"
payload = {
"agent_id": "11111111-1111-1111-1111-111111111111",
"messages": [
{
"role": "user",
"content": "Research recent approaches to agent memory and summarize the main tradeoffs."
}
],
"stream_mode": ["updates"],
"stream_subgraphs": True,
"user_timezone": "America/Los_Angeles"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: '11111111-1111-1111-1111-111111111111',
messages: [
{
role: 'user',
content: 'Research recent approaches to agent memory and summarize the main tradeoffs.'
}
],
stream_mode: ['updates'],
stream_subgraphs: true,
user_timezone: 'America/Los_Angeles'
})
};
fetch('https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream', 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.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent_id' => '11111111-1111-1111-1111-111111111111',
'messages' => [
[
'role' => 'user',
'content' => 'Research recent approaches to agent memory and summarize the main tradeoffs.'
]
],
'stream_mode' => [
'updates'
],
'stream_subgraphs' => true,
'user_timezone' => 'America/Los_Angeles'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>"
],
]);
$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.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream"
payload := strings.NewReader("{\n \"agent_id\": \"11111111-1111-1111-1111-111111111111\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Research recent approaches to agent memory and summarize the main tradeoffs.\"\n }\n ],\n \"stream_mode\": [\n \"updates\"\n ],\n \"stream_subgraphs\": true,\n \"user_timezone\": \"America/Los_Angeles\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
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.post("https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"11111111-1111-1111-1111-111111111111\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Research recent approaches to agent memory and summarize the main tradeoffs.\"\n }\n ],\n \"stream_mode\": [\n \"updates\"\n ],\n \"stream_subgraphs\": true,\n \"user_timezone\": \"America/Los_Angeles\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"11111111-1111-1111-1111-111111111111\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Research recent approaches to agent memory and summarize the main tradeoffs.\"\n }\n ],\n \"stream_mode\": [\n \"updates\"\n ],\n \"stream_subgraphs\": true,\n \"user_timezone\": \"America/Los_Angeles\"\n}"
response = http.request(request)
puts response.read_bodyStream a thread run
Start a run on a thread and stream output as server-sent events. The request must use agent_id; assistant_id is reserved for server-side forwarding and is rejected.
curl --request POST \
--url https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"agent_id": "11111111-1111-1111-1111-111111111111",
"messages": [
{
"role": "user",
"content": "Research recent approaches to agent memory and summarize the main tradeoffs."
}
],
"stream_mode": [
"updates"
],
"stream_subgraphs": true,
"user_timezone": "America/Los_Angeles"
}
'import requests
url = "https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream"
payload = {
"agent_id": "11111111-1111-1111-1111-111111111111",
"messages": [
{
"role": "user",
"content": "Research recent approaches to agent memory and summarize the main tradeoffs."
}
],
"stream_mode": ["updates"],
"stream_subgraphs": True,
"user_timezone": "America/Los_Angeles"
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: '11111111-1111-1111-1111-111111111111',
messages: [
{
role: 'user',
content: 'Research recent approaches to agent memory and summarize the main tradeoffs.'
}
],
stream_mode: ['updates'],
stream_subgraphs: true,
user_timezone: 'America/Los_Angeles'
})
};
fetch('https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream', 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.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent_id' => '11111111-1111-1111-1111-111111111111',
'messages' => [
[
'role' => 'user',
'content' => 'Research recent approaches to agent memory and summarize the main tradeoffs.'
]
],
'stream_mode' => [
'updates'
],
'stream_subgraphs' => true,
'user_timezone' => 'America/Los_Angeles'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>"
],
]);
$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.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream"
payload := strings.NewReader("{\n \"agent_id\": \"11111111-1111-1111-1111-111111111111\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Research recent approaches to agent memory and summarize the main tradeoffs.\"\n }\n ],\n \"stream_mode\": [\n \"updates\"\n ],\n \"stream_subgraphs\": true,\n \"user_timezone\": \"America/Los_Angeles\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
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.post("https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"11111111-1111-1111-1111-111111111111\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Research recent approaches to agent memory and summarize the main tradeoffs.\"\n }\n ],\n \"stream_mode\": [\n \"updates\"\n ],\n \"stream_subgraphs\": true,\n \"user_timezone\": \"America/Los_Angeles\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smith.langchain.com/v1/deepagents/threads/{threadID}/runs/stream")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"11111111-1111-1111-1111-111111111111\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Research recent approaches to agent memory and summarize the main tradeoffs.\"\n }\n ],\n \"stream_mode\": [\n \"updates\"\n ],\n \"stream_subgraphs\": true,\n \"user_timezone\": \"America/Los_Angeles\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Path Parameters
Thread ID.
Body
Managed Deep Agent ID. The server forwards this upstream as assistant_id.
Input messages for the run.
1Show child attributes
Show child attributes
Stream modes to return.
values, updates, messages-tuple Whether to stream subgraph events.
IANA timezone name (for example, America/Los_Angeles) for this run. The runtime uses it to inject a localized current-date line into the agent's system prompt, so the agent reasons about dates in the user's local time. Optional. Defaults to the timezone stamped on the agent (or UTC if none was set); invalid values fall back to UTC.
"America/Los_Angeles"
Response
Server-sent event stream.
The response is of type string.
Was this page helpful?

