Skip to main content

​
How It Works

Navigate to Integrations → Linear in your organization dashboard to access the import wizard. The wizard guides you through connecting your Linear workspace, mapping teams/projects and fields, then importing all your data.
Linear MigrationImport your teams and issues
Connect
Map Projects
Map Fields
Migrate
Connect to Linear
Generate an API key from Linear Settings → Security & Access, then paste it below.
API Token
lin_api_xxxxxxxxxxxxxxxxxx
Connect

​
Import Workflow

1

API Key Setup

Enter your Linear API key:Janet AI validates your credentials and connects to your Linear workspace
2

Team/Project Mapping

View all available Linear teams and their projects. Map each Linear Team to a Janet project — that’s the only mapping you need to make. Everything else is organized automatically:
LinearJanet
TeamProject
ProjectObjective
IssueTicket
Note: Multiple Linear teams can map to one Janet project.
3

Field Mapping

Map Linear fields to Janet AI fields:
  • Standard Fields: Map title, description, state, priority, assignee
  • Custom Fields: Map Linear custom fields to Janet AI custom fields
  • Priorities: Map Linear priorities (0-4 numeric scale) to Janet AI priorities
  • States: Map Linear states to Janet AI ticket statuses
4

Run Import

Review the import preview showing total issues to import, then start the batch import process. Monitor progress as tickets, attachments, and metadata transfer. When complete, view the results summary showing successes and any failures.