Date: 2026-05-11 Researcher: Claude (api-integration-research skill) Source URL: https://langdock.com/de/products/api
Langdock is a Berlin-based, GDPR-compliant AI gateway that proxies major LLM providers (OpenAI, Anthropic, Google, Mistral) through an EU-hosted layer plus its own product surface (chat, agents, knowledge folders, workflows). For Orcha there are three viable integration angles:
Angle 1 is the lowest-effort, customer-visible play. Angle 2 is the strategic play (Orcha-as-a-tool inside a customer's existing AI portal).
| Capability | Public API | iPaaS | Webhooks | MCP | Verdict |
|---|---|---|---|---|---|
| Chat completion (OpenAI-format) | YES | YES (Make) | n/a | n/a | Available now |
| Chat completion (Anthropic-format) | YES | YES (Make) | n/a | n/a | Available now |
| Chat completion (Google/Mistral) | YES | YES (Make Codestral) | n/a | n/a | Available now |
| Embeddings | YES (OpenAI-format) | YES (Make generic) | n/a | n/a | Available now |
| Create/manage agents | YES | NO | n/a | n/a | Available now |
| Invoke agent programmatically | YES (Agents API) | NO | n/a | YES (ask_agent) |
Available now |
| Upload files to knowledge folder | YES (POST /knowledge/{folderId}) |
NO | n/a | n/a | Available now |
| Search knowledge folder (RAG) | YES (POST /knowledge/search) |
NO | n/a | n/a | Available now |
| Manage integrations/actions programmatically | YES | NO | n/a | n/a | Available now |
| Trigger workflow from external system | n/a | n/a | YES (per-workflow URL) | n/a | Available now |
| Receive events out of Langdock | NO native outbound | n/a | NO | n/a | Not available — pull only |
| User management (invite/activate) | YES | NO | n/a | n/a | Available now |
| Audit logs / usage export | YES | NO | n/a | n/a | Available now |
| Langdock as MCP server (call from external AI) | n/a | n/a | n/a | YES (api.langdock.com/mcp) |
Available now |
https://api.langdock.com<deployment-url>/api/public/openai/eu/, /openai/us/, /anthropic/eu/, etc. — region is part of the path, not the host.docs.langdock.com/llms.txt)Authorization: Bearer <KEY>) or x-api-key header (MCP)No first-party SDK. Langdock explicitly recommends using the vendor's official SDK with a custom base_url:
# Anthropic SDK pointing at Langdock EU
client = Anthropic(
base_url="https://api.langdock.com/anthropic/eu/",
api_key="<LANGDOCK_API_KEY>"
)
// OpenAI SDK pointing at Langdock EU
const provider = createOpenAI({
baseURL: "https://api.langdock.com/openai/eu/v1",
apiKey: process.env.LANGDOCK_API_KEY,
});
Vercel AI SDK is mentioned as natively compatible for the Agents API.
The OpenAI-compatible endpoint accepts everything except: n, service_tier, parallel_tool_calls, stream_options. Most are not relevant for Orcha's extraction workloads.
Not documented on the Anthropic-compatible endpoint. Orcha doesn't use caching today (per MEMORY.md), but if we adopt it on the direct Anthropic API we should retest whether Langdock passes cache_control blocks through to upstream. Confidence: low — needs empirical verification.
Write capability confirmed across all relevant data objects:
| Object | Endpoint | Method | Evidence |
|---|---|---|---|
| Agent | /api-endpoints/agent/agent-create |
POST | Direct doc page |
| Agent attachment | /api-endpoints/agent/upload-attachments |
POST | Direct doc page |
| Knowledge folder file | /knowledge/{folderId} |
POST (multipart) | Sample response with att_* IDs |
| Knowledge folder file | /knowledge/{folderId}/upload-async |
POST | Async variant for large files (up to 256 MB) |
| Integration / action / trigger | /api-endpoints/integrations/create-* |
POST | Documented CRUD set |
| User | /api-endpoints/user-management/invite |
POST | Documented |
| Chat / message | /openai/eu/v1/chat/completions, /anthropic/eu/v1/messages |
POST | Provider-compatible |
These are real writes (creating records), not POST-shaped reads. Confidence: high.
4 actions, no triggers:
Use case for Orcha: customers can wire Langdock into Make scenarios alongside Orcha-touched tools. The generic "Make an API Call" module means any of the agent/knowledge/integration endpoints are reachable from Make even without a dedicated module.
baseURL as a compatibility hack. Not officially supported; minor features (e.g. unsupported OpenAI params) break.Langdock ships 754+ native actions across: Slack, Teams, Gmail, Outlook, Google Drive/Docs/Sheets, OneDrive, SharePoint, Notion, Confluence, Jira, Asana, Linear, Monday, Salesforce, HubSpot, Stripe, Zendesk, BigQuery, Snowflake, Databricks, Metabase, Looker, Power BI, Tableau, GitHub, ElevenLabs, DeepL, ServiceNow, Personio, Ashby, Airtable, Calendly, Luma, Pinecone, Qdrant, Milvus, Vertex AI, Azure AI Search, AWS Kendra.
Orcha is not listed. Building a native Langdock integration (or MCP server) would be net-new.
| Channel | Available | Notes |
|---|---|---|
| Webhooks (inbound, trigger workflow) | YES | https://app.langdock.com/api/hooks/workflows/<WORKFLOW_ID> — header auth (X-Webhook-Secret), query auth, or none. Returns to caller if "Wait for response" is enabled. |
| Webhooks (outbound, event push) | NO | No notification of agent/run/document events to external systems via outbound webhook surfaced |
| MCP — Langdock as server | YES | https://api.langdock.com/mcp, Bearer or x-api-key. Exposes find_agent, ask_agent, ask_custom_agent tools |
| MCP — Langdock as client | YES | Any third-party MCP server can be added; supports no-auth, API key, OAuth 2.0 with/without DCR |
| A2A protocol | YES (referenced) | Google ADK A2A demo repo published by Langdock org on GitHub |
| SFTP / file drop | NO | Not relevant — not that kind of vendor |
| Unified APIs (Merge/Finch etc.) | NO | Not a connector target on common unified-API platforms |
| Plan | Price | Includes API? |
|---|---|---|
| Trial | Free 7 days + €5 model credits | Yes (limited) |
| Business (Chat & Agents) | €25/user/mo standard, €99/user/mo Max | Platform only — API billed separately |
| Enterprise | Custom, 1,000+ users | API billed separately |
| Workflows add-on | €119/mo (Pro) → €1,199/mo (Business 100k runs) | Requires active Chat & Agents subscription |
| API | Pure usage-based, 10% markup on provider rates | No seat minimum |
| Requirement | Detail |
|---|---|
| Workspace subscription | Required to provision API keys — minimum 50 seats on Business plan (volume tiers at 50/251/551+ users). Trial works for evaluation. |
| API add-on | Pay-as-you-go on top of seats. No minimum commitment. |
| API key creation | Workspace admin generates keys in settings; per-key scopes (Completion, Embedding, Agent) |
| Browser CORS | Server-side calls only by default — frontend → Langdock direct is blocked |
The proposition: For German/Swiss customers who want EU data residency on LLM calls, point Orcha's workers/llm.clj at Langdock instead of api.anthropic.com.
What changes in Orcha:
base_url → https://api.langdock.com/anthropic/eu/messages, system, max_tokens, tools, tool_choice, thinking, temperature) supportedUnverified gaps:
cache_control blocks if Orcha turns caching onacquisition_llm_stat shapeConfidence: high that the technical swap works. Medium on caching and latency until tested.
The proposition: Customer uses Langdock as their company AI portal. We expose Orcha as either an MCP server or a Langdock-native action so an employee chatting in Langdock can say "pull all unpaid invoices from supplier X" and Langdock's agent calls Orcha.
Two implementation paths:
create-integration API to register custom actions/triggers, but the integration must be listed via Langdock partnership for general availability. Better visibility, more lock-in.Capabilities to expose:
find_supplier_invoices (read)get_invoice_status (read)approve_invoice (write — needs careful scoping)push_invoice_to_erp (write)search_documents (read — leverages Orcha's semantic search)Confidence: high that MCP path is feasible. Effort: build + host an MCP server fronting Orcha's existing API + handle OAuth.
The proposition: Customer builds a workflow in Langdock that, e.g., processes inbound supplier emails, drafts a categorization, and pushes the result to Orcha. The workflow ends in an HTTP Request node calling an Orcha endpoint.
What works today: Langdock workflows have an HTTP Request node — they can call any Orcha endpoint without us building anything. Conversely, Orcha could call a Langdock workflow's webhook trigger.
Confidence: high — no integration work needed, but also lowest strategic value (customer-side glue, not an Orcha product capability).
| Orcha need | Langdock endpoint | Confidence |
|---|---|---|
| Send Anthropic prompt with tools | POST /anthropic/eu/v1/messages |
High |
| Send OpenAI prompt with tools | POST /openai/eu/v1/chat/completions |
High |
| Get embeddings | POST /openai/eu/v1/embeddings (inferred) |
Medium — endpoint exists, schema not fetched |
| Verify prompt caching works | none documented | Low — needs test |
| Track cost per customer | Usage Export CSV (per-API-key) | High |
| Expose Orcha tools to Langdock users | MCP server (Orcha-built) at custom URL | High |
| Receive Langdock-side events | none — Langdock has no outbound webhooks | Not possible without polling |
| Trigger Orcha from a Langdock workflow | HTTP Request node in workflow | High (no work) |
If the goal is EU GDPR story for Orcha customers (most likely):
Phase 1 — proof of concept (1–2 days)
cache_control blocks pass through (when we eventually adopt caching)Phase 2 — config switch (1 week)
:provider :anthropic-via-langdock option in workers/llm.clj with separate base URL + keyacquisition_llm_stat (or model after it)Phase 3 — sales packaging
If the goal is strategic distribution (longer-term play):
Build an Orcha MCP server that exposes the customer-relevant invoice/document operations. Test it first via Claude Desktop, then submit to Langdock's MCP directory. This makes Orcha usable from inside any AI portal — Langdock, Claude, Cursor, ChatGPT — not just one.
What I would NOT do: