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

Getting Started:
  1. Enable the Linear integration in your workspace settings
  2. Authenticate using OAuth
  3. Test the connection with a simple read operation
  4. Explore available actions for your use case
Important Considerations:
  • Ensure proper authentication credentials
  • Respect rate limits and API quotas
  • Review data privacy settings
  • Test operations in a safe environment first

Troubleshooting

IssueSolution
Authentication failedVerify your OAuth credentials
Rate limit exceededReduce request frequency
Data not foundCheck permissions and data availability
Connection timeoutVerify network connectivity

Support

For additional help with the Linear integration, contact support@langdock.com