# Linear

> Verbind Linear met Tidal Control zodat compliance tests bijhouden hoe high-priority werk in je teams wordt beheerd. Alleen-lezen, ook als externe issue tracker.

Source: https://tidalcontrol.com/nl/docs/integrations/linear

Tidal Control's Linear integratie monitort je issue tracker voor compliance doeleinden en houdt bij hoe high-priority werk wordt beheerd binnen je teams.

## Wat deze integratie monitort

- **Issues:** Toewijzing en oplossing van urgente en high-priority issues
- **Users:** Aanwezigheid van actieve gebruikers in je workspace

## Vereisten

- Super User rol in Tidal Control
- Linear account met API-toegang

## Configuratie stappenplan

We maken een **Linear API key** aan en voegen de verbinding toe in Tidal Control.

**Configuratie stappen:**

1. **API key aanmaken**
2. **Integratie configureren in Tidal Control**

## Stap 1: API key aanmaken

- Log in op je Linear account
- Klik op je **profielfoto** of naam linksonder in het scherm
- Selecteer **Settings**
- Navigeer naar **API** in de linker zijbalk
- Klik onder **Personal API keys** op **Create key**
- Voer een label in (bijv. `Tidal Control`)
- Klik op **Create key**
- **Kopieer de key-waarde**: deze wordt slechts één keer getoond

> **warning:**

**Sla de API key direct op.** Linear toont de volledige key-waarde slechts één keer bij aanmaken. Als je het dialoogvenster sluit zonder te kopiëren, moet je een nieuwe key aanmaken.

## Stap 2: Integratie configureren in Tidal Control

- Ga naar **Instellingen → Integraties** in Tidal Control
- Klik op het **plus-icoon** naast **Linear**
- Vul de configuratie in:
  - **Name:** Een beschrijvende naam, bijv. `Linear`
  - **API Key:** De API key uit stap 1
- Klik op **"Maken"** om de integratie op te slaan

## Configuratievelden uitgelegd

Het integratievenster vraagt om de volgende waarden:

**Name:**
- Een beschrijvende naam voor deze verbinding
- Bijvoorbeeld: `Linear`, `Linear Productie`

**API Key:**
- Je persoonlijke Linear API key
- Aangemaakt in stap 1
- Houd deze waarde veilig

## Verificatie

De integratie werkt wanneer het volgende allemaal klopt:

- Instellingen → Integraties toont Linear onder **Geconfigureerde integraties**
- Linear tests zijn beschikbaar in de Tests sectie
- Test refresh levert resultaten zonder authenticatiefouten

## Veelgestelde vragen

**Kan ik een team API key gebruiken in plaats van een persoonlijke?**
Tidal Control gebruikt persoonlijke API keys. Zorg dat het account dat de key aanmaakt toegang heeft tot de teams en issues die je wilt monitoren.

**Leest de integratie alle teams in mijn workspace?**
Ja, de integratie leest alle teams, issues en gebruikers die toegankelijk zijn voor het account dat de API key heeft aangemaakt.

**Heb ik admin-toegang nodig in Linear om een API key aan te maken?**
Nee, elke Linear-gebruiker kan een persoonlijke API key aanmaken in de eigen instellingen.

## Veelvoorkomende problemen

**"API Key is required"**
- Zorg dat je de key-waarde hebt ingevoerd, niet het key-label
- De key begint normaal gesproken met `lin_api_`

**Tests tonen geen data na verbinding**
- Controleer of het Linear account toegang heeft tot minimaal één team en bijbehorende issues
- Probeer de tests handmatig te vernieuwen

### Kom je er nog niet uit?

Stuur een e-mail naar support@tidalcontrol.com, en we nemen zo snel mogelijk contact met je op.

> **info:**

**Support info verzamelen:** Noteer welke browser je gebruikt, exacte foutmeldingen, en welke stappen je al geprobeerd hebt. Dit versnelt de oplossing aanzienlijk.