Keys / Linear
LINEAR_API_KEY
The personal API key your app or script calls the Linear GraphQL API with. It acts as you, limited to the permissions and teams you choose.
- Expires
- the docs don't say
- API
- none; Settings only
Get it
Create one on linear.app/settings/account/security. The steps aren't recorded yet.
Set it
LINEAR_API_KEY=...
The Linear TypeScript SDK doesn't read it; your app passes it as apiKey. The @linear/import CLI reads it. Or keep it out of .env with keypin: keypin run -- npm run dev
Replace it
- Under Settings > Account > Security & Access, create a new key with the same permissions and teams.
- Deploy it everywhere that reads
LINEAR_API_KEY. Both keys work in the meantime. - Check that nothing still uses the old key, then revoke it.
Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.