Linear

Linear GraphQL provider using daemon-owned OAuth or a personal API key. Credentials stay daemon-held and only curated issue-work actions are executable.

34 listed actions1 capability groups

Connection facts

What the Linear connector actually exposes.

These details come from the current StackOS provider manifest and action catalog. They describe the available connection—not a promise that every workflow will use every action.

Connection method: oauth-or-api-key
Setup: Create a Linear OAuth application and register the exact callback URL shown in StackOS, or create a personal API key in Linear account settings. Personal-key permissions are enforced by Linear at request time.
Capability groups: Issue Work
Action boundaries: 20 read actions14 write actions

Action catalog

Actions listed for Linear.

Actions listed for this integration. Individual descriptions note availability limits. A workflow still decides which actions belong in the job and where approval is required.

Search Linear actions

34 matching actions

Issue WorkCan make changes

Add Linear Issue Label

Add an account-bound issue label ref to an account-bound issue ref.

Issue WorkCan make changes

Archive Linear Issue

Archive one issue by an account-bound issue ref.

Issue WorkCan make changes

Create Linear Issue

Create an issue from reviewed fields and account-bound refs.

Issue WorkCan make changes

Create Linear Issue Comment

Create a comment on one account-bound issue with an optional parent comment ref.

Issue WorkCan make changes

Create Linear Issue Relation

Create a reviewed relation between two account-bound issue refs.

Issue WorkCan make changes

Delete Linear Comment

Delete one account-bound issue comment; permanent issue deletion is not exposed.

Issue WorkCan make changes

Delete Linear Issue Relation

Delete one account-bound issue relation.

Issue WorkReads data

Get Linear Comment

Get one issue comment by an account-bound comment ref.

Issue WorkReads data

Get Linear Cycle

Get one cycle by an account-bound cycle ref.

Issue WorkReads data

Get Linear Issue

Get one issue and its reviewed nested context by an account-bound issue ref.

Issue WorkReads data

Get Linear Issue Label

Get one issue label by an account-bound label ref.

Issue WorkReads data

Get Linear Issue Relation

Get one issue relation by an account-bound relation ref.

Issue WorkReads data

Get Linear Project

Get one project by an account-bound project ref.

Issue WorkReads data

Get Linear Team

Get one Linear team by an account-bound team ref.

Issue WorkReads data

Get Linear User

Get one Linear user by an account-bound user ref.

Issue WorkReads data

Get Linear Viewer

Return the authenticated Linear user and workspace as account-bound safe refs.

Issue WorkReads data

Get Linear Workflow State

Get one workflow state by an account-bound ref.

Issue WorkReads data

List Linear Cycles

List cycles with bounded pagination and reviewed team/timestamp filters.

Issue WorkReads data

List Linear Issue Comments

List comments for one account-bound issue with bounded pagination.

Issue WorkReads data

List Linear Issue Labels

List issue labels with bounded pagination and reviewed team/timestamp filters.

Issue WorkReads data

List Linear Issue Relations

List relations from one issue; the workspace-wide relation root is not exposed.

Issue WorkReads data

List Linear Issues

List issues using only bounded pagination and reviewed safe-ref/timestamp filters.

Issue WorkReads data

List Linear Projects

List projects with bounded pagination and reviewed team/timestamp filters.

Issue WorkReads data

List Linear Teams

List Linear teams with bounded cursor pagination and account-bound refs.

Issue WorkReads data

List Linear Users

List Linear workspace users with bounded pagination.

Issue WorkReads data

List Linear Workflow States

List workflow states using reviewed team and timestamp filters.

Issue WorkCan make changes

Remove Linear Issue Label

Remove an account-bound issue label ref from an account-bound issue ref.

Issue WorkCan make changes

Resolve Linear Comment

Resolve one account-bound issue comment.

Issue WorkReads data

Search Linear Issues

Search issues through Linear searchIssues with a required term and reviewed filters.

Issue WorkCan make changes

Unarchive Linear Issue

Restore one archived issue by an account-bound issue ref.

Issue WorkCan make changes

Unresolve Linear Comment

Reopen one account-bound issue comment.

Issue WorkCan make changes

Update Linear Comment

Replace the body of one account-bound issue comment.

Issue WorkCan make changes

Update Linear Issue

Patch one issue with reviewed fields while preserving omitted-versus-null semantics.

Issue WorkCan make changes

Update Linear Issue Relation

Change one account-bound relation to a reviewed relation type.

Direct answer

How does the Linear integration work?

People continue using Linear as their tool. StackOS adds it to a visible workflow, keeps the work in order, and passes only the approved action to the integration when that stage is ready.

01Your requestStart in your AI
02StackOS planExpands the steps
03LinearDoes its bounded part
04Checked resultKeeps the proof

Common questions

Linear and StackOS.

What can the Linear integration do in StackOS?

The current catalog includes 34 Linear actions across Issue Work. The exact actions used depend on the workflow and approval rules.

Does StackOS replace Linear?

No. Linear remains the tool that performs its part of the job. StackOS organizes the workflow, keeps status and dependencies visible, and calls the tool only when the plan reaches the right approved action.