Linear

Overview

A project management tool for software teams that streamlines issue tracking. Through Langdock’s integration, you can access and manage Linear directly from your conversations.

Authentication: OAuth Category: Development & Issue Tracking Availability: All workspace plans

Available Actions

Create Issue

linear.createIssue

Creates an issue in Linear Requires Confirmation: Yes Parameters:

• teamId (TEXT, Required): The ID of the team to create the issue in. Team id’s can be retrieved using the ‘Get teams’ action

• title (TEXT, Required): The title of the issue

• description (TEXT, Optional): The description of the issue in markdown format

• options (OBJECT, Optional): Provide additional Linear issue properties as a JSON object. This field accepts any valid Linear issue fields beyond the basic ones above

Output: Returns the created issue with ID, title, identifier, URL, priority, state, assignee, and labels

---

Create Comment

linear.createComment

Creates a new issue comment in Linear Requires Confirmation: Yes Parameters:

• issueId (TEXT, Optional): The ID of the issue to comment on

• commentBody (TEXT, Required): The body of the comment to add

Output: Returns the created comment with ID and content

---

Update an Issue

linear.updateanIssue

Updates an existing issue in Linear Requires Confirmation: Yes Parameters:

• title (TEXT, Optional): The new title of the issue

• assigneeId (TEXT, Optional): The ID of the person assigned to the task

• stateId (TEXT, Optional): The state of the issue. Can be Backlog, Todo, To discuss, In Progress, Blocked, In Review, Waiting for Release, Done, Canceled, Triage

• issueId (TEXT, Required): The ID of the issue that should be updated

Output: Returns the updated issue with new values

---

Get Issue Details

linear.getIssueDetails

Gets the details of a specific issue Requires Confirmation: No Parameters:

• issueId (TEXT, Required): The ID of the issue

Output: Returns issue details including ID, title, description, state, assignee, labels, and other properties

---

Get Team Members

linear.getTeamMembers

Gets all team members in a given Linear team Requires Confirmation: No Parameters:

• teamId (TEXT, Required): The ID of the team

Output: Returns array of team members with their IDs, names, and other details

---

Get Current User

linear.getCurrentUser

Get the user details of your profile in Linear Requires Confirmation: No Parameters: None Output: Returns current user details including ID, name, email, and other profile information

---

Get Teams

linear.getTeams

Lists all teams in Linear workspace Requires Confirmation: No Parameters: None Output: Returns array of teams with their IDs, names, and other details

---

Get Issues in Team

linear.getIssuesinTeam

Gets all issues from a given team Requires Confirmation: No Parameters:

• teamId (TEXT, Required): The team ID to use for searching issues

Output: Returns array of issues in the specified team

---

Search Issues

linear.searchIssues

Searches for issues in Linear Requires Confirmation: No Parameters:

• teamId (TEXT, Optional): The ID of the team to search issues in. Leave empty to search across all teams

• query (TEXT, Optional): Text to search for in issue titles and descriptions

• status (TEXT, Optional): Filter by issue status (e.g., ‘backlog’, ‘in_progress’, ‘done’)

• assigneeId (TEXT, Optional): Filter issues by assignee ID

• limit (TEXT, Optional): Maximum number of issues to return (default: 50, max: 100)

Output: Returns array of issues matching the search criteria

Common Use Cases

• Data Management — Manage and organize your Linear data

• Automation — Automate workflows with Linear

• Reporting — Generate insights and reports

• Integration — Connect Linear with other tools

Best Practices

1

Getting Started

• Enable the Linear integration in your workspace settings

• Authenticate using OAuth

• Test the connection with a simple read operation

• Explore available actions for your use case

2

Important Considerations

• Ensure proper authentication credentials

• Respect rate limits and API quotas

• Review data privacy settings

• Test operations in a safe environment first

Troubleshooting

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

Support

For additional help with the Linear integration, contact [email protected]