Skip to content

DocsIntegrations

Import and export

Import a Jira or Linear CSV or a Trello board, move a project between workspaces with a Praxis archive, and export a project as an archive or as JSON.

Move a project between workspaces

  1. 01Choose Export on the project card to download its Praxis archive (a ZIP file).
  2. 02In the destination organization, choose Import project, then Import from Praxis, and upload the archive.
  3. 03Review the preview. Choose the new name and key, then confirm.

An import always creates a new project. It never overwrites the source. Both import options are also in the setup wizard.

What a Praxis archive carries

Included
Tickets, comments and attachments. Updates, with their comments, captions, media and context links. Author names.
Not included
Credentials such as webhook secrets and tokens. Active agent claims. Account identities, follow preferences and notifications. Notes, which belong to the organization.
Archive size
Up to 25 MB as a ZIP, 100 MB expanded
Viewer exports
Published updates only

Review people and integrations after importing.

Import from Jira

  1. 01In Jira, export one project as CSV.
  2. 02In Praxis, choose Import project, then Import from Jira, and upload the file.
  3. 03Review the preview warnings and map assignees to people in Praxis.
  4. 04Confirm the import.
Required columns
Key (or Issue key), Summary, Issue Type, Status
Preserved
Jira ticket numbers and epic relationships
Kept in descriptions
Other exported fields
Not imported
Attachment files and Jira history

Import from Linear

  1. 01In Linear, export one project or team as CSV.
  2. 02In Praxis, choose Import project, then Import from Linear, and upload the file.
  3. 03Review the preview warnings, then confirm.
Required columns
ID (or Identifier), Title, Status
Becomes
Tasks, with priority, estimate, assignee and parent links where exported
Kept in descriptions
Labels, cycles and other exported fields

Import from Trello

  1. 01In Trello, open the board menu and export it as JSON, including cards and lists.
  2. 02In Praxis, choose Import project, then Import from Trello, and upload the file.
  3. 03Review the preview, then confirm.
Becomes
One ticket per card, with its checklists and comments
Statuses
Each list maps to a status; lists it doesn't recognise become To Do
Limit
Up to 5,000 cards per board

Export as JSON

Download one project as a single JSON file. It contains every ticket with its comments, attachment details and GitHub links, plus the dependency links between them.

Terminal
curl -sf -H "Authorization: Bearer $PRAXIS_KEY" \
  https://praxis.theorem-labs.com/api/projects/KEY/export -o KEY.json
  • Replace KEY with the project key. Use a personal key with access to that project.
  • It contains only what you can already read. A project you cannot see returns not found.
  • Webhook secrets and links to tickets in other projects are left out.
  • Each export is recorded in the audit log.