API Key OAuth 2.0

admin comments:create issues:create read write

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

Event

Description