Sim

Linear

Interact with Linear issues, projects, and more

Linear is a leading project management and issue tracking platform that helps teams plan, track, and manage their work effectively. As a modern project management tool, Linear has become increasingly popular among software development teams and project management professionals for its streamlined interface and powerful features.

Linear provides a comprehensive set of tools for managing complex projects through its flexible and customizable workflow system. With its robust API and integration capabilities, Linear enables teams to streamline their development processes and maintain clear visibility of project progress.

Key features of Linear include:

  • Agile Project Management: Support for Scrum and Kanban methodologies with customizable boards and workflows
  • Issue Tracking: Sophisticated tracking system for bugs, stories, epics, and tasks with detailed reporting
  • Workflow Automation: Powerful automation rules to streamline repetitive tasks and processes
  • Advanced Search: Complex filtering and reporting capabilities for efficient issue management

In Sim, the Linear integration allows your agents to seamlessly interact with your project management workflow. This creates opportunities for automated issue creation, updates, and tracking as part of your AI workflows. The integration enables agents to read existing issues and create new ones programmatically, facilitating automated project management tasks and ensuring that important information is properly tracked and documented. By connecting Sim with Linear, you can build intelligent agents that maintain project visibility while automating routine project management tasks, enhancing team productivity and ensuring consistent project tracking.

Usage Instructions

Integrate Linear into the workflow. Can manage issues, comments, projects, labels, workflow states, cycles, attachments, and more. Can also trigger workflows based on Linear webhook events.

Tools

linear_read_issues

Fetch and filter issues from Linear

Input

ParameterTypeRequiredDescription
teamIdstringNoLinear team ID to filter by
projectIdstringNoLinear project ID to filter by
assigneeIdstringNoUser ID to filter by assignee
stateIdstringNoWorkflow state ID to filter by status
prioritynumberNoPriority to filter by (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
labelIdsarrayNoArray of label IDs to filter by
createdAfterstringNoFilter issues created after this date (ISO 8601 format)
updatedAfterstringNoFilter issues updated after this date (ISO 8601 format)
includeArchivedbooleanNoInclude archived issues (default: false)
firstnumberNoNumber of issues to return (default: 50, max: 250)
afterstringNoPagination cursor for next page
orderBystringNoSort order: "createdAt" or "updatedAt" (default: "updatedAt")

Output

ParameterTypeDescription
issuesarrayArray of filtered issues from Linear

linear_get_issue

Get a single issue by ID from Linear with full details

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID

Output

ParameterTypeDescription
issueobjectThe issue with full details

linear_create_issue

Create a new issue in Linear

Input

ParameterTypeRequiredDescription
teamIdstringYesLinear team ID
projectIdstringNoLinear project ID
titlestringYesIssue title
descriptionstringNoIssue description
stateIdstringNoWorkflow state ID (status)
assigneeIdstringNoUser ID to assign the issue to
prioritynumberNoPriority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
estimatenumberNoEstimate in points
labelIdsarrayNoArray of label IDs to set on the issue
cycleIdstringNoCycle ID to assign the issue to
parentIdstringNoParent issue ID (for creating sub-issues)
dueDatestringNoDue date in ISO 8601 format (date only: YYYY-MM-DD)
subscriberIdsarrayNoArray of user IDs to subscribe to the issue
projectMilestoneIdstringNoProject milestone ID to associate with the issue

Output

ParameterTypeDescription
issueobjectThe created issue with all its properties

linear_update_issue

Update an existing issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID to update
titlestringNoNew issue title
descriptionstringNoNew issue description
stateIdstringNoWorkflow state ID (status)
assigneeIdstringNoUser ID to assign the issue to
prioritynumberNoPriority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)
estimatenumberNoEstimate in points
labelIdsarrayNoArray of label IDs to set on the issue (replaces all existing labels)
projectIdstringNoProject ID to move the issue to
cycleIdstringNoCycle ID to assign the issue to
parentIdstringNoParent issue ID (for making this a sub-issue)
dueDatestringNoDue date in ISO 8601 format (date only: YYYY-MM-DD)
addedLabelIdsarrayNoArray of label IDs to add to the issue (without replacing existing labels)
removedLabelIdsarrayNoArray of label IDs to remove from the issue

Output

ParameterTypeDescription
issueobjectThe updated issue

linear_archive_issue

Archive an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID to archive

Output

ParameterTypeDescription
successbooleanWhether the archive operation was successful
issueIdstringThe ID of the archived issue

linear_unarchive_issue

Unarchive (restore) an archived issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID to unarchive

Output

ParameterTypeDescription
successbooleanWhether the unarchive operation was successful
issueIdstringThe ID of the unarchived issue

linear_delete_issue

Delete (trash) an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID to delete

Output

ParameterTypeDescription
successbooleanWhether the delete operation was successful

linear_search_issues

Search for issues in Linear using full-text search

Input

ParameterTypeRequiredDescription
querystringYesSearch query string
teamIdstringNoFilter by team ID
includeArchivedbooleanNoInclude archived issues in search results
firstnumberNoNumber of results to return (default: 50)

Output

ParameterTypeDescription
issuesarrayArray of matching issues

linear_add_label_to_issue

Add a label to an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID
labelIdstringYesLabel ID to add to the issue

Output

ParameterTypeDescription
successbooleanWhether the label was successfully added
issueIdstringThe ID of the issue

linear_remove_label_from_issue

Remove a label from an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID
labelIdstringYesLabel ID to remove from the issue

Output

ParameterTypeDescription
successbooleanWhether the label was successfully removed
issueIdstringThe ID of the issue

linear_create_comment

Add a comment to an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID to comment on
bodystringYesComment text (supports Markdown)

Output

ParameterTypeDescription
commentobjectThe created comment

linear_update_comment

Edit a comment in Linear

Input

ParameterTypeRequiredDescription
commentIdstringYesComment ID to update
bodystringNoNew comment text (supports Markdown)

Output

ParameterTypeDescription
commentobjectThe updated comment

linear_delete_comment

Delete a comment from Linear

Input

ParameterTypeRequiredDescription
commentIdstringYesComment ID to delete

Output

ParameterTypeDescription
successbooleanWhether the delete operation was successful

linear_list_comments

List all comments on an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesLinear issue ID
firstnumberNoNumber of comments to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
commentsarrayArray of comments on the issue

linear_list_projects

List projects in Linear with optional filtering

Input

ParameterTypeRequiredDescription
teamIdstringNoFilter by team ID
includeArchivedbooleanNoInclude archived projects
firstnumberNoNumber of projects to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
projectsarrayArray of projects

linear_get_project

Get a single project by ID from Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesLinear project ID

Output

ParameterTypeDescription
projectobjectThe project with full details

linear_create_project

Create a new project in Linear

Input

ParameterTypeRequiredDescription
teamIdstringYesTeam ID to create the project in
namestringYesProject name
descriptionstringNoProject description
leadIdstringNoUser ID of the project lead
startDatestringNoProject start date (ISO format)
targetDatestringNoProject target date (ISO format)
prioritynumberNoProject priority (0-4)

Output

ParameterTypeDescription
projectobjectThe created project

linear_update_project

Update an existing project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID to update
namestringNoNew project name
descriptionstringNoNew project description
statestringNoProject state (planned, started, completed, canceled)
leadIdstringNoUser ID of the project lead
startDatestringNoProject start date (ISO format: YYYY-MM-DD)
targetDatestringNoProject target date (ISO format: YYYY-MM-DD)
prioritynumberNoProject priority (0=No priority, 1=Urgent, 2=High, 3=Normal, 4=Low)

Output

ParameterTypeDescription
projectobjectThe updated project

linear_archive_project

Archive a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID to archive

Output

ParameterTypeDescription
successbooleanWhether the archive operation was successful
projectIdstringThe ID of the archived project

linear_list_users

List all users in the Linear workspace

Input

ParameterTypeRequiredDescription
includeDisabledbooleanNoInclude disabled/inactive users
firstnumberNoNumber of users to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
usersarrayArray of workspace users

linear_list_teams

List all teams in the Linear workspace

Input

ParameterTypeRequiredDescription
firstnumberNoNumber of teams to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
teamsarrayArray of teams

linear_get_viewer

Get the currently authenticated user (viewer) information

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
userobjectThe currently authenticated user

linear_list_labels

List all labels in Linear workspace or team

Input

ParameterTypeRequiredDescription
teamIdstringNoFilter by team ID
firstnumberNoNumber of labels to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
labelsarrayArray of labels

linear_create_label

Create a new label in Linear

Input

ParameterTypeRequiredDescription
namestringYesLabel name
colorstringNoLabel color (hex format, e.g., "#ff0000")
descriptionstringNoLabel description
teamIdstringNoTeam ID (if omitted, creates workspace label)

Output

ParameterTypeDescription
labelobjectThe created label

linear_update_label

Update an existing label in Linear

Input

ParameterTypeRequiredDescription
labelIdstringYesLabel ID to update
namestringNoNew label name
colorstringNoNew label color (hex format)
descriptionstringNoNew label description

Output

ParameterTypeDescription
labelobjectThe updated label

linear_archive_label

Archive a label in Linear

Input

ParameterTypeRequiredDescription
labelIdstringYesLabel ID to archive

Output

ParameterTypeDescription
successbooleanWhether the archive operation was successful
labelIdstringThe ID of the archived label

linear_list_workflow_states

List all workflow states (statuses) in Linear

Input

ParameterTypeRequiredDescription
teamIdstringNoFilter by team ID
firstnumberNoNumber of states to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
statesarrayArray of workflow states

linear_create_workflow_state

Create a new workflow state (status) in Linear

Input

ParameterTypeRequiredDescription
teamIdstringYesTeam ID to create the state in
namestringYesState name (e.g., "In Review")
colorstringNoState color (hex format)
typestringYesState type: "backlog", "unstarted", "started", "completed", or "canceled"
descriptionstringNoState description
positionnumberNoPosition in the workflow

Output

ParameterTypeDescription
stateobjectThe created workflow state

linear_update_workflow_state

Update an existing workflow state in Linear

Input

ParameterTypeRequiredDescription
stateIdstringYesWorkflow state ID to update
namestringNoNew state name
colorstringNoNew state color (hex format)
descriptionstringNoNew state description
positionnumberNoNew position in workflow

Output

ParameterTypeDescription
stateobjectThe updated workflow state

linear_list_cycles

List cycles (sprints/iterations) in Linear

Input

ParameterTypeRequiredDescription
teamIdstringNoFilter by team ID
firstnumberNoNumber of cycles to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
cyclesarrayArray of cycles

linear_get_cycle

Get a single cycle by ID from Linear

Input

ParameterTypeRequiredDescription
cycleIdstringYesCycle ID

Output

ParameterTypeDescription
cycleobjectThe cycle with full details

linear_create_cycle

Create a new cycle (sprint/iteration) in Linear

Input

ParameterTypeRequiredDescription
teamIdstringYesTeam ID to create the cycle in
startsAtstringYesCycle start date (ISO format)
endsAtstringYesCycle end date (ISO format)
namestringNoCycle name (optional, will be auto-generated if not provided)

Output

ParameterTypeDescription
cycleobjectThe created cycle

linear_get_active_cycle

Get the currently active cycle for a team

Input

ParameterTypeRequiredDescription
teamIdstringYesTeam ID

Output

ParameterTypeDescription
cycleobjectThe active cycle (null if no active cycle)

linear_create_attachment

Add an attachment to an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesIssue ID to attach to
urlstringYesURL of the attachment
titlestringYesAttachment title
subtitlestringNoAttachment subtitle/description

Output

ParameterTypeDescription
attachmentobjectThe created attachment

linear_list_attachments

List all attachments on an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesIssue ID
firstnumberNoNumber of attachments to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
attachmentsarrayArray of attachments

linear_update_attachment

Update an attachment metadata in Linear

Input

ParameterTypeRequiredDescription
attachmentIdstringYesAttachment ID to update
titlestringYesNew attachment title
subtitlestringNoNew attachment subtitle

Output

ParameterTypeDescription
attachmentobjectThe updated attachment

linear_delete_attachment

Delete an attachment from Linear

Input

ParameterTypeRequiredDescription
attachmentIdstringYesAttachment ID to delete

Output

ParameterTypeDescription
successbooleanWhether the delete operation was successful

linear_create_issue_relation

Link two issues together in Linear (blocks, relates to, duplicates)

Input

ParameterTypeRequiredDescription
issueIdstringYesSource issue ID
relatedIssueIdstringYesTarget issue ID to link to
typestringYesRelation type: "blocks", "duplicate", or "related". Note: When creating "blocks" from A to B, the inverse relation (B blocked by A) is automatically created.

Output

ParameterTypeDescription
relationobjectThe created issue relation

linear_list_issue_relations

List all relations (dependencies) for an issue in Linear

Input

ParameterTypeRequiredDescription
issueIdstringYesIssue ID
firstnumberNoNumber of relations to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
relationsarrayArray of issue relations

linear_delete_issue_relation

Remove a relation between two issues in Linear

Input

ParameterTypeRequiredDescription
relationIdstringYesRelation ID to delete

Output

ParameterTypeDescription
successbooleanWhether the delete operation was successful

linear_create_favorite

Bookmark an issue, project, cycle, or label in Linear

Input

ParameterTypeRequiredDescription
issueIdstringNoIssue ID to favorite
projectIdstringNoProject ID to favorite
cycleIdstringNoCycle ID to favorite
labelIdstringNoLabel ID to favorite

Output

ParameterTypeDescription
favoriteobjectThe created favorite

linear_list_favorites

List all bookmarked items for the current user in Linear

Input

ParameterTypeRequiredDescription
firstnumberNoNumber of favorites to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
favoritesarrayArray of favorited items

linear_create_project_update

Post a status update for a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID to post update for
bodystringYesUpdate message (supports Markdown)
healthstringNoProject health: "onTrack", "atRisk", or "offTrack"

Output

ParameterTypeDescription
updateobjectThe created project update

linear_list_project_updates

List all status updates for a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID
firstnumberNoNumber of updates to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
updatesarrayArray of project updates

Add an external link to a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID to add link to
urlstringYesURL of the external link
labelstringNoLink label/title

Output

ParameterTypeDescription
linkobjectThe created project link

linear_list_notifications

List notifications for the current user in Linear

Input

ParameterTypeRequiredDescription
firstnumberNoNumber of notifications to return (default: 50)
afterstringNoCursor for pagination

Output

ParameterTypeDescription
notificationsarrayArray of notifications

linear_update_notification

Mark a notification as read or unread in Linear

Input

ParameterTypeRequiredDescription
notificationIdstringYesNotification ID to update
readAtstringNoTimestamp to mark as read (ISO format). Pass null or omit to mark as unread

Output

ParameterTypeDescription
notificationobjectThe updated notification

linear_create_customer

Create a new customer in Linear

Input

ParameterTypeRequiredDescription
namestringYesCustomer name
domainsarrayNoDomains associated with this customer
externalIdsarrayNoExternal IDs from other systems
logoUrlstringNoCustomer's logo URL
ownerIdstringNoID of the user who owns this customer
revenuenumberNoAnnual revenue from this customer
sizenumberNoSize of the customer organization
statusIdstringNoCustomer status ID
tierIdstringNoCustomer tier ID

Output

ParameterTypeDescription
customerobjectThe created customer

linear_list_customers

List all customers in Linear

Input

ParameterTypeRequiredDescription
firstnumberNoNumber of customers to return (default: 50)
afterstringNoCursor for pagination
includeArchivedbooleanNoInclude archived customers (default: false)

Output

ParameterTypeDescription
customersarrayArray of customers

linear_create_customer_request

Create a customer request (need) in Linear. Assign to customer, set urgency (priority: 0 = Not important, 1 = Important), and optionally link to an issue.

Input

ParameterTypeRequiredDescription
customerIdstringYesCustomer ID to assign this request to
bodystringNoDescription of the customer request
prioritynumberNoUrgency level: 0 = Not important, 1 = Important (default: 0)
issueIdstringNoIssue ID to link this request to
projectIdstringNoProject ID to link this request to

Output

ParameterTypeDescription
customerNeedobjectThe created customer request

linear_update_customer_request

Update a customer request (need) in Linear. Can change urgency, description, customer assignment, and linked issue.

Input

ParameterTypeRequiredDescription
customerNeedIdstringYesCustomer request ID to update
bodystringNoUpdated description of the customer request
prioritynumberNoUpdated urgency level: 0 = Not important, 1 = Important
customerIdstringNoNew customer ID to assign this request to
issueIdstringNoNew issue ID to link this request to
projectIdstringNoNew project ID to link this request to

Output

ParameterTypeDescription
customerNeedobjectThe updated customer request

linear_list_customer_requests

List all customer requests (needs) in Linear

Input

ParameterTypeRequiredDescription
firstnumberNoNumber of customer requests to return (default: 50)
afterstringNoCursor for pagination
includeArchivedbooleanNoInclude archived customer requests (default: false)

Output

ParameterTypeDescription
customerNeedsarrayArray of customer requests

linear_get_customer

Get a single customer by ID in Linear

Input

ParameterTypeRequiredDescription
customerIdstringYesCustomer ID to retrieve

Output

ParameterTypeDescription
customerobjectThe customer data

linear_update_customer

Update a customer in Linear

Input

ParameterTypeRequiredDescription
customerIdstringYesCustomer ID to update
namestringNoUpdated customer name
domainsarrayNoUpdated domains
externalIdsarrayNoUpdated external IDs
logoUrlstringNoUpdated logo URL
ownerIdstringNoUpdated owner user ID
revenuenumberNoUpdated annual revenue
sizenumberNoUpdated organization size
statusIdstringNoUpdated customer status ID
tierIdstringNoUpdated customer tier ID

Output

ParameterTypeDescription
customerobjectThe updated customer

linear_delete_customer

Delete a customer in Linear

Input

ParameterTypeRequiredDescription
customerIdstringYesCustomer ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_merge_customers

Merge two customers in Linear by moving all data from source to target

Input

ParameterTypeRequiredDescription
sourceCustomerIdstringYesSource customer ID (will be deleted after merge)
targetCustomerIdstringYesTarget customer ID (will receive all data)

Output

ParameterTypeDescription
customerobjectThe merged target customer

linear_create_customer_status

Create a new customer status in Linear

Input

ParameterTypeRequiredDescription
namestringYesCustomer status name
colorstringYesStatus color (hex code)
displayNamestringNoDisplay name for the status
descriptionstringNoStatus description
positionnumberNoPosition in status list

Output

ParameterTypeDescription
customerStatusobjectThe created customer status

linear_update_customer_status

Update a customer status in Linear

Input

ParameterTypeRequiredDescription
statusIdstringYesCustomer status ID to update
namestringNoUpdated status name
colorstringNoUpdated status color
displayNamestringNoUpdated display name
descriptionstringNoUpdated description
positionnumberNoUpdated position

Output

ParameterTypeDescription
customerStatusobjectThe updated customer status

linear_delete_customer_status

Delete a customer status in Linear

Input

ParameterTypeRequiredDescription
statusIdstringYesCustomer status ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_list_customer_statuses

List all customer statuses in Linear

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
customerStatusesarrayList of customer statuses

linear_create_customer_tier

Create a new customer tier in Linear

Input

ParameterTypeRequiredDescription
namestringYesCustomer tier name
colorstringYesTier color (hex code)
displayNamestringNoDisplay name for the tier
descriptionstringNoTier description
positionnumberNoPosition in tier list

Output

ParameterTypeDescription
customerTierobjectThe created customer tier

linear_update_customer_tier

Update a customer tier in Linear

Input

ParameterTypeRequiredDescription
tierIdstringYesCustomer tier ID to update
namestringNoUpdated tier name
colorstringNoUpdated tier color
displayNamestringNoUpdated display name
descriptionstringNoUpdated description
positionnumberNoUpdated position

Output

ParameterTypeDescription
customerTierobjectThe updated customer tier

linear_delete_customer_tier

Delete a customer tier in Linear

Input

ParameterTypeRequiredDescription
tierIdstringYesCustomer tier ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_list_customer_tiers

List all customer tiers in Linear

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
customerTiersarrayList of customer tiers

linear_delete_project

Delete a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_create_project_label

Create a new project label in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesThe project for this label
namestringYesProject label name
colorstringNoLabel color (hex code)
descriptionstringNoLabel description
isGroupbooleanNoWhether this is a label group
parentIdstringNoParent label group ID

Output

ParameterTypeDescription
projectLabelobjectThe created project label

linear_update_project_label

Update a project label in Linear

Input

ParameterTypeRequiredDescription
labelIdstringYesProject label ID to update
namestringNoUpdated label name
colorstringNoUpdated label color
descriptionstringNoUpdated description

Output

ParameterTypeDescription
projectLabelobjectThe updated project label

linear_delete_project_label

Delete a project label in Linear

Input

ParameterTypeRequiredDescription
labelIdstringYesProject label ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_list_project_labels

List all project labels in Linear

Input

ParameterTypeRequiredDescription
projectIdstringNoOptional project ID to filter labels for a specific project

Output

ParameterTypeDescription
projectLabelsarrayList of project labels

linear_add_label_to_project

Add a label to a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID
labelIdstringYesLabel ID to add

Output

ParameterTypeDescription
successbooleanWhether the label was added successfully
projectIdstringThe project ID

linear_remove_label_from_project

Remove a label from a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID
labelIdstringYesLabel ID to remove

Output

ParameterTypeDescription
successbooleanWhether the label was removed successfully
projectIdstringThe project ID

linear_create_project_milestone

Create a new project milestone in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID
namestringYesMilestone name
descriptionstringNoMilestone description
targetDatestringNoTarget date (ISO 8601)

Output

ParameterTypeDescription
projectMilestoneobjectThe created project milestone

linear_update_project_milestone

Update a project milestone in Linear

Input

ParameterTypeRequiredDescription
milestoneIdstringYesProject milestone ID to update
namestringNoUpdated milestone name
descriptionstringNoUpdated description
targetDatestringNoUpdated target date (ISO 8601)

Output

ParameterTypeDescription
projectMilestoneobjectThe updated project milestone

linear_delete_project_milestone

Delete a project milestone in Linear

Input

ParameterTypeRequiredDescription
milestoneIdstringYesProject milestone ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_list_project_milestones

List all milestones for a project in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesProject ID to list milestones for

Output

ParameterTypeDescription
projectMilestonesarrayList of project milestones

linear_create_project_status

Create a new project status in Linear

Input

ParameterTypeRequiredDescription
projectIdstringYesThe project to create the status for
namestringYesProject status name
colorstringYesStatus color (hex code)
descriptionstringNoStatus description
indefinitebooleanNoWhether the status is indefinite
positionnumberNoPosition in status list

Output

ParameterTypeDescription
projectStatusobjectThe created project status

linear_update_project_status

Update a project status in Linear

Input

ParameterTypeRequiredDescription
statusIdstringYesProject status ID to update
namestringNoUpdated status name
colorstringNoUpdated status color
descriptionstringNoUpdated description
indefinitebooleanNoUpdated indefinite flag
positionnumberNoUpdated position

Output

ParameterTypeDescription
projectStatusobjectThe updated project status

linear_delete_project_status

Delete a project status in Linear

Input

ParameterTypeRequiredDescription
statusIdstringYesProject status ID to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful

linear_list_project_statuses

List all project statuses in Linear

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
projectStatusesarrayList of project statuses

Notes

  • Category: tools
  • Type: linear
On this page

On this page

Usage Instructions
Tools
linear_read_issues
Input
Output
linear_get_issue
Input
Output
linear_create_issue
Input
Output
linear_update_issue
Input
Output
linear_archive_issue
Input
Output
linear_unarchive_issue
Input
Output
linear_delete_issue
Input
Output
linear_search_issues
Input
Output
linear_add_label_to_issue
Input
Output
linear_remove_label_from_issue
Input
Output
linear_create_comment
Input
Output
linear_update_comment
Input
Output
linear_delete_comment
Input
Output
linear_list_comments
Input
Output
linear_list_projects
Input
Output
linear_get_project
Input
Output
linear_create_project
Input
Output
linear_update_project
Input
Output
linear_archive_project
Input
Output
linear_list_users
Input
Output
linear_list_teams
Input
Output
linear_get_viewer
Input
Output
linear_list_labels
Input
Output
linear_create_label
Input
Output
linear_update_label
Input
Output
linear_archive_label
Input
Output
linear_list_workflow_states
Input
Output
linear_create_workflow_state
Input
Output
linear_update_workflow_state
Input
Output
linear_list_cycles
Input
Output
linear_get_cycle
Input
Output
linear_create_cycle
Input
Output
linear_get_active_cycle
Input
Output
linear_create_attachment
Input
Output
linear_list_attachments
Input
Output
linear_update_attachment
Input
Output
linear_delete_attachment
Input
Output
linear_create_issue_relation
Input
Output
linear_list_issue_relations
Input
Output
linear_delete_issue_relation
Input
Output
linear_create_favorite
Input
Output
linear_list_favorites
Input
Output
linear_create_project_update
Input
Output
linear_list_project_updates
Input
Output
linear_create_project_link
Input
Output
linear_list_notifications
Input
Output
linear_update_notification
Input
Output
linear_create_customer
Input
Output
linear_list_customers
Input
Output
linear_create_customer_request
Input
Output
linear_update_customer_request
Input
Output
linear_list_customer_requests
Input
Output
linear_get_customer
Input
Output
linear_update_customer
Input
Output
linear_delete_customer
Input
Output
linear_merge_customers
Input
Output
linear_create_customer_status
Input
Output
linear_update_customer_status
Input
Output
linear_delete_customer_status
Input
Output
linear_list_customer_statuses
Input
Output
linear_create_customer_tier
Input
Output
linear_update_customer_tier
Input
Output
linear_delete_customer_tier
Input
Output
linear_list_customer_tiers
Input
Output
linear_delete_project
Input
Output
linear_create_project_label
Input
Output
linear_update_project_label
Input
Output
linear_delete_project_label
Input
Output
linear_list_project_labels
Input
Output
linear_add_label_to_project
Input
Output
linear_remove_label_from_project
Input
Output
linear_create_project_milestone
Input
Output
linear_update_project_milestone
Input
Output
linear_delete_project_milestone
Input
Output
linear_list_project_milestones
Input
Output
linear_create_project_status
Input
Output
linear_update_project_status
Input
Output
linear_delete_project_status
Input
Output
linear_list_project_statuses
Input
Output
Notes
Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started