How to connect to Linear Multiworkspace
Linear Multiworkspace is a variant of the Linear connector that uses API Key authentication instead of OAuth. It exists to support use cases where your users need to connect multiple Linear workspaces — since OAuth apps in Linear are scoped to a single workspace, API Keys offer a simpler way to connect each workspace independently without requiring a separate OAuth application per workspace.
If your users only operate in a single Linear workspace, the standard Linear connector using OAuth may be sufficient. Use this connector when multi-workspace support is a requirement.
Creating an API Key
Linear supports API Key authentication, which is the supported auth type by Apideck if you're looking to build an integration with Linear that can be used by other companies.
Prerequisites
Before you begin, make sure you have the following:
- A Linear account - You can sign up here.
- An Apideck account
1. Log in to Linear
After you have signed up for a Linear, you can log in to Linear to create an "API Key".
2. Create a new API Key
Using the following link you can create a new API Key. Enter a name for the API Key and "Full access" for Permissions and "All teams you have access to" for Team access.
Copy the generated API Key immediately. You won't be able to see it again.
3. Workspace Selection
If you belong to multiple Linear workspaces, the API key is scoped to the workspace you are currently logged into when creating it. Make sure you are in the correct workspace before generating the key.
To switch workspaces in Linear:
- Click on the workspace name in the top-left corner.
- Click on "Switch workspace"
- Select the workspace you want to connect or create a new one.
- Then follow the steps above to create a new API key for that workspace.
4. Vault Connection Setup
Paste your API Key in the API Key field and click Save.
You're connected now.
Start building with the Linear API
Learn what else you can build with the Linear API.
Interested in a personalized demo? Let us know.