Linear overview
The Linear connector brings Linear issues and project documents into Glean so users can search engineering work and project context without leaving Glean. The connector uses the Linear GraphQL API and preserves Linear team and document permissions at query time.
To connect Linear to Glean, see Setup.
Supported features
The connector is designed for searchable issue, comment, and project document content, together with the identity data needed to preserve access correctly in Glean.
Supported objects
| Object | Description |
|---|---|
| Issues | Linear issues used to track work and bugs |
| Issue comments | Comments attached to Linear issues |
| Project documents | Documents associated with Linear projects |
| Users | Identity data used for assignee, author, and permission mapping |
Supported API endpoints
The connector relies on the following Linear API capabilities:
- Issues queries: Crawl issue content and metadata.
- Comments queries: Retrieve comments associated with issues.
- Project documents queries: Retrieve project document content and metadata.
- Users and teams queries: Retrieve identity and team visibility data for permission enforcement.
Permissions
Glean preserves Linear permissions at query time:
- Content from public teams is generally visible according to the Linear workspace's access rules.
- Content from private teams is visible only to people who already have access in Linear.
- Project documents remain subject to their Linear visibility settings.
- Admin users do not automatically gain access to private-team content unless Linear itself grants it.
Crawling and freshness
| Crawl type | Full crawl | Incremental crawl | People data | Activity | Update rate | Notes |
|---|---|---|---|---|---|---|
| Issues and comments | Yes | Yes, filtered by updatedAt | Yes | No audit API | Daily by default | Captures issue and comment changes |
| Project documents | Yes | Limited | N/A | N/A | Daily | Some updates or deletions may require a full crawl |
Limitations
- Private-team content requires a paid Linear plan with the necessary access controls.
- Webhooks are not supported for this connector path.
- Linear does not expose an audit API for user views or edits in this integration.
- Freshness for project documents is more limited than for issues and comments.
- Multi-instance Linear deployments are not supported.