curl --request GET \
--url https://api.smith.langchain.com/v1/deepagents/agents/{agent_id} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}', 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/agents/{agent_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"permissions": {
"identity": "personal",
"visibility": "tenant",
"tenant_access_level": "read",
"shared_users": {
"read": [
"<string>"
],
"run": [
"<string>"
],
"update": [
"<string>"
]
}
},
"runtime": {
"model": {
"model_id": "claude-sonnet-4-6"
}
},
"extras": {},
"revision": "<string>",
"instructions": "<string>",
"tools": {
"tools": [
{
"name": "<string>",
"mcp_server_url": "<string>",
"mcp_server_name": "<string>",
"display_name": "<string>"
}
],
"interrupt_config": {}
},
"subagents": [
{
"name": "<string>",
"description": "<string>",
"model_id": "<string>",
"instructions": "<string>",
"tools": {
"tools": [
{
"name": "<string>",
"mcp_server_url": "<string>",
"mcp_server_name": "<string>",
"display_name": "<string>"
}
],
"interrupt_config": {}
}
}
],
"skills": [
{
"type": "inline",
"name": "<string>",
"description": "<string>",
"instructions": "<string>",
"files": {}
}
],
"files": {}
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}Return the specified agent, including metadata, permissions, runtime, extras, and the parsed file tree at the latest commit. Pass include_files=true to include the raw file map.
curl --request GET \
--url https://api.smith.langchain.com/v1/deepagents/agents/{agent_id} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}', 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/agents/{agent_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smith.langchain.com/v1/deepagents/agents/{agent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"permissions": {
"identity": "personal",
"visibility": "tenant",
"tenant_access_level": "read",
"shared_users": {
"read": [
"<string>"
],
"run": [
"<string>"
],
"update": [
"<string>"
]
}
},
"runtime": {
"model": {
"model_id": "claude-sonnet-4-6"
}
},
"extras": {},
"revision": "<string>",
"instructions": "<string>",
"tools": {
"tools": [
{
"name": "<string>",
"mcp_server_url": "<string>",
"mcp_server_name": "<string>",
"display_name": "<string>"
}
],
"interrupt_config": {}
},
"subagents": [
{
"name": "<string>",
"description": "<string>",
"model_id": "<string>",
"instructions": "<string>",
"tools": {
"tools": [
{
"name": "<string>",
"mcp_server_url": "<string>",
"mcp_server_name": "<string>",
"display_name": "<string>"
}
],
"interrupt_config": {}
}
}
],
"skills": [
{
"type": "inline",
"name": "<string>",
"description": "<string>",
"instructions": "<string>",
"files": {}
}
],
"files": {}
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}{
"type": "<string>",
"code": "<string>",
"detail": "<string>",
"status": 123
}Authorizations
Path Parameters
Managed Deep Agent ID.
Query Parameters
Include the raw file map in the agent response. Accepted truthy values are true and 1.
Response
Agent returned.
Agent visibility and sharing configuration. When omitted on create, defaults to personal identity, tenant visibility, and read tenant access.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Revision token for the latest file tree commit.
Agent system prompt parsed from AGENTS.md.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Raw file map for paths not covered by typed fields. Keys are relative file paths. Setting a typed field and the corresponding files entry returns 422.
Show child attributes
Show child attributes
Was this page helpful?

