Skip to content
TraceXDocs
Where issues come from

Linear

Connect Linear so issues with the TraceX label are investigated automatically and the root cause and fix are posted as a comment.

Add the TraceX label to a Linear issue: TraceX investigates and comments the root cause and fix.

Why connect Linear

Section titled “Why connect Linear”

Linear is where your engineers plan their work, and bug reports pile up there faster than anyone can look into them. A label hands an issue to TraceX: it comes back with the cause and a proposed fix, so the engineer who picks it up starts from an answer.

Connect

Section titled “Connect”

  1. Open Integrations → Linear and fill in:

    Field Value
    API key Settings → API → Personal API keys
    Label optional, default TraceX

    Keys are checked with a real read, then encrypted and never shown again.

  2. TraceX shows a webhook address. Copy it and finish in Linear:

    1. Settings → API → Webhooks → New webhook: paste the address and choose Issues.
    2. Create a label named TraceX (or the label you chose).
    3. Add the label to an issue: TraceX investigates and comments.

TraceX only reads the items it is sent and adds internal notes. It never replies to customers on its own.

Troubleshooting

Section titled “Troubleshooting”
Problem What to check
Labelled issues aren’t picked up Check the webhook is enabled for Issues and the label name matches exactly.
The key check fails Create a new personal API key and paste it again.

Remove access

Section titled “Remove access”

Disconnect Linear in Integrations, delete the webhook and revoke the API key in Linear.

Section titled “Related”