Skip to content

Linear

Linear is a purpose-built tool for planning and building products that provides issue tracking and project management for teams.

ingestr supports Linear as a source through Linear's public API.

URI format

The URI format for Linear is:

plaintext
linear://?api_key=<api_key>

URI parameters:

  • api_key: The API key used for authentication with the Linear API.

Example usage

Assuming your API key is lin_api_123, you can ingest teams into DuckDB using:

bash
ingestr ingest
--source-uri 'linear://?api_key=lin_api_123' \
--source-table 'teams' \
--dest-uri duckdb:///linear.duckdb \
--dest-table 'dest.teams'
linear

Tables

Linear source allows ingesting the following tables:

TablePKInc KeyInc StrategyDetails
issuesidupdatedAtmergeFetches all issues from your Linear workspace.
usersidupdatedAtmergeFetches users from your workspace.
workflow_statesidupdatedAtmergeFetches workflow states used in your Linear workspace.
cyclesidupdatedAtmergeFetches cycle information and planning data.
attachmentsidupdatedAtmergeFetches file attachments associated with issues.
commentsidupdatedAtmergeFetches comments on issues and other entities.
documentsidupdatedAtmergeFetches documents created in Linear.
external_usersidupdatedAtmergeFetches information about external users.
initiativeidupdatedAtmergeFetches initiative data for high-level planning.
integrationsidupdatedAtmergeFetches integration configurations.
labelsidupdatedAtmergeFetches labels used for categorizing issues.
project_updatesidupdatedAtmergeFetches updates posted to projects
team_membershipsidupdatedAtmergeFetches team membership information.
initiative_to_projectidupdatedAtmergeFetches relationships between initiatives and projects.
project_milestoneidupdatedAtmergeRetrieves Linear project milestones and checkpoints.
project_statusidupdatedAtmergeFetches project status information.
projectsidupdatedAtmergeFetches project-level data.
teamsidupdatedAtmergeFetches information about the teams configured in Linear.
organizationidupdatedAtmergeFetches organization-level information.

Use these as the --source-table parameter in the ingestr ingest command.