The Agents API lets you create, manage, and chat with agents in your Langdock workspace programmatically. The completions endpoint uses the Vercel AI SDK compatible message format, so you can use agents with the useChat hook and other Vercel AI SDK features.
Before You Start
- API key scope: Agent endpoints require an API key with the
AGENT_API scope. The attachment endpoints require the KNOWLEDGE_FOLDER_API scope.
- Agent access: To use an existing agent with an API key, the agent must be shared with that key. See Sharing Agents with API Keys.
- Legacy Assistants API: This is the new Agents API with native Vercel AI SDK compatibility. If you’re using the legacy Assistants API, see the migration guide.
Base URL
Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.
Available Endpoints
Agents
Attachments
Guides
