Projects API
Create and update projects, manage their repositories, clone to workers, handle discovered repositories and the GitHub App.
| Method and path | Purpose | Permission |
|---|---|---|
GET /orgs/:orgId/projects | List projects | member |
POST /orgs/:orgId/projects | Create a project | project.create |
GET /orgs/:orgId/projects/:projectId | Get a project | member |
PATCH /orgs/:orgId/projects/:projectId | Update (name, knowledge, policy…) | project.update |
DELETE /orgs/:orgId/projects/:projectId | Archive | project.delete |
POST /orgs/:orgId/projects/:id/repositories | Add a repository ({url}) or move one in ({fromProjectId, repositoryId}) | project.update |
PATCH …/repositories/:repositoryId | Rename, change branch, make primary | project.update |
POST …/repositories/:repositoryId/split | Move it into a project of its own | project.update |
POST …/repositories/:repositoryId/clone | Clone it to workers ({workerIds}) | project.update |
POST /orgs/:orgId/projects/:projectId/readiness | Run the AI readiness analysis on a worker that has the project | member |
GET /orgs/:orgId/discovered | Repositories found on workers that are in no project | member |
POST /orgs/:orgId/discovered/accept, …/dismiss | Accept or dismiss found repositories | member |
GitHub App
| Method and path | Purpose |
|---|---|
GET /orgs/:orgId/github | App, installations, your GitHub connection |
POST /orgs/:orgId/github/app/manifest | Start creating the app |
POST /orgs/:orgId/github/installations | Link to install the app on an account |
POST /orgs/:orgId/github/user | Link to authorize the app with your GitHub account |
POST /orgs/:orgId/github/sync | Sync now |
POST /orgs/:orgId/github/repositories | Create a GitHub repository and project |