Managed Deep Agents API

Reference overview for the Managed Deep Agents private preview API.

The Managed Deep Agents API is a private preview API for creating, updating, and invoking Managed Deep Agents.

Managed Deep Agents is in private preview. Join the waitlist to request access. For usage guidance, see Deploy Managed Deep Agents.

For an end-to-end workflow with request examples, see Deploy Managed Deep Agents.

Browse the Managed Deep Agents API reference pages in the sidebar. The generated reference includes:

• Agents: Create, list, get, update, and delete Managed Deep Agents.
• Threads: Create, search, count, and inspect durable thread state.
• Runs: Start and stream runs on Managed Deep Agent threads.

Authentication

Requests require a LangSmith API key for a workspace with Managed Deep Agents private preview access. Pass the key with each request:

X-Api-Key: <LANGSMITH_API_KEY>

Base route

The private preview API uses /v1/deepagents.

Resource groups

Resource group	Purpose
Agents	Create and manage Managed Deep Agent resources.
Threads	Create and manage durable thread state for Managed Deep Agents.
Runs	Start and stream Managed Deep Agent runs on threads.

Private preview scope

Managed Deep Agents does not mirror every LangSmith Deployment endpoint in private preview. Endpoint groups such as integrations, auth, triggers, skills, and sandboxes 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.