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

  1. Under Settings > Account > Security & Access, create a new key with the same permissions and teams.
  2. Deploy it everywhere that reads LINEAR_API_KEY. Both keys work in the meantime.
  3. 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.

Sources, checked 2026-11-16