Agent Server API reference for LangSmith Deployment ↗

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 Agent Server API reference is available within each deployment at the /docs endpoint (e.g. http://localhost:8124/docs).

Browse the full API reference in the Agent Server API section in the sidebar, or see the endpoint groups below:

• Assistants - Configured instances of a graph
• Threads - Accumulated outputs of a group of runs
• Thread Runs - Invocations of a graph/assistant on a thread
• Stateless Runs - Invocations with no state persistence
• Crons - Periodic runs on a schedule
• Store - Persistent key-value store for long-term memory
• A2A - Agent-to-Agent Protocol endpoints
• MCP - Model Context Protocol endpoints
• System - Health checks and server info

Authentication#

For deployments to LangSmith, authentication is required. Pass the X-Api-Key header with each request to the Agent Server. The value of the header should be set to a valid LangSmith API key for the organization where the Agent Server is deployed.

Example curl command:

curl --request POST \
  --url http://localhost:8124/assistants/search \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: LANGSMITH_API_KEY' \
  --data '{
  "metadata": {},
  "limit": 10,
  "offset": 0
}'

Edit this page on GitHub or file an issue.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.