> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-lsapi-1779323176-451247e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Note>
  Managed Deep Agents is in private preview. [Join the waitlist](https://www.langchain.com/langsmith-managed-deep-agents-waitlist) to request access. For usage guidance, see [Deploy Managed Deep Agents](/langsmith/deploy-managed-deep-agent).
</Note>

For an end-to-end workflow with request examples, see [Deploy Managed Deep Agents](/langsmith/deploy-managed-deep-agent).

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:

```txt theme={null}
X-Api-Key: <LANGSMITH_API_KEY>
```

## Base route

The private preview API uses `/v1/deepagents`.

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](/langsmith/deploy-managed-deep-agent#api-stability) for breaking-change communication.

## 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 is available on LangSmith Cloud in the US region only during private preview. Self-hosted and Hybrid deployments are not supported, and EU and other regions will follow general availability.

The API also does not mirror every LangSmith Deployment endpoint in private preview. Endpoint groups such as integrations, auth, triggers, skills, and sandboxes are not mirrored yet.

For operational notes — supported models, thread retention, rate limits, SDK availability, and support channels during preview — see [Limits and notes](/langsmith/deploy-managed-deep-agent#limits-and-notes) in the deploy guide.

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/managed-deep-agents-api.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>