Documentation
Import projects
Import projects (/admin/import)
Central hub to bring external work into Orchestrator.
What it does
| Source | Path | Needs |
|---|---|---|
| GitHub | Import repos into Orchestrator software projects | GitHub App / OAuth connected under Integrations |
| Jira | Import Jira projects / issues | Jira OAuth or API token + base URL |
Route: /admin/import.
Operator flow
- Open Admin → Import.
- Check connection chips (GitHub / Jira).
- If disconnected, use Connect (opens config / OAuth), then return here.
- Choose Import from GitHub or Import from Jira and follow the dialog.
- After import, open the new project board under /projects/{CODE}/board.
Empty / error states
- No GitHub connection: CTA to GitHub integration setup (/admin/integrations/github).
- No Jira connection: configure base URL, email, and API token (or OAuth when enabled).
- Import failures show inline alerts. Check network + token scopes.
Related APIs
- GET /api/admin/import/github/repositories
- POST /api/admin/import/github
- GET /api/admin/import/jira/projects
- POST /api/admin/import/jira