Skip to content
Integrations

Linear connector

1 min read

Connect Linear to track product and engineering work in a client mind.

What it imports

  • Issue title and Markdown description.
  • Current workflow state, including completed and canceled issues.
  • Comments and their authors.

Each issue is stored as one document. When its title, description, state, or

comments change, Linear updates the issue timestamp and Armbrain imports the

new version.

Create a Personal API key

  1. In Linear, open Settings.
  2. Choose Security & access.
  3. Under Personal API keys, select New API key.
  4. Give the key a clear name such as Armbrain.
  5. Copy the key. Linear only shows it once.

The key is encrypted before Armbrain stores it. Linear Personal API keys are

sent directly in the authorization header; Armbrain does not add a Bearer

prefix.

Connect

  1. Open Settings → Connectors in Armbrain HQ.
  2. Choose Linear.
  3. Select the client mind that should receive the issues.
  4. Paste the Personal API key.
  5. Optional: enter a Linear team ID to sync only that team. Leave it blank to sync every issue the key can access.
  6. Select Continue.

The connector validates the key before saving it and begins checking for

updated issues every 15 minutes.

Troubleshooting

  • API key rejected: Create a new Personal API key in Linear and reconnect.
  • No issues appear: Confirm the selected team ID is correct, or reconnect with the team ID blank.
  • Closed work is missing: Closed and canceled issues are included. Check the connector status in HQ for an authentication or source error.
  • Recent comments are missing: The next issue update is picked up on the following 15-minute poll.