| description | Setup instructions for Currents integration with Linear |
|---|
You need:
- A Linear workspace
- Currents organization admin permissions
| Scope | Behavior |
|---|---|
| Organization | One Linear workspace connection per Currents organization |
| Project | Enable or disable the integration per Currents project |
Multiple Currents projects can share the same workspace connection.
- In Currents, go to Project > Integrations
- Select Linear App, then Add Integration
- Click Connect Linear App
- Approve the OAuth request in Linear
- Return to Currents and confirm the workspace appears as connected
Starting the OAuth connection
{% hint style="info" %} Only organization admins can connect, disconnect, or change settings. Other members can view connection status. {% endhint %}
After the workspace is connected, turn the integration on for each project that should use it:
- Open Project > Integrations > Linear App
- If prompted, click Enable for this project
- Turn on Enable Linear Integration
- Click Save Configuration
If the workspace is already connected at the organization level, you can enable the current project without repeating OAuth.
{% hint style="success" %} You're all set. After connecting and enabling the integration for your project, the Linear workspace appears on the integration page. {% endhint %}
Organization admins can remove the workspace connection from Project > Integrations > Linear App:
- Click Disconnect
- Confirm
This revokes Linear permissions and disables the integration for every project that used the connection.
If you disconnected the integration and want to connect the same workspace again:
- Go to Project > Integrations > Linear App
- Click Re-authenticate
- Approve the OAuth request in Linear
Per-project settings are preserved when you reconnect.