Data sync
Unblocked receives updates from Linear in real time through webhooks, so new and updated issues and comments appear in answers shortly after they change. A scheduled sync also runs every 12 hours as a backstop to catch anything a webhook may have missed.Connect your Linear workspace
Sign in to Unblocked
Whether you sign in with a source code manager or your SSO provider, you first need to authenticate to Unblocked. Once you’ve signed in, click Settings in the sidebar, then Data Sources. Click Connect Another and select Linear. From there, you’ll be redirected to Linear to sign in. Then, you’ll be asked to install the Unblocked workspace app. A Linear workspace admin must approve the installation.Connect Unblocked to Linear
Make sure you have selected the correct Linear workspace from the top left menu, then approve the installation. You will then be redirected back to Unblocked, where you can select the teams you want Unblocked to access. We recommend providing access to All Teams in your Linear workspace. If you would like to select Specific Teams in Linear, Unblocked will use only those selected teams to answer the questions you ask.
Create issues and comments
Ask Unblocked in chat to create a Linear issue or add a comment to an existing issue. Explicitly ask it to publish the content. Unblocked does not write to Linear without that request. All issues and comments created through Unblocked use the workspace app. Linear shows the author as the Unblocked app or as your verified Linear name “via Unblocked”. The app does not take over your own Linear permissions. To write to Linear, you must meet all of these requirements.- You are a current member of the Unblocked team.
- You have exactly one linked Linear identity for that workspace. You do not need your own personal Linear token.
- You are a regular, active member of the Linear workspace. Guests are not supported.
- The target team is active, connected to Unblocked, and included in the data source preset used for your chat.
- You belong to the target team, or it is a public, top-level team that allows all members to join. Private teams and sub-teams require explicit membership.
Reconnect the workspace app
If the Linear settings page shows Reconnect Linear write access, the app’s access was revoked, expired, or is missing permissions. Click Reconnect workspace app and have a Linear workspace admin approve the authorization again. If you are not an Unblocked admin, click View Admins in the banner to find your team’s admins. Ask an admin to reconnect the app.Troubleshooting
Chat does not offer Linear issue or comment creation
Open the Linear settings page. If you see Enable Linear write access or Reconnect Linear write access, ask an Unblocked admin to install or reconnect the app.The app is connected, but you cannot create an issue or comment
Ask your admins to check your linked Linear account and access against the requirements above. If the target team is excluded from your chat’s data source preset, select a preset that includes it. If an issue is archived or deleted, choose another issue for your comment.The workspace app connection fails
If you see “There was an error connecting the Linear workspace app. Please contact support for further assistance.”, contact support.Upgrade a personal Linear connection
Workspaces connected before the Unblocked workspace app use a personal Linear account. A personal connection can only read, so Unblocked cannot create issues or comments, and routines cannot use Linear triggers. Upgrade to the workspace app to add write access. Your existing connection, team selection, and data sync stay in place.- In Unblocked, click Settings in the sidebar, then Data Sources. Open the connected Linear workspace you want to upgrade.
- Find the Enable Linear write access banner at the top of the Linear settings page.
- Click Install workspace app.
- Unblocked redirects you to Linear. Have a Linear workspace admin approve the installation for the workspace you want to upgrade.
- Linear redirects you back to Unblocked. When the app is connected and can write, the banner goes away.