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 Import Wizard

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, then choose to import by team (all issues in a team) or by project (specific project issues). Select which teams/projects to import and map each to a corresponding Janet AI project.Note: Multiple Linear teams/projects can map to one Janet AI 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.