Skip to main content

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.

The Managed Deep Agents API is a private preview API for creating, updating, connecting, and invoking Managed Deep Agents. Use the API when you need a custom client, automation that cannot shell out to the CLI, or direct control over request payloads.
Managed Deep Agents is in private preview. Join the waitlist to request access. For the recommended end-to-end workflow, see the quickstart.
The generated endpoint reference pages appear under LangSmith > Reference > LangSmith Deployment > Managed Deep Agents API in the sidebar.

​
Set request defaults

The private preview API uses /v1/deepagents: 
export LANGSMITH_API_KEY="<LANGSMITH_API_KEY>"
export LANGSMITH_API_URL="https://api.smith.langchain.com"
export DEEPAGENTS_BASE_URL="$LANGSMITH_API_URL/v1/deepagents"
Requests require the X-Api-Key header: 
X-Api-Key: <LANGSMITH_API_KEY>

​
Configure sandboxes

Create and update agent payloads can include a backend object. Use default when the agent does not need sandbox-specific backend behavior: 
{
  "backend": {
    "type": "default"
  }
}
Use thread_scoped_sandbox or agent_scoped_sandbox when the agent needs a LangSmith sandbox for code execution, filesystem work, or long-running tasks. Sandbox backend settings live under backend.sandbox and are valid only when backend.type is thread_scoped_sandbox or agent_scoped_sandbox: 
{
  "backend": {
    "type": "thread_scoped_sandbox",
    "sandbox": {
      "policy_ids": ["policy-id"],
      "idle_ttl_seconds": 900,
      "delete_after_stop_seconds": 300
    }
  }
}
For backend guidance, see Deploy an agent. For standalone sandbox concepts, see the LangSmith sandboxes overview.

​
Use common REST commands

TaskEndpoint referenceGuide
Create an agentPOST /v1/deepagents/agentsDeploy an agent
List agentsGET /v1/deepagents/agentsDeploy an agent
Get an agentGET /v1/deepagents/agents/{agent_id}Deploy an agent
Update an agentPATCH /v1/deepagents/agents/{agent_id}Deploy an agent
Delete an agentDELETE /v1/deepagents/agents/{agent_id}Limits and notes
Create a threadPOST /v1/deepagents/threadsRun an agent
Search threadsPOST /v1/deepagents/threads/searchRun an agent
Count threadsPOST /v1/deepagents/threads/countRun an agent
Get a threadGET /v1/deepagents/threads/{thread_id}Run an agent
Start a thread runPOST /v1/deepagents/threads/{thread_id}/runsRun an agent
Stream a thread runPOST /v1/deepagents/threads/{thread_id}/runs/streamRun an agent
Resolve an interruptPOST /v1/deepagents/threads/{threadID}/resolve-interruptRun an agent
Create an MCP serverPOST /v1/deepagents/mcp-serversConnect tools
List MCP serversGET /v1/deepagents/mcp-serversConnect tools
Get an MCP serverGET /v1/deepagents/mcp-servers/{mcp_server_id}Connect tools
Update an MCP serverPATCH /v1/deepagents/mcp-servers/{mcp_server_id}Connect tools
Delete an MCP serverDELETE /v1/deepagents/mcp-servers/{mcp_server_id}Connect tools
List MCP toolsGET /v1/deepagents/mcp/toolsConnect tools
Register an OAuth providerPOST /v1/deepagents/mcp-servers/{mcp_server_id}/oauth-providerConnect tools
Start an auth sessionPOST /v1/deepagents/auth-sessionsConnect tools
Get an auth sessionGET /v1/deepagents/auth-sessions/{session_id}Connect tools

​
Understand resource groups

Resource groupPurpose
AgentsCreate and manage Managed Deep Agent resources, including runtime and backend configuration.
ThreadsCreate and manage durable thread state for Managed Deep Agents.
RunsStart and stream Managed Deep Agent runs on threads.
MCP serversRegister MCP servers and store credentials referenced by agent tools.
MCP toolsList tools exposed by a registered MCP server so clients can build tools.json entries.
Auth sessionsStart and poll user OAuth sessions for OAuth MCP servers.
Managed Deep Agents are not LangSmith Deployments. Creating a Managed Deep Agent creates a Managed Deep Agent resource, a separate LangSmith tracing project, and a Context Hub agent repo for the managed file tree.

​
API stability

Routes are versioned at /v1/, but the surface is in private preview and may change in backwards-incompatible ways before general availability. See API stability for breaking-change communication. The API does not mirror every LangSmith Deployment endpoint in private preview. Endpoint groups such as integrations, triggers, skills, sandboxes, auth providers, and auth tokens are not mirrored yet.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.