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.
Import Workflow
1
API Key Setup
Enter your Linear API key:
- Generate an API key from Linear Settings → Security & Access
- Paste the API key into Janet AI
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.