Integrations

Linear integration

Connect Linear to let an Agent create and manage issues, find issues, list teams and projects, and add comments. Linear provides Agent tools rather than a dedicated Flow step.

Before you begin

Create a personal API key in Linear Settings > API. Linear API keys start with lin_api_.

Connect Linear

Connect Linear in Settings > Integrations, then add its tools to an Agent:

  1. In Runtype, open Settings > Integrations.
  2. Find Linear, and click Configure.
  3. Enter your Linear API key in the API Key field.
  4. Click Save.
  5. In the Agent editor, click Add Tool or Configure Tools.
  6. Select Linear and the tools that you want to add.
  7. Click Apply Changes.

Runtype stores the API key in integration settings. Agents that include Linear tools use the configured key.

Available tools

After you connect Linear, add the tools that your Agent needs from the following list:

  • create_issue: Create an issue with a title and team, and optionally set its description, assignee, priority, state, labels, project, and estimate.
  • update_issue: Update an issue’s title, description, assignee, priority, or state.
  • search_issues: Find issues and optionally filter them by team or assignee.
  • get_issue: Get issue details by ID or identifier, such as ENG-123.
  • list_teams: List all teams in the workspace.
  • list_projects: List projects, optionally filtered by team.
  • add_comment: Add a comment to an issue.

Select the tools that your Agent needs when you configure the Agent.

Use cases

Use Linear tools for the following tasks:

  • Bug reporting: Create issues from customer feedback.
  • Feature requests: Track requests from chat interactions.
  • Escalations: Create urgent issues when an Agent detects a problem.
  • Monitoring: Log anomalies from scheduled Agent runs.

Remove Linear access

To stop an Agent from using Linear, remove its Linear tools in the Agent editor. To remove the stored API key, open Settings > Integrations. Find Linear, and click Remove. Revoke the API key in Linear after you stop using it.

Next steps