Join us May 13th & May 14th at Interrupt, the Agent Conference by LangChain. Buy tickets >
curl --request PATCH \
--url https://api.smith.langchain.com/v1/deepagents/agents/{agent_id} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"description": "Research assistant that searches the web, reads URLs, and summarizes sources.",
"instructions": "You are a careful research assistant. Search for sources, read relevant pages, keep notes, and return concise answers with citations.",
"tools": {
"tools": [
{
"name": "tavily_web_search",
"mcp_server_url": "https://tools.langchain.com",
"mcp_server_name": "Fleet",
"display_name": "tavily_web_search"
},
{
"name": "read_url_content",
"mcp_server_url": "https://tools.langchain.com",
"mcp_server_name": "Fleet",
"display_name": "read_url_content"
}
],
"interrupt_config": {
"https://tools.langchain.com::tavily_web_search::Fleet": true,
"https://tools.langchain.com::read_url_content::Fleet": false
}
}
}
'{
"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": {}
}Update the specified agent. Top-level scalar fields merge field-by-field. Nested objects such as runtime, permissions, tools, subagents, skills, and extras are replaced in full when provided. Providing file-tree fields such as instructions, tools, subagents, skills, or files creates a new file tree commit.
curl --request PATCH \
--url https://api.smith.langchain.com/v1/deepagents/agents/{agent_id} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"description": "Research assistant that searches the web, reads URLs, and summarizes sources.",
"instructions": "You are a careful research assistant. Search for sources, read relevant pages, keep notes, and return concise answers with citations.",
"tools": {
"tools": [
{
"name": "tavily_web_search",
"mcp_server_url": "https://tools.langchain.com",
"mcp_server_name": "Fleet",
"display_name": "tavily_web_search"
},
{
"name": "read_url_content",
"mcp_server_url": "https://tools.langchain.com",
"mcp_server_name": "Fleet",
"display_name": "read_url_content"
}
],
"interrupt_config": {
"https://tools.langchain.com::tavily_web_search::Fleet": true,
"https://tools.langchain.com::read_url_content::Fleet": false
}
}
}
'{
"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": {}
}Documentation Index
Fetch the complete documentation index at: https://docs.langchain.com/llms.txt
Use this file to discover all available pages before exploring further.
User timezone for runtime configuration stamping. Defaults to UTC when omitted.
"America/Los_Angeles"
Managed Deep Agent ID.
Include the raw file map in the agent response. Accepted truthy values are true and 1.
Sparse update payload. Omitted fields are left unchanged.
Updated agent name.
Updated agent description.
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
Updated agent system prompt. Triggers a new file tree commit.
Show child attributes
Updated subagent definitions. Replaces the existing subagents field in full.
Show child attributes
Updated inline skills. Replaces the existing skills field in full.
Show child attributes
Updated caller-defined metadata. Replaces the existing extras field in full.
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
Agent updated.
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
Revision token for the latest file tree commit.
Agent system prompt parsed from AGENTS.md.
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
Was this page helpful?