Getting Started
1
Create or Select a Project
Set up a new project or select an existing one. See Organizations & Projects.
2
Configure the Connector
Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Connector Profile · API Key
You can create a Personal API Key from your Linear account settings.
Connector Profile · OAuth 2.0
Create an OAuth2 application in your Linear workspace settings to get Client ID and Secret.
3
Link an Account
Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Link Account · API Key
Link Account · OAuth 2.0
4
Use Actions
Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.
Actions
|
No scopes found
138 actions
Action
Description
Required scopes
File Upload
Step 1 of a two-step upload: request a signed upload URL for a file. This action does NOT transfer any file bytes — it o…
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 agent sessions with cursor pagination
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
Remove (delete) an attachment from its issue by attachment ID — this is the action for a ‘remove/delete this attachment’…
Update Attachment
Edit an existing attachment’s title, subtitle, icon, or metadata (does NOT remove it — use delete_attachment to remove/d…
List Comments
Retrieve comments with optional filtering and cursor pagination
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 customers with optional filtering and cursor pagination
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 customer needs with optional filtering and cursor pagination
Get Customer Need
Retrieve the full details of a specific customer need by its ID (call this after list_customer_needs to return the reque…
Create Customer Need
Create a new customer need attached to an issue, project, or comment
Update Customer Need
Update a customer need’s body, priority, customer, or the issue/project it is linked to
Delete Customer Need
Delete a customer need by ID
List Customer Statuses
Retrieve customer statuses with cursor pagination
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 customer tiers with cursor pagination
Get Customer Tier
Retrieve a specific customer tier by its ID (resolve a tier name to its ID via list_customer_tiers first)
Create Customer Tier
Create a new customer tier with name and optional description
Update Customer Tier
Update an existing customer tier’s display name, description, color, or position
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 cycles with optional filtering and cursor pagination
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 documents with optional filtering and cursor pagination
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 (does NOT trash a document — use delete_document to move a…
Delete Document
Move a document to trash by ID — this is the action for a ‘move to trash’, ‘trash this document’, or ‘delete document’ r…
List External Users
Retrieve external users for the organization with cursor pagination
Get External User
Retrieve a specific external user by ID
List Favorites
Retrieve the authenticated user’s favorites, including the subject each one points to
Create Favorite
Add an item (issue, project, cycle, custom view, document, label, or user) to the user’s favorites
Delete Favorite
Remove an item from favorites by favorite ID
List Initiatives
Retrieve initiatives with optional filtering and cursor pagination
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 issues with optional filtering by team, project, assignee, or status and cursor pagination
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 cursor 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 by their UUIDs
List Issue Labels
Retrieve issue labels with optional filtering and cursor pagination
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 projects in the workspace with optional filtering and cursor pagination
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 project labels with optional filtering and cursor pagination
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 project milestones with optional filtering and cursor pagination
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 project statuses with cursor pagination
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 teams in the workspace with optional filtering and cursor pagination
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
List Team Memberships
List the memberships of a team, returning each membership’s ID alongside its user — needed to remove a user from a team
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 users in the workspace with optional filtering and cursor pagination, use the filter input to search.
Get User
Retrieve a specific user by ID
Update User
Update your own Linear user profile, status, or display settings
List Webhooks
Retrieve webhooks in the organization with cursor pagination
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 workflow states with optional filtering and cursor pagination
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
|
No tags found
43 events
Event
Description
Tags
Issue Created
Processes Linear issue created events.
IssuesWebhooks
Issue Updated
Processes Linear issue updated events.
IssuesWebhooks
Issue Removed
Processes Linear issue removed events.
IssuesWebhooks
Comment Created
Processes Linear comment created events.
CommentsWebhooks
Comment Updated
Processes Linear comment updated events.
CommentsWebhooks
Comment Removed
Processes Linear comment removed events.
CommentsWebhooks
Project Created
Processes Linear project created events.
ProjectsWebhooks
Project Updated
Processes Linear project updated events.
ProjectsWebhooks
Project Removed
Processes Linear project removed events.
ProjectsWebhooks
Cycle Created
Processes Linear cycle created events.
CyclesWebhooks
Cycle Updated
Processes Linear cycle updated events.
CyclesWebhooks
Cycle Removed
Processes Linear cycle removed events.
CyclesWebhooks
Issue Label Created
Processes Linear issue label created events.
Issue LabelsWebhooks
Issue Label Updated
Processes Linear issue label updated events.
Issue LabelsWebhooks
Issue Label Removed
Processes Linear issue label removed events.
Issue LabelsWebhooks
Reaction Created
Processes Linear reaction created events.
ReactionsWebhooks
Reaction Removed
Processes Linear reaction removed events.
ReactionsWebhooks
Project Update Created
Processes Linear project update created events.
ProjectsUpdatesWebhooks
Project Update Updated
Processes Linear project update updated events.
ProjectsUpdatesWebhooks
Project Update Removed
Processes Linear project update removed events.
ProjectsUpdatesWebhooks
Document Created
Processes Linear document created events.
DocumentsWebhooks
Document Updated
Processes Linear document updated events.
DocumentsWebhooks
Document Removed
Processes Linear document removed events.
DocumentsWebhooks
User Updated
Processes Linear user updated events.
UsersWebhooks
Attachment Created
Processes Linear attachment created events.
AttachmentsWebhooks
Attachment Updated
Processes Linear attachment updated events.
AttachmentsWebhooks
Attachment Removed
Processes Linear attachment removed events.
AttachmentsWebhooks
Initiative Created
Processes Linear initiative created events.
InitiativesWebhooks
Initiative Updated
Processes Linear initiative updated events.
InitiativesWebhooks
Initiative Removed
Processes Linear initiative removed events.
InitiativesWebhooks
Customer Created
Processes Linear customer created events.
CustomersWebhooks
Customer Updated
Processes Linear customer updated events.
CustomersWebhooks
Customer Removed
Processes Linear customer removed events.
CustomersWebhooks
Audit Entry Created
Processes Linear audit entry created events.
Audit EntriesWebhooks
Customer Need Created
Processes Linear customer need created events.
Customer NeedsWebhooks
Customer Need Updated
Processes Linear customer need updated events.
Customer NeedsWebhooks
Customer Need Removed
Processes Linear customer need removed events.
Customer NeedsWebhooks
Initiative Update Created
Processes Linear initiative update created events.
InitiativesUpdatesWebhooks
Initiative Update Updated
Processes Linear initiative update updated events.
InitiativesUpdatesWebhooks
Initiative Update Removed
Processes Linear initiative update removed events.
InitiativesUpdatesWebhooks
Issue SLA Created
Processes Linear issue SLA created events.
IssuesSLAsWebhooks
Issue SLA Updated
Processes Linear issue SLA updated events.
IssuesSLAsWebhooks
Issue SLA Removed
Processes Linear issue SLA removed events.
IssuesSLAsWebhooks