← docsProject Management

/linear

Create, update, sync issues via GraphQL.

Linear integration via GraphQL. Create, update, query, and sync issues from within a workflow context. Maps workflow state to Linear issue state.

Category

Project Management

Execution

Workflow event → Linear mutation

Goal

Integrate workflow execution with Linear issue tracking via GraphQL API.

Scope

Applies to

  • +Teams using Linear for issue tracking
  • +Workflows that need to create or update issues

Does not cover

  • −Other issue trackers (Jira, GitHub Issues)

Triggers

"Create Linear issue""Update Linear status""Sync with Linear"

Inputs

  • →Linear API key
  • →Team ID
  • →Issue data (title, description, labels)

Invariants

  • 01Must use GraphQL API (not REST)
  • 02Must handle rate limits gracefully
  • 03Must not duplicate existing issues

Procedure

  1. Step 1Authenticate with Linear API
  2. Step 2Query for existing issues to avoid duplicates
  3. Step 3Create or update issue with workflow data
  4. Step 4Verify mutation succeeded

Outputs

  • ▸Created/updated Linear issue
  • ▸Issue URL for reference

Review Gate

  • [ ]GraphQL mutation succeeded
  • [ ]No duplicate issues created
  • [ ]Issue state matches workflow state