# Linear

{% hint style="info" %}
This integration is currently in beta.
{% endhint %}

## Linear Setup

Generate an API key in Linear:

1. Log in to your Linear workspace at **linear.app**.
2. Navigate to **Settings > Security & access**.
3. Under **Personal API Keys**, click **New API Key**.
4. Give your key a descriptive name (e.g., "Halo Security Integration").
5. Copy the generated API key.

## Connect Linear to Halo Security

1. Navigate to *Settings → Integrations →* [Add](https://app.halosecurity.com/user/settings/integrations/add).
2. Select **Linear** from the list of available integrations.
3. Name the integration and click **Add**.
4. Enter your **API Key**.
5. Click **Save**.

## Create Profiles

After connecting Jira, you can create profiles to control how tickets are created. To create a profile:

1. Navigate to the **Profiles** tab
2. Click the **+** icon
3. Enter a name for the profile
4. Configure your settings:
   1. **Team**
   2. **Project**
   3. **Assigned To**
   4. **Default Priority**
5. Click **Save**

## Create Issues

### Manually Create Linear Issues

When viewing an [Issue](/docs/platform/issues.md), you can easily create an individual Linear issue for the issue.

1. Click the **Plug icon** in the top right
2. Select the Profile you'd like to use
3. Make any adjustments to the ticket details
4. Click **Create Issue**

### Automatically Create Linear Issues for Halo Security Issues

To create tickets for issues, we recommend using Automations.;

* Navigate to *Settings →* [Automations](https://app.halosecurity.com/user/settings/automations/)
* Create a filter with the type as **Target Issue**
* Apply the profile you created as an action

Learn more about Automations:

{% content-ref url="/pages/iq99K8aC1ETIXaLg4FrK" %}
[Automations](/docs/platform/automations.md)
{% endcontent-ref %}

### Automatically Create Linear Issues for Additional Events

Event rules allow you to create a Linear issues for Halo Security events beyond issues. For example, you can create a Linear issue when a new port is opened or a new target is added.

To receive Linear issues, create Event Rules and add your Linear profile as an action.

Visit *Events →* [Event Rules](https://app.halosecurity.com/user/settings/event-rules/) to set up rules that determine which events created Tickets in Jira.

Learn more about configuring Event Rules:

{% content-ref url="/pages/QVrCXwRcuy8YWA5L25VR" %}
[Event Rules](/docs/platform/events/alerts.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.halosecurity.com/docs/integrations/workflow-integrations/linear.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.