Connect Linear and Sam can keep track of your team's work: find any issue, see what's in the current cycle, and log new tasks as they come up. Deleting an issue always waits for you to confirm first.
What Sam can look up in Linear
- Your teams and projects
- Issues, filtered by team, status or assignee, or found by searching
- Your team's cycles
What Sam can do in Linear
- Create new issues for a team
- Update an issue, such as its status, assignee or priority
- Comment on an issue
- Delete an issue. This can't be undone. Asks you first.
Anything marked Asks you first pauses and waits for you to confirm before it runs.
What Sam can't do in Linear yet
- Create or edit projects and cycles. Sam works with the ones you already have.
Connect Linear
- →A Linear account in the workspace you want Sam to use.
Step 1 - Create a personal API key in Linear
- In Linear, go to Settings > Account > API > Personal API keys.
- Create a key and copy it. It starts with lin_api_.
Step 2 - Open the integrations marketplace
Select Connect your tools at the bottom of the left sidebar, above your profile. Search for Linear or find it under Browse Integrations.
Step 3 - Paste it in and connect
Select Linear, paste what you copied into the fields Sam shows, and select Connect. Once it succeeds, it moves to your Connected tab.
When you connect, you may see a screen of checkboxes, and some are easy to scroll past. Sam can only do what you allow. If you untick one, the matching actions in the list above will fail with a permission error.
If Sam says it can't reach Linear later on, see When Sam can't reach one of your tools.
Frequently Asked Questions
Whose name appears on issues Sam creates?
Yours. A personal API key acts as the person who created it, so issues and comments from Sam show under that account.
Will Sam delete issues without asking?
No. Deleting an issue always stops and asks you to confirm first.