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

# Linear

> Connect Linear to let ewake create issues from incidents and surface relevant in-progress work.

<Info>
  **What you'll get:** ewake can create Linear issues directly from an incident investigation and cross-reference active issues with production problems, surfacing in-progress work that might explain unexpected behaviour.
</Info>

***

## Prerequisites

* A Linear account with access to the workspace you want to connect
* Permission to create API keys in Linear

***

## Configuration

<Steps>
  <Step title="Generate a Linear API key">
    In Linear, go to **Settings** → **API** → **Personal API keys** → click **Create key**.

    Give it a name (e.g. `ewake`) and copy the key immediately.

    <Note>
      Copy the key now, Linear will not show it again after closing the modal.
    </Note>
  </Step>

  <Step title="Open the Linear integration in ewake">
    In your ewake dashboard, go to **Integrations** → **Linear** → click **Configure**.

    <Frame>
      <img src="https://mintcdn.com/ewakeai/M1QmRrA-jDM2VkcE/images/integrations/project-management/linear/connect-modal.png?fit=max&auto=format&n=M1QmRrA-jDM2VkcE&q=85&s=8df59619c452f40d29935a6e5f003027" alt="Connect to Linear modal in ewake" width="943" height="406" data-path="images/integrations/project-management/linear/connect-modal.png" />
    </Frame>
  </Step>

  <Step title="Enter your API key">
    | Field              | Value                     |
    | ------------------ | ------------------------- |
    | **Linear API Key** | The key created in Step 1 |
  </Step>

  <Step title="Test and save">
    Click **Test Configuration** to verify the connection, then click **Save**.

    <Check>
      Linear is connected. Ewake can now reference and create issues from the investigation flow.
    </Check>
  </Step>
</Steps>
