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

Add Linear Issue Label

Issue WorkCan make changes

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

Archive Linear Issue

Issue WorkCan make changes

Archive one issue by an account-bound issue ref.

Create Linear Issue

Issue WorkCan make changes

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

Create Linear Issue Comment

Issue WorkCan make changes

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

Create Linear Issue Relation

Issue WorkCan make changes

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

Delete Linear Comment

Issue WorkCan make changes

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

Delete Linear Issue Relation

Issue WorkCan make changes

Delete one account-bound issue relation.

Get Linear Comment

Issue WorkReads data

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

Get Linear Cycle

Issue WorkReads data

Get one cycle by an account-bound cycle ref.

Get Linear Issue

Issue WorkReads data

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

Get Linear Issue Label

Issue WorkReads data

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

Get Linear Issue Relation

Issue WorkReads data

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

Get Linear Project

Issue WorkReads data

Get one project by an account-bound project ref.

Get Linear Team

Issue WorkReads data

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

Get Linear User

Issue WorkReads data

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

Get Linear Viewer

Issue WorkReads data

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

Get Linear Workflow State

Issue WorkReads data

Get one workflow state by an account-bound ref.

List Linear Cycles

Issue WorkReads data

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

List Linear Issue Comments

Issue WorkReads data

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

List Linear Issue Labels

Issue WorkReads data

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

List Linear Issue Relations

Issue WorkReads data

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

List Linear Issues

Issue WorkReads data

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

List Linear Projects

Issue WorkReads data

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

List Linear Teams

Issue WorkReads data

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

List Linear Users

Issue WorkReads data

List Linear workspace users with bounded pagination.

List Linear Workflow States

Issue WorkReads data

List workflow states using reviewed team and timestamp filters.

Remove Linear Issue Label

Issue WorkCan make changes

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

Resolve Linear Comment

Issue WorkCan make changes

Resolve one account-bound issue comment.

Search Linear Issues

Issue WorkReads data

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

Unarchive Linear Issue

Issue WorkCan make changes

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

Unresolve Linear Comment

Issue WorkCan make changes

Reopen one account-bound issue comment.

Update Linear Comment

Issue WorkCan make changes

Replace the body of one account-bound issue comment.

Update Linear Issue

Issue WorkCan make changes

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

Update Linear Issue Relation

Issue WorkCan make changes

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.