ContextQMD
Back to Airbyte

Linear

docs/integrations/sources/linear.md

2.0.06.8 KB
Original Source

Linear

<HideInUI>

This page contains the setup guide and reference information for the Linear source connector.

</HideInUI>

Linear is a project management and issue tracking tool designed for software teams. It provides a streamlined interface for managing issues, sprints, and product roadmaps with a focus on speed and simplicity.

Prerequisites

  • A Linear account
  • A Linear API key

Setup guide

Step 1: Obtain a Linear API key

  1. Log in to your Linear account.
  2. Navigate to Settings by clicking your workspace name in the sidebar.
  3. Select Security & access from the settings menu.
  4. Scroll to the Personal API keys section.
  5. Click Create key to generate a new API key.
  6. Copy the API key and store it securely. You will need it to configure the connector.

For more information, see the Linear API documentation.

Step 2: Configure the Linear connector in Airbyte

  1. In the Airbyte UI, navigate to Sources and click + New source.
  2. Select Linear from the list of available sources.
  3. Enter a Source name of your choosing.
  4. Enter your API key from Step 1.
  5. Click Set up source and wait for the connection test to complete.

Supported sync modes

The Linear source connector supports the following sync mode:

Supported streams

The Linear source connector supports the following streams:

Stream NameDescription
teamsTeams in your Linear workspace
usersUsers in your Linear workspace
cyclesSprint cycles for teams
issuesIssues and tasks
commentsComments on issues
projectsProjects for organizing issues
customersCustomer records (if using Linear's customer features)
attachmentsFile attachments on issues
issue_labelsLabels for categorizing issues
customer_needsCustomer needs linked to issues
customer_tiersCustomer tier definitions
issue_relationsRelationships between issues
workflow_statesWorkflow states (statuses) for issues
project_statusesStatus definitions for projects
customer_statusesStatus definitions for customers
project_milestonesMilestones within projects

Limitations and troubleshooting

Rate limiting

Linear's API uses a leaky bucket algorithm for rate limiting. The connector handles rate limiting automatically, but syncs may slow down if you are making many concurrent requests to the Linear API. For more information, see Linear's rate limiting documentation.

Data availability

The connector retrieves data that the authenticated user has access to. If you cannot see certain teams, projects, or issues in your synced data, verify that your Linear account has the appropriate permissions.

Changelog

<details> <summary>Expand to review</summary>
VersionDatePull RequestSubject
0.0.352026-03-1775023Update dependencies
0.0.342026-03-0374239Update dependencies
0.0.332026-02-1073035Update dependencies
0.0.322026-02-0372748Update dependencies
0.0.312026-01-2172240fix(linear): icon
0.0.302026-01-2072027Update dependencies
0.0.292026-01-1471489Update dependencies
0.0.282025-12-1870775Update dependencies
0.0.272025-11-2570007Update dependencies
0.0.262025-11-1869442Update dependencies
0.0.252025-10-2968966Update dependencies
0.0.242025-10-2168296Update dependencies
0.0.232025-10-1468027Update dependencies
0.0.222025-10-0767519Update dependencies
0.0.212025-09-3066807Update dependencies
0.0.202025-09-2466655Update dependencies
0.0.192025-09-0965897Update dependencies
0.0.182025-08-2365391Update dependencies
0.0.172025-08-0964629Update dependencies
0.0.162025-08-0264275Update dependencies
0.0.152025-07-2663892Update dependencies
0.0.142025-07-1963518Update dependencies
0.0.132025-07-1263095Update dependencies
0.0.122025-07-0562601Update dependencies
0.0.112025-06-2862178Update dependencies
0.0.102025-06-2661417source-linear contribution from zckymc
0.0.92025-06-2161843Update dependencies
0.0.82025-06-1461117Update dependencies
0.0.72025-05-2460728Update dependencies
0.0.62025-05-1059893Update dependencies
0.0.52025-05-0359299Update dependencies
0.0.42025-04-2658781Update dependencies
0.0.32025-04-1958215Update dependencies
0.0.22025-04-1257669Update dependencies
0.0.12025-04-11#57586Initial release by @natikgadzhi
</details>