Description

Problem

Linear integration for teams who don't like Jira and do like Linear.

Use cases

Link user stories to Linear issues: Create rich product specifications in Fibery and link them directly to development tasks in Linear.
Track development progress: View status updates on Linear issues within your Fibery workspace.
Initial data import: If Linear is too opinionated for your taste, you can easily import your existing Linear data into the super flexible Fibery.

Solution

Make it possible to migrate from Linear or sync.

Configuration

Availability

Setup is available from the Integration section on the Space configuration page
Create Linear template
Register Linear Integration

Authentication

OAuth2.0 authentication

Database Setup

No restriction for database selection.

Optional Filters

Initiative (multi-select, the default value is empty, meaning all initiatives will be synced): only selected and related projects, project milestones, issues and cycles will be synced.
Archived/Trashed (checkbox, default is off): archived entities will also be synced (Archive == Trashed).
🦄 Date filtering

Database Structure

Project Database

Project Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Auto Archived At	Date & Time	Auto Archived At	The time at which the project was automatically archived by the auto pruning process.
Canceled At	Date & Time	Cancelled At	The time at which the project was moved into canceled state.
Color	Text	Color	The project's color.
Completed Issue Count History	Text	Completed Issue Count History	The number of completed issues in the project after each week.
Completed Scope History	Text	Completed Scope History	The number of completed estimation points after each week.
Completed At	Date & Time	Completed At	The time at which the project was moved into completed state.
Content (Description on UI)	Rich Text MD	Description	The project's content in markdown format.
Created At	Date & Time	Created At	The time at which the entity was created.
Description (Summary on UI)	Rich Texd MD	Summary	The project's description.
Icon	Text	Icon	The icon of the project.
In Progress Scope History	Text	In Progress Scope History	The number of in progress estimation points after each week.
Issue Count History	Text	Issue Count History	The total number of issues in the project after each week.
Name	Text Name	Name	The project's name.
Priority	Single-Select	Priority	The priority of the project. Values: [No priority, Urgent, High, Normal, Low.]
Progress	Number (Decimal)	Progress	The overall progress of the project. This is the (completed estimate points + 0.25 * in progress estimate points) / total estimate points.
Project Update Reminders Paused Until At	Date & Time	Update Reminders Paused Until	The time until which project update reminders are paused.
Scope	Number (Integer)	Scope	The overall scope (total estimate points) of the project.
Scope History	Text	Scope History	The total number of estimation points after each week.
Slack Issue Comments	Checkbox	Slack Issue Comments	Whether to send new issue comment notifications to Slack.
Slack Issue Statuses	Checkbox	Slack Issue Statuses	Whether to send new issue status updates to Slack.
Slack New Issue	Checkbox	Slack New Issue	Whether to send new issue notifications to Slack.
Slug Id	Text	Slug Id	The project's unique URL slug.
Sort Order	Number (Decimal)	Sort Order	The sort order for the project within the organization (ASC).
Start Date	Date	Start Date	The estimated start date of the project.
Target Date	Date	Target Date	The estimated completion date of the project.
Started At	Date & Time	Started At	The time at which the project was moved into started state.
Trashed	Checkbox	Trashed	A flag that indicates whether the project is in the trash bin.
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
URL	Url	Original URL	Project URL.
Status	Workflow	Status	The status that the project is associated with. Values: Dynamic
Health	Single-Select	Health	The health of the project based on the last project update. Values: [At Risk, Off Track, On Track]
Creator	Relation	User	The user who created the project.
Lead	Relation	User	The project lead.
Members	Relation	Users	Users that are members of the project.
	Relation	Initiatives	Initiatives which include this Project.
	Relation	Issues	Connected Issues to this Project.
	Relation	Milestones	Connected Milestones to this Project.
	Relation	Teams	Connected Teams to this Project.
	Relation	Documents	Attached document to this Project.

Unsupported fields:

None - we support all :all:

Team Database

Team Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Auto Archive Period	Number (Integer)	Auto Archive Period	Period after which automatically closed and completed issues are automatically archived in months.
Auto Close Period	Number (Integer)	Auto Close Period	Period after which issues are automatically closed in months. Null means disabled.
Color	Text	Color	Color of the team.
Created At	Date & Time	Created At	The time at which the entity was created.
Cycle Calender Url	URL	Cycle Calender Url	Calendar feed URL (iCal) for cycles.
Cycle Cooldown Time	Number (Integer)	Cycle Cooldown Time	The cooldown time after each cycle in weeks.
Cycle Duration	Number (Integer)	Cycle Duration	The duration of a cycle in weeks.
Cycle Issue Auto Assign Completed	Checkbox	Cycle Issue Auto Assign Completed	Auto assign completed issues to current cycle.
Cycle Issue Auto Assign Started	Checkbox	Cycle Issue Auto Assign Started	Auto assign started issues to current cycle.
Cycle Lock To Active	Checkbox	Active Issues Are Assigned To Cycle	Auto assign issues to current cycle if in active status.
Cycle Start Day	Single-Select	Cycle Start Day	The day of the week that a new cycle starts.
Cycles Enabled	Checkbox	Cycles Enabled	Whether the team uses cycles.
Default Issue Estimate	Number (Integer)	Default Issue Estimate	What to use as an default estimate for unestimated issues.
Description	Rich Text MD	Description	The team's description.
Group Issue History	Boolean	Group Issue History	Whether to group recent issue history entries.
Icon	Text	Icon	The icon of the team.
Issue Estimation Allow Zero	Checkbox	Issue Estimation Allow Zero	Whether to allow zeros in issues estimates.
Issue Estimation Extended	Checkbox	Issue Estimation Extended	Whether to add additional points to the estimate scale.
Issue Estimation Type	Single-Select	Issue Estimation Type	The issue estimation type to use. Values: ["Not Used", "Exponential", "Fibonacci", "Linear", "TShirt"]
Issue Ordering No Priority First	Checkbox	Issue Ordering No Priority First	Whether issues without priority should be sorted first.
Key	Text	Key	The team's unique key. The key is used in URLs.
Name	Name	Name	Team's name.
Private	Checkbox	Private	Whether the team is private or not.
Require Priority To Leave Triage	Checkbox	Require Priority To Leave Triage	Whether an issue needs to have a priority set before leaving triage.
SCIM Group Name	Text	SCIM Group Name	The SCIM group name for the team.
SCIM Managed	Checkbox	SCIM Managed	Whether the team is managed by SCIM integration.
Set Issue Sort Order On State Change	Text	Set Issue Sort Order On State Change	Where to move issues when changing state.
Slack Issue Comments	Checkbox	Slack Issue Comments	Whether to send new issue comment notifications to Slack.
Slack Issue Statuses	Checkbox	Slack Issue Statuses	Whether to send new issue status updates to Slack.
Slack New Issue	Checkbox	Slack New Issue	Whether to send new issue notifications to Slack.
Timezone	Text	Timezone	The timezone of the team. Defaults to "America/Los_Angeles"
Triage Enabled	Checkbox	Triage Enabled	Whether triage mode is enabled for the team or not.
Upcoming Cycle Count	Number (Integer)	Upcoming Cycle Count	How many upcoming cycles to create.
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
Cycles	Relation	Cycles	Cycles associated with the team.
Issues	Relation	Issues	Issues associated with the team.
Members	Relation	Users	Users who are members of this team.
Projects	Relation	Projects	Projects associated with the team.

Unsupported fields:

templates
webhooks
active cycle

Milestone Database

Milestone Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Created At	Date & Time	Created At	The time at which the entity was created.
Description	Rich Text MD	Description	The milestone's description in MD format.
Name	Name	Name	Milestone's name.
Sort Order	Number (Decimal)	Sort Order	The order of the milestone in relation to other milestones within a project.
Target Date	Date	Target Date	The estimated completion date of the milestone.
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
	Relation	Project	The project of the milestone.
	Relation	Issues	Issues associated with the project milestone.

Unsupported fields:

None - we support all :all:

Cycle Database

Cycle Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Auto Archived At	Date & Time	Auto Archived At	The time at which the cycle was automatically archived by the auto pruning process.
Completed At	Date & Time	Completed At	The completion time of the cycle. If null, the cycle hasn't been completed.
Completed Issue Count History	Text	Completed Issue Count History	The number of completed issues in the cycle after each day (as list of numbers).
Completed Scope History	Text	Completed Scope History	The number of completed estimation points after each day (as list of numbers).
Created At	Date & Time	Created At	The time at which the entity was created.
Description	Rich Text MD	Description	The cycle's description in MD format.
Starts At + Ends At	Date & Time Range	Cycle Date Range	The range of start and end time of the cycle.
Name + Number	Name	Name	Cycle's name and its number combined (to replicate Linear's UI).
In Progress Scope History	Text	In Progress Scope History	The number of in progress estimation points after each day (as list of numbers).
Issue Count History	Text	Issue Count History	The total number of issues in the cycle after each day (as list of numbers).
Progress	Number (Decimal)	Progress	The overall progress of the cycle. This is the (completed estimate points + 0.25 * in progress estimate points) / total estimate points.
Scope History	Text	Scope History	The total number of estimation points after each day (as list of numbers).
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
	Relation	Team	The team that the cycle is associated with.
	Relation	Issues	Issues associated with the cycle.
	Relation	Uncompleted Issues Upon Close	Issues that weren't completed when the cycle was closed.

Unsupported fields:

None - we support all :all:

Initiative Database

Initiative Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Color	Text	Color	The initiative's color in HEX.
Created At	Date & Time	Created At	The time at which the entity was created.
Summary + External Links	Rich Text MD	Summary	The initiative's description in MD format AND external links.
Icon	Text	Icon	The text of icon of the initiative.
Name	Name	Name	Initiative's name.
Slug Id	Text	Slug Id	The initiative's unique URL slug.
Sort Order	Number (Decimal)	Sort Order	The sort order of the initiative within the organization.
Target Date	Date	Target Date	The estimated completion date of the initiative.
Target Date Resolution	Single-Select	Target Date Resolution	The resolution of the initiative's estimated completion date. Values: [Half Year, Month, Quarter, Year]
Trashed	Checkbox	Trashed	A flag that indicates whether the initiative is in the trash bin.
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
Status	Single-Select	Status	Initiative's status. Values: [Planned, Active, Completed].
Creator	Relation	User	The user who created the Initiative.
	Relation	Owner	The owner of the Initiative.
	Relation	Projects	Projects associated with the Initiative.
	Relation	Document	Documents associated with the Initiative.

Unsupported fields:

Description - inaccessible via API 🤷‍♂️

User Database

User Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Active	Checkbox	Active	Whether the user account is active or disabled (suspended).
Admin	Checkbox	Admin	Whether the user is an organization administrator.
Avatar	Avatar	Avatar	User's avatar image.
Created At	Date & Time	Created At	The time at which the entity was created.
Created Issues Count	Number (Integer)	Created Issues Count	Number of issues created.
Description	Rich Text MD	Description	The user's description in MD format.
Disable Reason	Text	Disable Reason	Reason why is the account disabled.
Display Name	Text	Display Name	The user's display (nick) name. Unique within each organization.
Email	Email	Email	The user's email address.
Guest	Checkbox	Guest	Whether the user is a guest in the workspace and limited to accessing a subset of teams.
Initials	Text	Initials	The initials of the user.
invite hash	Text	Invite Hash	Unique hash for the user to be used in invite URLs.
Last Seen	Date & Time	Last Seen	The last time the user was seen online. If null, the user is currently online.
Name	Name	Name	The user's full name.
Status Emoji	Text	Status Emoji	Emoji of a status (as text).
Status Label	Text	Status Label	The label of the user current status.
Timezone	Text	Timezone	The local timezone of the user.
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
URL	URL	Original URL	User's profile URL.
	Relation	Assigned Issues	Issues assigned to the user.
	Relation	Created Issues	Issues created by the user.
	Relation	Teams	Teams the user is part of.

Unsupported fields:

None - we support all :all:

Issue Database

Issue Database
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Auto Archived At	Date & Time	Auto Archived At	The time at which the issue was automatically archived by the auto pruning process.
Auto Closed At	Date & Time	Auto Closed At	The time at which the issue was automatically closed by the auto pruning process.
Board Order	Number (Decimal)	Board Order	The order of the item in its column on the board.
Branch Name	Text	Suggested Branch Name	Suggested branch name for the issue.
Cancelled At	Date & Time	Cancelled At	The time at which the issue was moved into canceled state.
Completed At	Date & Time	Completed At	The time at which the issue was moved into completed state.
Created At	Date & Time	Created At	The time at which the entity was created.
Customer Ticket Count	Number (Integer)	Customer Ticket Count	Returns the number of Attachment resources which are created by customer support ticketing systems (e.g. Zendesk).
State	Workflow	State	The workflow state that the issue is associated with. In Fibery, it will be all states created by all teams combined (including Triage).
Description + Attachments	Rich Text MD	Description	The issue's description in MD format (includes any attachments for the issue as they are just files in the document).
Due Date	Date	Due Date	The date at which the issue is due.
Estimate	Number (Integer)	Estimate	The estimate of the complexity of the issue..
Identifier	Text	Identifier	Issue's human readable identifier (e.g. ENG-123).
Number	Number (Integer)	Number	The issue's unique number.
Pevious Identifiers	Text	Previous Identifiers	Previous identifiers of the issue if it has been moved between teams.
Priority	Single-Select	Priority	The priority of the issue. Values: [No priority, Urgent, High, Normal, Low]
SLA Breaches At	Date & Time	SLA Breaches	The time at which the issue's SLA will breach.
SLA Started At	Date & Time	SLA Started	The time at which the issue's SLA began.
Snoozed Until At	Date & Time	Snoozed Until	The time until an issue will be snoozed in Triage view.
Sort Order	Number (Decimal)	Sort Order	The order of the item in relation to other items in the organization (sort asc).
Sub Issue Sort Order	Number (Decimal)	Sub Issue Sort Order	The order of the item in the sub-issue list. Only set if the issue has a parent.
Started At	Date & Time	Started At	The time at which the issue was moved into started state.
Started Triage At	Date & Time	Started Triage At	The time at which the issue entered triage.
title	Name	Name	The issue's name.
Trashed	Checkbox	Trashed	A flag that indicates whether the issue is in the trash bin.
Triaged At	Date & Time	Left Triage At	The time at which the issue left triage.
Updated At	Date & Time	Updated At	The last time at which the entity was meaningfully updated.
URL	URL	Original URL	Issue's URL.
Labels	Multi-select	Labels	Labels associated with this issue.
Reactions	Text	Reactions	Reactions associated with the issue (as list of their names).
Assignee	Relation	User	The user to whom the issue is assigned to.
Creator	Relation	User	The user who created the issue.
Bot Actor	Text	Bot Creator	A bot actor is an actor that is not a user, but an application or integration.
	Relation	Cycle	The cycle that the issue is associated with.
	Relation	Issue	Parent issue
	Relation	Project	The project that the issue is associated with.
	Relation	Milestone	The Milestone that the issue is associated with.
Snoozed By	Relation	User	The user who snoozed the issue.
	Relation	Team	The team that the issue is associated with.
Subscribers	Relation	Users	Users who are subscribed to the issue.

Unsupported fields:

comments
lastAppliedTemplate
external Creator (admin-level access required)

Document Database

Document Database	Attachments for Projects and Initiatives
Linear Field	Type	Fibery Field	Description
Archived At	Date & Time	Archived At	The time at which the entity was archived. Null if the entity has not been archived.
Color	Text	Color	The color of the icon.
Content	Rich Text MD	Description	The documents content in markdown format.
Created At	Date & Time	Created At	The time at which the entity was created.
Hidden At	Date & Time	Hidden At	The time at which the document was hidden. Null if the entity has not been hidden.
Icon	Text	Icon	The icon of the document.
Slug Id	Text	Slug Id	The document's unique URL slug.
Sort Order	Number (Decimal)	Sort Order	The order of the item in the resources list (ASC).
title	Name	Name	The document title.
Trashed	Checkbox	Trashed	A flag that indicates whether the document is in the trash bin.
Updated At	Date & Time		The last time at which the entity was meaningfully updated.
URL	URL	Original URL	The canonical url for the document.
	Relation	Created By	The user who created the document.
	Relation	Updated By	The user who last updated the document.
	Relation	Project	The project that the document is associated with.
	Relation	Initiative	The initiative that the document is associated with.

Unsupported fields:

comments