Linear

Connect your Linear data to Airweave

Overview

The Linear connector allows you to sync data from Linear into Airweave, making it available for search and retrieval by your agents.

Configuration

LinearSource

Linear source implementation for syncing data from Linear into Airweave.

This source connects to Linear’s GraphQL API and extracts teams, projects, users, issues, and attachments with proper rate limiting and error handling.

View Source Code

Explore the Linear connector implementation

Authentication

This connector uses OAuth 2.0 authentication flow.

You can connect through the Airweave UI, which will guide you through the OAuth flow.

Entities

The following data models are available for this connector:

LinearIssueEntity

Schema for Linear issue entities.

This entity represents an issue from Linear, containing all relevant metadata and content from the Linear API.

Field	Type	Description
identifier	str	The unique identifier of the issue (e.g., ‘ENG-123’)
title	str	The title of the issue
description	Optional[str]	The description/content of the issue
priority	Optional[int]	The priority level of the issue
state	Optional[str]	The current state/status name of the issue
created_at	Optional[datetime]	When the issue was created
updated_at	Optional[datetime]	When the issue was last updated
completed_at	Optional[datetime]	When the issue was completed, if applicable
due_date	Optional[str]	The due date for the issue, if set
team_id	Optional[str]	ID of the team this issue belongs to
team_name	Optional[str]	Name of the team this issue belongs to
project_id	Optional[str]	ID of the project this issue belongs to, if any
project_name	Optional[str]	Name of the project this issue belongs to, if any
assignee	Optional[str]	Name of the user assigned to this issue, if any

LinearProjectEntity

Schema for Linear project entities.

This entity represents a project from Linear, containing all relevant metadata and content from the Linear API.

Field	Type	Description
name	str	The name of the project
slug_id	str	The project’s unique URL slug
description	Optional[str]	The project’s description
priority	Optional[int]	The priority level of the project
state	Optional[str]	The current state/status name of the project
created_at	Optional[datetime]	When the project was created
updated_at	Optional[datetime]	When the project was last updated
completed_at	Optional[datetime]	When the project was completed, if applicable
started_at	Optional[datetime]	When the project was started, if applicable
target_date	Optional[str]	The estimated completion date of the project
start_date	Optional[str]	The estimated start date of the project
team_ids	Optional[List[str]]	IDs of the teams this project belongs to
team_names	Optional[List[str]]	Names of the teams this project belongs to
progress	Optional[float]	The overall progress of the project
lead	Optional[str]	Name of the project lead, if any

LinearTeamEntity

Schema for Linear team entities.

This entity represents a team from Linear, containing all relevant metadata and content from the Linear API.

Field	Type	Description
name	str	The team’s name
key	str	The team’s unique key used in URLs
description	Optional[str]	The team’s description
color	Optional[str]	The team’s color
icon	Optional[str]	The icon of the team
private	Optional[bool]	Whether the team is private or not
timezone	Optional[str]	The timezone of the team
parent_id	Optional[str]	ID of the parent team, if this is a sub-team
parent_name	Optional[str]	Name of the parent team, if this is a sub-team
created_at	Optional[datetime]	When the team was created
updated_at	Optional[datetime]	When the team was last updated
member_count	Optional[int]	Number of members in the team

LinearUserEntity

Schema for Linear user entities.

This entity represents a user from Linear, containing all relevant metadata and content from the Linear API.

Field	Type	Description
name	str	The user’s full name
display_name	str	The user’s display name, unique within the organization
email	str	The user’s email address
avatar_url	Optional[str]	URL to the user’s avatar image
description	Optional[str]	A short description of the user
timezone	Optional[str]	The local timezone of the user
active	Optional[bool]	Whether the user account is active or disabled
admin	Optional[bool]	Whether the user is an organization administrator
guest	Optional[bool]	Whether the user is a guest with limited access
last_seen	Optional[datetime]	The last time the user was seen online
status_emoji	Optional[str]	The emoji to represent the user’s current status
status_label	Optional[str]	The label of the user’s current status
status_until_at	Optional[datetime]	Date at which the user’s status should be cleared
created_issue_count	Optional[int]	Number of issues created by the user
team_ids	Optional[List[str]]	IDs of the teams this user belongs to
team_names	Optional[List[str]]	Names of the teams this user belongs to
created_at	Optional[datetime]	When the user was created
updated_at	Optional[datetime]	When the user was last updated