Skip to main content
Linear
Linear
136 actions · 43 events · 2 auth methods
PreviewTicketingIAM

Authentication

API Key

You can create a Personal API Key from your Linear account settings.Guides: Connector Profile, Link Account

OAuth 2.0

Create an OAuth2 application in your Linear workspace settings to get Client ID and Secret.Guides: Connector Profile, Link Account
Actions
|
136 actions
Action
Description
Required scopes
File Upload
Get a signed upload URL for uploading files (images, videos, attachments) to Linear’s cloud storage
Update Organization
Update organization settings (admin only)
Create Organization Invite
Invite a new member to the organization by email (admin only)
Suspend User
Suspend a user account (admin only)
List Agent Sessions
Retrieve all agent sessions
Get Agent Session
Retrieve a specific agent session by ID
Get Unified Credentials
Get the current Linear connection’s unified credentials and identity.
Get Application Info
Get basic information for an application by client ID
Create Attachment
Link an external resource to an issue as an attachment
Delete Attachment
Delete an attachment by ID
Update Attachment
Update an existing attachment’s title, subtitle, icon, or metadata
List Comments
Retrieve all comments with optional filtering by issue
Get Comment
Retrieve a specific comment by ID
Create Comment
Create a new comment on an issue
Update Comment
Update an existing comment’s body
Delete Comment
Delete a comment by ID
Resolve Comment
Mark a comment thread as resolved
Unresolve Comment
Reopen a resolved comment thread
List Customers
Retrieve all customers with optional filtering
Get Customer
Retrieve a specific customer by ID
Create Customer
Create a new customer with name, domains, and optional revenue, size, status, and tier
Update Customer
Update an existing customer’s name, domains, revenue, size, status, or tier
Delete Customer
Delete a customer by ID
Upsert Customer
Create or update a customer by matching on id or externalId, useful for idempotent sync workflows
List Customer Needs
Retrieve all customer needs with optional filtering
Get Customer Need
Retrieve a specific customer need by ID
Create Customer Need
Create a new customer need attached to an issue, project, or comment
Update Customer Need
Update an existing customer need’s body or customer association
Delete Customer Need
Delete a customer need by ID
List Customer Statuses
Retrieve all customer statuses
Get Customer Status
Retrieve a specific customer status by ID
Create Customer Status
Create a new customer status with a color and a name or displayName, plus optional description and position
Update Customer Status
Update an existing customer status’s name, description, color, or position
Delete Customer Status
Delete a customer status by ID
List Customer Tiers
Retrieve all customer tiers
Get Customer Tier
Retrieve a specific customer tier by ID
Create Customer Tier
Create a new customer tier with name and optional description
Update Customer Tier
Update an existing customer tier’s name or description
Delete Customer Tier
Delete a customer tier by ID
Create Custom View
Create a new saved custom view with filters
Update Custom View
Update an existing custom view’s name, filters, or sharing settings
Delete Custom View
Delete a custom view by ID
List Cycles
Retrieve all cycles with optional filtering by team
Get Cycle
Retrieve a specific cycle by ID
Create Cycle
Create a new cycle for a team
Update Cycle
Update an existing cycle’s name, description, or dates
Archive Cycle
Archive a cycle by ID
List Documents
Retrieve all documents with optional filtering
Get Document
Retrieve a specific document by ID
Create Document
Create a new document with title, content, and optional project or initiative association
Update Document
Update an existing document’s title, content, or associations
Delete Document
Delete (trash) a document by ID
List External Users
Retrieve all external users for the organization
Get External User
Retrieve a specific external user by ID
Create Favorite
Add an item (issue, project, cycle, custom view, etc.) to the user’s favorites
Delete Favorite
Remove an item from favorites by favorite ID
List Initiatives
Retrieve all initiatives with optional filtering
Get Initiative
Retrieve a specific initiative by ID
Create Initiative
Create a new initiative to group projects
Update Initiative
Update an existing initiative’s name, description, dates, or other properties
Delete Initiative
Delete an initiative by ID
Archive Initiative
Archive an initiative by ID
Create Initiative To Project Link
Link an initiative to a project
Delete Initiative To Project Link
Remove the link between an initiative and a project
Create Initiative Update
Create a status update for an initiative
List Issues
Retrieve all issues with optional filtering by team, project, assignee, or status
Get Issue
Retrieve a specific issue by ID or identifier
Create Issue
Create a new issue in Linear with title, description, team, and optional fields
Update Issue
Update an existing issue’s title, description, assignee, priority, state, or other fields
Delete Issue
Delete an issue by ID
Issue Filter Suggestion
Suggests filters for an issue view based on a text prompt
Search Issues
Search issues by text term with optional filtering and pagination
Archive Issue
Archive an issue by ID
Unarchive Issue
Restore an archived issue by ID
Create Issue Relation
Create a relationship between two issues
Delete Issue Relation
Remove a relationship between two issues
Batch Create Issues
Create multiple issues at once
Batch Update Issues
Update multiple issues at once
List Issue Labels
Retrieve all issue labels with optional filtering by team
Get Issue Label
Retrieve a specific issue label by ID
Create Issue Label
Create a new issue label for a team
Update Issue Label
Update an existing issue label’s name, description, or color
Delete Issue Label
Delete an issue label by ID
Create Notification Subscription
Subscribe to notifications for a team, project, cycle, label, custom view, initiative, or user
List Projects
Retrieve all projects in the workspace with optional filtering
Get Project
Retrieve a specific project by ID with full details
Create Project
Create a new project with name, description, and optional team associations
Update Project
Update an existing project’s details
Delete Project
Delete a project by ID
Archive Project
Archive a project by ID
Create Project Update
Create a status update for a project
List Project Labels
Retrieve all project labels with optional filtering
Get Project Label
Retrieve a specific project label by ID
Create Project Label
Create a new project label
Update Project Label
Update an existing project label’s name, description, or color
Delete Project Label
Delete a project label by ID
List Project Milestones
Retrieve all milestones for a project
Get Project Milestone
Retrieve a specific project milestone by ID
Create Project Milestone
Create a new milestone for a project
Update Project Milestone
Update an existing project milestone’s name, description, or target date
Delete Project Milestone
Delete a project milestone by ID
List Project Statuses
Retrieve all project statuses
Get Project Status
Retrieve a specific project status by ID
Create Project Status
Create a new project status with name, type, and optional description, color, and position
Update Project Status
Update an existing project status’s name, description, type, color, or position
Archive Project Status
Archive a project status by ID
Create Reaction
Add an emoji reaction to a comment, issue, or project update
Delete Reaction
Remove an emoji reaction by reaction ID
Create Release
Create a new release in a pipeline
Update Release
Update an existing release’s name, version, description, or other properties
Delete Release
Delete a release by ID
Complete Release
Mark a release as complete in a pipeline
List Teams
Retrieve all teams in the workspace
Get Team
Retrieve a specific team by ID
Update Team
Update an existing team’s name, description, icon, color, or other properties
Create Team
Create a new team with name and optional settings
Delete Team
Delete a team by ID
Create Team Membership
Add a user to a team, with optional owner role assignment
Delete Team Membership
Remove a user from a team
Create Template
Create a new issue or project template
Update Template
Update an existing template’s name, description, data, or other properties
Delete Template
Delete a template by ID
Get Viewer
Retrieve the currently authenticated user (viewer)
List Users
Retrieve all users in the workspace, use the filter input to search.
Get User
Retrieve a specific user by ID
Update User
Update an existing user’s profile, status, or display settings
List Webhooks
Retrieve all webhooks in the organization
Get Webhook
Retrieve a specific webhook by ID
Create Webhook
Create a new webhook to receive HTTP notifications for data updates
Update Webhook
Update an existing webhook’s URL, enabled status, or resource types
Delete Webhook
Delete a webhook by ID
Rotate Webhook Secret
Rotate the signing secret for a webhook
List Workflow States
Retrieve all workflow states with optional filtering by team
Get Workflow State
Retrieve a specific workflow state by ID
Create Workflow State
Create a new workflow state for a team with a specified type, name, and color
Update Workflow State
Update an existing workflow state’s name, color, description, or position
Events
|
43 events
Event
Description
Tags
Issue Created
Processes Linear issue created events.
Issue
Issue Updated
Processes Linear issue updated events.
Issue
Issue Removed
Processes Linear issue removed events.
Issue
Comment Created
Processes Linear comment created events.
Comment
Comment Updated
Processes Linear comment updated events.
Comment
Comment Removed
Processes Linear comment removed events.
Comment
Project Created
Processes Linear project created events.
Project
Project Updated
Processes Linear project updated events.
Project
Project Removed
Processes Linear project removed events.
Project
Cycle Created
Processes Linear cycle created events.
Cycle
Cycle Updated
Processes Linear cycle updated events.
Cycle
Cycle Removed
Processes Linear cycle removed events.
Cycle
Issue Label Created
Processes Linear issue label created events.
Label
Issue Label Updated
Processes Linear issue label updated events.
Label
Issue Label Removed
Processes Linear issue label removed events.
Label
Reaction Created
Processes Linear reaction created events.
Reaction
Reaction Removed
Processes Linear reaction removed events.
Reaction
Project Update Created
Processes Linear project update created events.
ProjectUpdate
Project Update Updated
Processes Linear project update updated events.
ProjectUpdate
Project Update Removed
Processes Linear project update removed events.
ProjectUpdate
Document Created
Processes Linear document created events.
Document
Document Updated
Processes Linear document updated events.
Document
Document Removed
Processes Linear document removed events.
Document
User Updated
Processes Linear user updated events.
User
Attachment Created
Processes Linear attachment created events.
Attachment
Attachment Updated
Processes Linear attachment updated events.
Attachment
Attachment Removed
Processes Linear attachment removed events.
Attachment
Initiative Created
Processes Linear initiative created events.
Initiative
Initiative Updated
Processes Linear initiative updated events.
Initiative
Initiative Removed
Processes Linear initiative removed events.
Initiative
Customer Created
Processes Linear customer created events.
Customer
Customer Updated
Processes Linear customer updated events.
Customer
Customer Removed
Processes Linear customer removed events.
Customer
Audit Entry Created
Processes Linear audit entry created events.
AuditEntry
Customer Need Created
Processes Linear customer need created events.
CustomerNeed
Customer Need Updated
Processes Linear customer need updated events.
CustomerNeed
Customer Need Removed
Processes Linear customer need removed events.
CustomerNeed
Initiative Update Created
Processes Linear initiative update created events.
InitiativeUpdate
Initiative Update Updated
Processes Linear initiative update updated events.
InitiativeUpdate
Initiative Update Removed
Processes Linear initiative update removed events.
InitiativeUpdate
Issue SLA Created
Processes Linear issue SLA created events.
IssueSLA
Issue SLA Updated
Processes Linear issue SLA updated events.
IssueSLA
Issue SLA Removed
Processes Linear issue SLA removed events.
IssueSLA

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See the Projects Guide.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.
https://stackone-logos.com/api/linear/filled/png

Connector Profile

Linear - API Key
https://stackone-logos.com/api/linear/filled/png

Connector Profile

Linear - OAuth 2.0
3

Link an Account

Connect an account using StackOne Hub or Auth Link.
https://stackone-logos.com/api/linear/filled/png

Link Account

Linear - API Key
https://stackone-logos.com/api/linear/filled/png

Link Account

Linear - OAuth 2.0
4

Use Actions

Invoke actions using one of the methods below: