Create a new issue in a team (title, description, team). (docs)
GraphQL mutation issueCreate
🟢 low
— no
Modify an existing issue (title, state, assignee) by id. (docs)
GraphQL mutation issueUpdate
🟡 medium
✅ yes
Connecting it
You provide: Personal API key
Where to get it: Linear → Settings → Account → Security → create a Personal API key (sent as Authorization: <key>, no Bearer prefix). For multi-workspace, register an OAuth app under Settings → API → Applications.
Permissions/scopes:none / not scope-based
Account setup
Account needed: A Linear workspace (membership in at least one team to get a teamId).
App registration: Personal API key for single-workspace/script use (Settings → Account → Security). OAuth2 application for multi-workspace (Settings → API → Applications → New).
Verification required: None for personal API keys. Public/marketplace OAuth distribution requires Linear approval.
Testing: No dedicated sandbox — test against a free/test workspace or a dedicated test team with a personal API key.
Limits
Complexity-based. Personal API key: 2,500 req/user/hr, 3M complexity/hr. OAuth: 5,000 req/user/hr. Max single-query complexity 10,000 points.