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

# Headless Fleet API reference

> REST API reference for building and running agents with the LangSmith Headless Fleet API.

The Headless Fleet API is a headless interface for building and running agents: create and configure agents, manage their connections and secrets, run threads, and wire up triggers.

<Info>
  This overview is in progress. For full request and response details, use the generated endpoint references in this section.
</Info>

## Set the base path

Paths are service-native, such as `/v1/fleet/agents`. Self-hosted deployments reach them through the gateway under an `/api` prefix, such as `/api/v1/fleet/agents`.

## Authenticate requests

Every request must carry one credential:

* **`X-Api-Key`**: A LangSmith API key (`lsv2_...`).
* **`Authorization`**: A session JWT, sent as `Bearer <token>`.

Workspace-scoped endpoints also require the **`X-Tenant-Id`** header, set to the workspace (tenant) UUID the request operates in. Organization- and identity-scoped endpoints omit it.

## Browse resource groups

The API is organized into the following resource groups:

* Agents
* Agent connections
* Threads
* Skills
* Auth
* Integrations
* Secrets
* Models
* Tenants
* Users

***

<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/headless-fleet-api-overview.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>