# Linear

---
title: Connecting Linear to WatchDog Security
category: Integrations
integration_type: oauth
products_supported:
  - Posture Management
  - Inventory
---

## Overview

This guide explains how to connect **Linear** to WatchDog Security using OAuth authentication.

Once connected, WatchDog will monitor your Linear workspace for **security posture risks, configuration issues, and asset inventory data** related to users, teams, and workspace settings.

---

## What WatchDog Monitors

:::tip[]
WatchDog operates in **read-only mode** and does **not modify configuration settings** within your Linear workspace.
:::

After the integration is connected, WatchDog may monitor:

<Accordion title="Scopes" defaultOpen>

**Workspace & Organization**

- Workspace configuration
- Organization settings
- Team structures

**Users & Access**

- Users and user status
- Roles and permissions
- User access levels

**Teams & Collaboration**

- Teams and team membership
- Team permissions and structure

**Authentication & Security**

- Authentication methods
- Access controls and workspace security settings

**Projects & Issues (Metadata Only)**

- Project metadata
- Issue metadata (non-content)

</Accordion>

The exact information collected depends on the permissions granted during OAuth authorization.

---

## Requirements

Before connecting the integration, ensure the following:

- You have access to a **Linear workspace**
- You're an **Account Owner** or **Security Admin** in WatchDog Security
- The user connecting the integration has sufficient permissions within Linear to authorize third-party applications

---

## Important Behavior

:::note[]
Understanding how the Linear integration works ensures proper setup and data visibility.
:::

- WatchDog uses OAuth to access Linear data in **read-only mode**
- Data visibility depends on the permissions of the user authorizing the integration
- Only resources accessible to the authorized user will be monitored

---

## Step 1 — Open the Integration in WatchDog

1. Log into the [**WatchDog Security Portal**](https://app.watchdogsecurity.io)
2. Navigate to Management → Integrations
3. Locate **Linear**
4. Click **Connect**

---

## Step 2 — Authorize Linear

:::note[]
After authorization is completed, you will automatically be redirected back to WatchDog Security.
:::

You will be redirected to the **Linear authorization page**.

1. Select the Linear workspace
2. Review the requested permissions
3. Click **Authorize**

WatchDog will securely store the OAuth token and begin syncing workspace data.

---

## Permissions Required
WatchDog requires permission to:

- Read workspace and organization configuration
- Access users, teams, and membership data
- Retrieve project and issue metadata
- Access workspace security and authentication settings

WatchDog does **not require write access** to modify Linear data.

---

## Initial Sync

<Accordion title="After the integration is connected" defaultOpen>

- WatchDog will begin collecting Linear workspace data
- The initial synchronization typically completes within **5–10 minutes**

</Accordion>

<Accordion title="Data appears in the following modules" defaultOpen>

- **Posture Management**
- **Inventory**

</Accordion>

---

## Revoking Access

To fully remove WatchDog access from Linear, revoke access in both WatchDog and Linear.

### Step 1 — Disconnect in WatchDog

1. Log into **WatchDog Security**
2. Navigate to **Management → Integrations**
3. Locate **Linear**
4. Click **Disconnect**

---

### Step 2 — Remove Access in Linear

1. Log into Linear
2. Navigate to: `Settings → Security & Access → Applications`
3. Locate **WatchDog Security**
4. Remove or revoke access

This revokes OAuth authorization and prevents further data access.

---

## Troubleshooting

<AccordionGroup>

<Accordion title="No Data Appears" defaultOpen>

Verify:

- OAuth authorization completed successfully
- The correct workspace was selected
- Wait for the initial sync to complete

</Accordion>

<Accordion title="Authorization Failed">

Verify:

- The user has sufficient permissions in Linear
- OAuth authorization was completed successfully

</Accordion>

</AccordionGroup>