> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/ticketing-and-messaging/ticket-management/linear.md).
# Linear
Linear is a modern issue tracking and project management platform designed for software development teams. It helps organizations plan work, track issues, manage projects, and coordinate development efforts through streamlined workflows and collaboration tools.
Integrating OX Security with Linear brings security findings directly into your development workflow. Security issues detected by OX can be created as Linear tickets, linked to existing Linear work items, or automatically tracked through workflows, helping security and engineering teams collaborate on remediation within their existing development processes.
**Benefits of the integration include:**
* **Centralized Issue Management:** Track and manage security findings alongside development work in Linear.
* **Faster Remediation:** Create and assign tickets directly from OX to ensure security issues are addressed by the appropriate teams.
* **Improved Collaboration:** Give security and engineering teams shared visibility into security findings and remediation progress.
* **Automated Workflows:** Automatically create Linear tickets based on OX policies and issue conditions.
* **Consistent Development Processes:** Manage security issues using the same planning, prioritization, and tracking workflows already used by your development teams.
## Adding Linear tickets
After [establishing the connection with Linear](#connecting-to-linear), you can add Linear tickets to issues in OX using one of the following methods:
* Creating a new Linear ticket.
* Linking an existing Linear ticket.
* Creating Linear tickets automatically using workflows.
### Creating a new Linear ticket
Create a new Linear ticket when the issue is not yet being tracked in Linear and you want OX to create a new work item for remediation.
**To create a new Linear ticket in OX:**
1. On the **Active Issues** page, identify and select the issue for which you want to add a new ticket in Linear.
2. In the issue details dialog, on the bottom, go to **More Actions** and select **Linear Actions > Create Linear Ticket**.
3. Configure the ticket settings.
| Parameter | Description |
| --------- | ------------------------------------------------------------------ |
| Title | The title of the ticket. By default, OX populates the issue title. |
| Team | The Linear team that owns the ticket. |
| Project | The Linear project associated with the ticket. |
| Status | The initial workflow status of the ticket. |
| Priority | The priority assigned to the ticket. |
| Assignee | The team member assigned to the ticket. |
| Labels | Labels to apply to the ticket. |
4. Select **Save Changes**.
The new ticket appears in Linear.
### Linking an existing Linear ticket
Link an existing Linear ticket when the remediation work is already being tracked in Linear, and you want to associate the OX issue with that existing work item.
For example, a developer may have already created a ticket to address the issue, or the issue may already be tracked as part of a larger remediation effort.
> **Note**
>
> An OX issue can be associated with multiple Linear tickets. For example, you can create a new Linear ticket and later link additional existing Linear tickets to the same issue.
**To link an OX issue to an existing ticket(s) in Linear:**
1. On the **Active Issues** page, select the issue to which you want to link an existing Linear ticket.
2. In the issue details dialog, on the bottom, go to **More Actions** and select **Linear Actions > Link Linear Ticket**.
3. Enter the Linear ticket key or ID.
4. Select **Link Ticket**.
The existing Linear ticket is associated with the OX issue and appears in the **Related Tickets** section in Linear.
### Unlinking a Linear ticket
Unlink a Linear ticket when you want to remove the association between an OX issue and a Linear ticket without deleting the ticket from Linear.
**To unlink Linear tickets from OX issues:**
1. On the **Active Issues** page, select the issue that you want to unlink from an existing Linear ticket.
2. In the issue details dialog, on the bottom, go to **More Actions** and select **Linear Actions > Unlink Linear Ticket**.
3. Select **Unlink Ticket**.
The ticket remains in Linear but is no longer associated with the OX issue.
## Connecting to Linear
### Prerequisites
* A Linear workspace.
* A Linear user account with permission to create personal API keys.
* Permission to create and manage issues in the target Linear team.
### Step 1: Create a Linear API key
1. Sign in to Linear.
2. Select your profile picture and then select **Settings**.
3. In the left navigation pane, select **Security & access >** **Personal API keys**.
4. Select **New API key**.
5. Enter a descriptive name for the API key, such as **oxkey**.
6. Select **Create**.
7. Copy the generated API key and store it in a secure location, as Linear displays the API key only once.
### Step 2: Connect Linear to OX
1. In the OX platform, go to **Settings** > **Connectors**.
2. Select **Linear**.
3. Configure the connector settings.
| Parameter | Description |
| --------- | ----------------------------------------- |
| API Key | The personal API key generated in Linear. |
4. Select **Connect**.
OX verifies the connection and displays the connector status.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.ox.security/ticketing-and-messaging/ticket-management/linear.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.