Linear - Stackone

Getting Started

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.

Configure the Connector

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.

MCP (OAuth) · Connector Profile

Authorize through the MCP server. Endpoints and client registration are discovered at connect time.

API Key · Connector Profile

You can create a Personal API Key from your Linear account settings.

OAuth 2.0 · Connector Profile

Create an OAuth2 application in your Linear workspace settings to get Client ID and Secret.

Optionally, configure receiving Events for Linear into StackOne.

Webhooks setup

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:

MCP (OAuth) · Link Account

API Key · Link Account

OAuth 2.0 · Link Account

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

222 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

Get Attachment

Retrieve an issue attachment by ID. Use format=url to get its title and download URL without fetching the file content…

Prepare Attachment Upload

Prepare a direct Linear file upload for an existing issue. Uploaded files appear in the issue’s Resources; they are not…

Prepare File Upload

Prepare a direct Linear file upload to embed an image or file in a Markdown field. The file is not added to any issue’s…

Create Attachment From Upload

Link an already-uploaded Linear assetUrl to an existing issue as an attachment. Uploaded files appear in the issue’s Res…

Create Attachment (deprecated)

Deprecated fallback for tiny files only. Accepts base64 file content, verifies SHA-256 checksum, and uploads it through…

Delete Attachment

Remove an attachment link from an issue’s Resources. This does not delete the stored file. Use the attachment ID from ge…

List Agent Skills

List Linear Agent skills available to the authenticated user.

Get Agent Skill

Retrieve a Linear Agent skill by ID, including its full markdown instructions.

List Comments

List comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update…

Save Comment

Create or update a comment on a Linear issue, project, initiative, document, project milestone, or project/initiative st…

Delete Comment

Delete a Linear comment. Inline description comments (those with non-null quotedText) anchor a mark in the editor, so…

List Cycles

List a team’s cycles with their IDs, numbers, dates, and issue and scope histories

List Custom Views

Find saved issue, project, and initiative views accessible to the user, including personal, workspace, and team views. E…

Get Document

Retrieve a Linear document by ID or slug

List Documents

List documents in the user’s Linear workspace

Save Document

Create or update a Linear document. If id is provided, edits the existing document; otherwise creates a new one. When…

Extract Images

Extract and fetch images from markdown content. Use this to view screenshots, diagrams, or other images embedded in Line…

Get Issue

Retrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligen…

List Issues

List issues in the user’s Linear workspace, including active Triage Intelligence suggestions for issues in triage. For i…

Save Issue

Create or update a Linear issue. If id is provided, updates the existing issue; otherwise creates a new one. When crea…

List Issue Statuses

List available issue statuses in a Linear team

Get Issue Status

Retrieve detailed information about an issue status in Linear by name or ID

List Issue Labels

List available issue labels in a Linear workspace or team. A retired label carries retiredAt and cannot be applied to…

Save Issue Label

Create or update a Linear issue label. If id is provided, updates the existing label; otherwise creates a new one. Whe…

Create Issue Label (deprecated)

Create a new Linear issue label. Deprecated: use save_issue_label, which can also update labels.

Retire Issue Label

Retire a Linear issue label so it cannot be applied to new issues. The label stays visible on issues that already have i…

Restore Issue Label

Restore a retired Linear issue label, making it available for use on issues again. Restoring a label group also restores…

List Projects

List projects in the user’s Linear workspace

Get Project

Retrieve details of a specific project in Linear

Save Project

Create or update a Linear project. If id is provided, updates the existing project; otherwise creates a new one. When…

List Project Labels

List available project labels in a Linear workspace or team. Returns workspace labels by default; pass team to also in…

Retire Project Label

Retire a Linear project label so it cannot be applied to new projects. The label stays visible on projects that already…

Restore Project Label

Restore a retired Linear project label, making it available for use on projects again. Restoring a label group also rest…

Save Project Label

Create or update a Linear project label. If id is provided, updates the existing label; otherwise creates a new one. W…

List Release Pipelines

List release pipelines in the workspace.

List Releases

List releases in the workspace, with optional filtering by pipeline, stage, version, and text.

Get Release

Retrieve details of a release by ID or slug.

Save Release

Create or update a release. If id is provided, updates the existing release; otherwise creates a new one. When creatin…

List Release Notes

List release notes in the workspace, optionally filtered by pipeline or covered release.

Get Release Notes

Retrieve release notes by ID or slug, including markdown content.

Save Release Notes

Create or update release notes. If id is provided, updates the existing release notes; otherwise creates a new one. Wh…

Share Issue

Share an issue with a workspace user who cannot otherwise access it. Use this tool only when the user explicitly asks to…

Unshare Issue

Remove a workspace user’s shared access to an issue. Use this tool only when the user explicitly asks to stop sharing th…

List Project Milestones

List all milestones in a Linear project

Get Milestone

Retrieve details of a specific milestone by ID or name

Save Milestone

Create or update a milestone in a Linear project. If id is provided, updates the existing milestone; otherwise creates…

Get Notifications

Get a page of notifications from the authenticated user’s Linear inbox.

Mark Notification

Mark a Linear inbox notification as read or unread, or snooze or unsnooze it.

List Teams

List teams in the user’s Linear workspace, including their parent IDs and hierarchy names

Get Team

Retrieve details of a specific Linear team, including its parent ID and hierarchy name. Use list_teams with parentTeam o…

Get Triage Responsibility

Retrieve who is responsible for a team’s triage: the person on triage now, what happens when an issue enters triage, and…

List Templates

List the Linear issue, project, and document templates available to the authenticated user. Use this to find the templat…

Get Template

Retrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fie…

List Users

List workspace users with their IDs, names, emails, and admin, guest, and active flags. Use get_user for team membership…

Get User

Retrieve one user’s profile, email, admin, guest, and active flags, plus team IDs, names, and keys. Use list_users to fi…

Get Workspace

Retrieve the connected workspace’s ID, name, and URL to confirm which workspace you are using

Search Documentation

Search Linear’s product documentation for feature and usage guidance. Returns up to five results with titles, URLs, and…

Get Diff

Exact lookup for a Linear diff. Use with review URLs, GitHub PR URLs, Linear full identifiers, UUIDs, or slugs.

List Diffs

List Linear diff pull requests visible to the authenticated user

Get Diff Threads

Exact lookup for diff threads and the authenticated user’s drafts. Use with review URLs, GitHub PR URLs, Linear full ide…

Save Diff Comment

Create, reply to, or edit a comment or persisted draft on a Linear diff. Set draft to true to save without submitting. P…

Resolve Diff Thread

Resolve or reopen a top-level comment thread on a Linear diff

Delete Diff Comment

Delete a comment or persisted draft from a Linear diff

Submit Diff Review

Approve a Linear diff, request changes, or submit a review comment

Update Diff

Update a Linear diff’s title, description, reviewer requests, issue links, or status. Provide at least one update. Combi…

Merge Diff

Merge a Linear diff or add it to the repository’s merge queue

Who Am I

Retrieve the authenticated user, the connected workspace, and how this connection reaches Linear

List Customers

List customers in the user’s Linear workspace

Save Customer

Create or update a Linear customer. If id is provided, updates the existing customer; otherwise creates a new one. Whe…

Delete Customer

Delete a customer in Linear

List Customer Needs

List customer needs (customer requests) for an issue, project, or initiative. Provide exactly one of issue, project,…

Save Customer Need

Create or update a customer need (request) in Linear. If id is provided, updates the existing need; otherwise creates…

Delete Customer Need

Archive a customer need (request) in Linear

List Initiatives

List initiatives in the user’s Linear workspace

Get Initiative

Retrieve detailed information about a specific initiative in Linear

Save Initiative

Create or update a Linear initiative. If id is provided, updates the existing initiative; otherwise creates a new one…

List Initiative Labels

List available initiative labels in the Linear workspace. Pass includeGroups to include groups, which return `groupTyp…

Save Initiative Label

Create or update a Linear initiative label. If id is provided, updates the existing label; otherwise creates a new one…

Create Initiative Label (deprecated)

Create a new Linear initiative label. Deprecated: use save_initiative_label, which can also update labels.

Retire Initiative Label

Retire a Linear initiative label so it cannot be applied to new initiatives. The label stays visible on initiatives that…

Restore Initiative Label

Restore a retired Linear initiative label, making it available for use on initiatives again. Restoring a label group als…

Get Status Updates

List or get project/initiative status updates with their body, health, author, and parent project or initiative. Pass id…

Save Status Update

Create or update a project/initiative status update and return the saved update. To create, omit id and provide body plu…

Delete Status Update

Delete (archive) a project or initiative status update.

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

​Getting Started