> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Connect your Thena tickets with Linear issues for seamless project management and enhanced workflow coordination.

<img src="https://mintcdn.com/thena-840ce5ec/fnPhXvYfm-TNmZho/images/docs/Linear.webp?fit=max&auto=format&n=fnPhXvYfm-TNmZho&q=85&s=f0abfd7e231c1af4745e77ee4ee01598" alt="Viewing a Linear issue from Thena to link" className="rounded-lg" width="2560" height="1600" data-path="images/docs/Linear.webp" />

## Overview

The Linear integration connects your Thena platform with Linear, enabling seamless collaboration between customer support and development teams. This integration provides the following capabilities:

* **Ticket linking**: Connect Thena tickets with Linear issues for complete traceability
* **Issue creation**: Create new Linear issues directly from Thena tickets
* **Issue search**: Find and link existing Linear issues without leaving Thena
* **Synchronized updates**: Keep your project management and customer support systems in sync

## Key features

<CardGroup cols={2}>
  <Card title="Link Linear issues" icon="link">
    * Connect Thena tickets to Linear issues
    * View linked issues in ticket details
    * Unlink issues when needed
  </Card>

  <Card title="Search Linear issues" icon="magnifying-glass">
    * Find existing Linear issues
    * Search by title or ID
    * Link issues directly from search results
  </Card>

  <Card title="Create Linear issues" icon="plus">
    * Create new Linear issues from Thena
    * Select team, template, and issue details
    * Set status, priority, assignee, and labels
  </Card>

  <Card title="Issue tracking" icon="chart-line">
    * View basic issue details in card view (ID, status, priority, assignee)
    * Access comprehensive details when clicking on issues
    * Updates reflected in near real-time
  </Card>
</CardGroup>

## Setup

<Info>
  The Linear integration uses the API key of the user who authenticated it. New Linear issues will be created as this user. If re-authenticated by a different user, subsequent issues will reflect the new user. We recommend using a dedicated Linear account for the integration.
</Info>

<Steps>
  <Step title="Begin installation">
    1. Navigate to the [Apps studio](https://dashboard.thena.ai/organization/settings/apps-studio) in your Thena dashboard
    2. Find the Linear integration in the available apps
    3. Click the "Install" button to begin the installation process
  </Step>

  <Step title="Review and configure">
    1. Review the permissions and scopes required by the integration
    2. Select the teams in Thena where you want to install Linear
  </Step>

  <Step title="Complete authorization">
    1. After configuration, click "Complete Linear authorization"
    2. You'll be redirected to Linear to authorize the connection
    3. Grant the necessary permissions for the integration
    4. You'll be redirected back to Thena once authorization is complete
  </Step>

  <Step title="Verify connection">
    1. Open a ticket in Thena
    2. Navigate to the Linear section in the ticket details
    3. Search for a Linear issue to confirm the connection is working
    4. Verify that issue data is correctly displayed
  </Step>
</Steps>

## How to link a Linear issue

<AccordionGroup>
  <Accordion title="From ticket details">
    1. Open a ticket in Thena
    2. Navigate to the Linear section in the ticket details panel
    3. Click the "Search issue" button
    4. Enter the Linear issue key or search by keywords
    5. Select the appropriate issue from the search results
    6. Click "Link" to connect the Thena ticket with the Linear issue
  </Accordion>

  <Accordion title="Using internal threads">
    1. Open a ticket in Thena
    2. Add a comment in any internal thread
    3. Include a Linear issue link or key (e.g., PRJ-123 or [https://linear.app/your-org/issue/PRJ-123](https://linear.app/your-org/issue/PRJ-123))
    4. The system will automatically detect and link the Linear issue to your ticket

    When a Linear issue is linked through an internal thread:

    * You'll see the issue summary, status, priority, and assignee
    * Click on the issue to open it directly in Linear
  </Accordion>
</AccordionGroup>

## How to search for a Linear issue

<Steps>
  <Step title="Access search">
    1. Open a ticket in Thena
    2. Navigate to the Linear section in the ticket details
    3. Click the "Search issue" button
  </Step>

  <Step title="Enter search criteria">
    1. Type your search query in the search field
    2. You can search by issue key (e.g., PRJ-123) for exact matches
    3. Or search by keywords to find relevant issues
    4. You can also filter by project using the dropdown menu
  </Step>

  <Step title="Select and link">
    1. Review the search results showing issue summaries and statuses
    2. Click "Link" to connect the selected issue with your Thena ticket
  </Step>
</Steps>

## How to create a Linear issue

<Steps>
  <Step title="Initiate creation">
    1. Open a ticket in Thena
    2. Navigate to the Linear section in the ticket details
    3. Click the "Create issue" button
  </Step>

  <Step title="Select team and template">
    1. At the top of the issue creation window, choose the Linear team where you want to create the issue
       * This indicates the Linear project to which the new issue will be added
       * Use the dropdown to change the project to a different one within your Linear workspace
    2. If your Linear workspace has templates set up, you can select one to pre-fill specific fields
    3. Click "Next" to proceed
  </Step>

  <Step title="Fill in issue details">
    1. **Issue title**: Enter a title that summarizes the problem or task
    2. **Description**: Provide detailed information such as steps to reproduce or expected outcomes
    3. **Status**: Select from statuses fetched from the relevant Linear team's configuration
    4. **Priority**: Assign a priority level (Urgent, High, Medium, Low, No priority)
    5. **Assignee**: Designate a team member responsible for this issue (list shows assignees from Linear)
    6. **Labels**: Add relevant labels to categorize and filter issues within your project
    7. **Project**: Confirm the correct project assignment (pre-selected based on team choice)
    8. **Cycle**: Confirm the correct cycle assignment (pre-selected based on team choice)
    9. Click "Create" to finalize the issue
  </Step>

  <Step title="View and manage the linked issue">
    1. The newly created issue will be automatically linked to your Thena ticket
    2. You'll see the issue details in the Linear section of the ticket panel once created
    3. The issue details will show ID, status, priority, and assignee
  </Step>
</Steps>

## Viewing Linear issue details

<Steps>
  <Step title="Access linked issue details">
    1. Open a ticket with a linked Linear issue in Thena
    2. Navigate to the Linear section in the ticket details panel
  </Step>

  <Step title="Understanding issue information">
    The Linear issue details include:

    1. **Status**: Current workflow status of the issue
    2. **Priority**: Issue priority level (Urgent, High, Medium, Low, No priority)
    3. **Assignee**: Team member responsible for the issue
  </Step>

  <Step title="Open in Thena or Linear">
    1. Click on the issue card to open it in Thena
    2. Or, click on the 'Open in Linear' button to open it directly in Linear
    3. Make any necessary updates directly in Linear
    4. Changes will be reflected in Thena in near real-time
  </Step>
</Steps>

## Permission scopes

The Linear app requires specific permissions to function properly. When authorizing the app, you'll be asked to grant the following permission scopes:

<AccordionGroup>
  <Accordion title="Thena platform permissions">
    <CardGroup cols={1}>
      <Card title="ticket:read">
        Access to read ticket information from Thena:

        * Read ticket data for synchronization with Linear
        * Access ticket details for linking with Linear issues
        * View ticket metadata for proper integration
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Linear API capabilities">
    <CardGroup cols={1}>
      <Card title="Team management">
        Access to Linear teams:

        * Get teams and team information
        * Set default teams for issue creation
        * Access team-specific configurations
      </Card>

      <Card title="Issue operations">
        Full issue management capabilities:

        * Create new issues with detailed metadata
        * Search existing issues
        * Link and unlink issues with Thena tickets
        * View issue details including status, priority, and assignee
      </Card>

      <Card title="File operations">
        File handling capabilities:

        * Upload files to Linear
        * Attach files to issues
      </Card>
    </CardGroup>
  </Accordion>
</AccordionGroup>

## FAQs

<AccordionGroup>
  <Accordion title="Can I link multiple Linear issues to a single Thena ticket?">
    Yes, you can link multiple Linear issues to a single Thena ticket. Each linked issue will appear in the Linear section of the ticket details panel, allowing you to track multiple related issues.
  </Accordion>

  <Accordion title="What happens if a linked Linear issue is updated?">
    When a linked Linear issue is updated, the changes will be reflected in the Thena ticket details. This includes updates to status, priority, assignee, labels, and other issue details. The synchronization happens near real-time, ensuring you always have the latest information.
  </Accordion>

  <Accordion title="What information is displayed for Linear issues in Thena?">
    In the card view, the integration displays basic Linear issue information:

    * ID and title
    * Status
    * Priority
    * Assignee

    When you click on the issue card, you'll see comprehensive details including:

    * Title and description
    * Status with all available options from the Linear team's configuration
    * Priority levels
    * Assignee options
    * Labels
    * Project assignment
    * Cycle assignment
  </Accordion>

  <Accordion title="What permissions do I need in Linear for this integration?">
    You need:

    * View permissions for the teams you want to access
    * Create issue permissions if you want to create new issues
    * Edit permissions if you want to update existing issues

    The integration will respect the permissions of the authenticated Linear user.
  </Accordion>

  <Accordion title="Can I unlink a Linear issue from a Thena ticket?">
    Yes, you can unlink a Linear issue from a Thena ticket by clicking the unlink button next to the linked issue in the ticket details panel. This will remove the reference in Thena.
  </Accordion>

  <Accordion title="Is there a limit to how many Linear issues I can link or create?">
    There is no specific limit imposed by the Thena integration on the number of Linear issues you can link or create. However, be mindful of any API rate limits that may be enforced by Linear.
  </Accordion>
</AccordionGroup>