Linear

Linear: Overview and setup

Automate project and issue tracking with the Linear integration.

Connect Linear to Atomicwork to automate project creation, issue tracking, and team collaboration as part of your IT and engineering workflows.

By connecting Linear, your teams can:

Automate issue creation: Create Linear issues from Atomicwork workflows — for example, automatically generating an engineering issue when a bug report is submitted through the service catalog, complete with priority, assignee, and project assignment.
Track and manage issues: List and retrieve issue details to keep teams in sync across tools without switching between platforms.
Manage projects: Create and track Linear projects with start dates, target dates, and team assignments.
Collaborate with comments: Add comments to issues directly from workflows — for example, posting a status update on a linked issue when an Atomicwork request is resolved.

To connect Linear to Atomicwork, you need:

The integration authenticates via OAuth 2.0 and requests the following scopes during authorization:

Permission	Purpose
`read`	Read access to Linear resources — required for listing and retrieving projects and issues.

Action	Description
Create project	Create a Linear project with name, description, team, start date, target date, and lead.
Get projects	List Linear projects with optional filters.
Create issue	Create an issue with title, description, team, priority, assignee, project, state, due date, and estimate.
List issues	List Linear issues with optional filters.
Get issue	Retrieve detailed information about a specific issue by ID.
Add comment	Add a comment to an existing issue.
Call API	Make a generic GraphQL API call to Linear for custom operations.

Error	Cause	Resolution
Authentication failure	The OAuth authorization code has expired or the redirect URI doesn't match.	Re-initiate the OAuth flow from Settings > App Store > Linear.
Token refresh failure	The refresh token has expired or been revoked.	Re-authenticate the integration to generate new tokens.
API errors (5xx)	The Linear API is experiencing issues.	Retry the operation. If the issue persists, check the Linear status page.