An admin needs to create the API key and share the assistant with it. If you’re not an admin, invite one as an editor to your assistant using the “Share” button.
How to create an API key
-
Navigate to Langdock and open the workspace settings from the dropdown menu.
-
Click on API under Products in the sidebar.
-
Click Create API key, enter a name, select the required scopes (at minimum “Agent API”), and confirm.
-
Copy your API key and store it securely. You won’t be able to view it again.
How to share an assistant with the API key
-
Navigate to Agents in the sidebar.
-
Create a new assistant or select an existing one. Enter at least a name to save it.
-
In the assistant editor, click the Share button in the top right corner.
-
The share dialog opens showing current access settings.
-
Search for your API key by name and add it to share the assistant with the API.
Only admins can connect an assistant with an API key. If you don’t see API keys in the share menu, ask an admin to perform this step.
Testing the API connection
Once shared, you can test your assistant via the Assistant API documentation. Use your API key and the assistant ID from the URL (https://app.langdock.com/assistants/ASSISTANT_ID/edit).
Migrating to Agents API
For new projects, we recommend using the Agents API instead:- Agent API Guide - Setup guide for the Agents API
- Full migration guide - Learn about the differences
Langdock blocks browser-origin requests to protect your API key. For more information, see our guide on API Key Best Practices.