Integrations
GitHub integration
Connect GitHub for repository linking and development context.
GitHub integration is organization-scoped and consumed per project through linked repositories.
Connect at organization level
- Go to
/dashboard/organization/integrations. - Complete GitHub OAuth (
POST /integrationsflow with providergithub). - Verify connection —
POST /integrations/github/verify.
Link repositories to a project
- Open
/dashboard/projects/{projectId}/repositories. - Search available repos — backend uses the user's GitHub token via
/repositories/search. - Attach repos with
POST /projects/:projectId/repositories.
Repository detail features
From .../repositories/{repositoryId}:
| Capability | API suffix |
|---|---|
| Refresh metadata | /refresh |
| Commits | /commits |
| Contributors | /contributors |
| Pull requests | /pulls |
| Issues | /issues |
| Browse tree | /browse, /file |
These power developer intelligence answers in Ragnarock AI.
Security
- Request minimum OAuth scopes needed for read access.
- Revoke org integration when offboarding integrators.
- Self-hosted: store tokens encrypted; audit
IntegrationConnectionrows in Postgres.
Related
- Repositories feature
- Linear — often used together for delivery tracking