Skip to content

CLI reference — Forge Repos

Generated by bun run generate:cli-reference from spec/admin-api-openapi.json. Do not hand-edit — regenerate after refreshing the spec.

Every operation below is documented CLI-first (nayaone-admin api <operationId>) per PRD-407/DO-7. The REST /admin-api/* method+path is the fallback/alternative integration option.

9 operations in this area.

Same-origin proxy for adding/setting a Forge repo collaborator role (PUT /api/v1/repos/{owner}/{repo}/collaborators/{collaborator})

CLI (preferred):

Terminal window
nayaone-admin api adminAddForgeRepoCollaborator --param orgId=<orgId> --param owner=<owner> --param repo=<repo> --param collaborator=<collaborator> --body '{}'

REST fallback: PUT /admin-api/forge-repos/{orgId}/{owner}/{repo}/collaborators/{collaborator}

Same-origin proxy for creating a Forge repo branch (POST /api/v1/repos/{owner}/{repo}/branches)

CLI (preferred):

Terminal window
nayaone-admin api adminCreateForgeRepoBranch --param orgId=<orgId> --param owner=<owner> --param repo=<repo> --body '{}'

REST fallback: POST /admin-api/forge-repos/{orgId}/{owner}/{repo}/branches

Same-origin proxy for deleting a Forge repo branch (DELETE /api/v1/repos/{owner}/{repo}/branches/{branch})

CLI (preferred):

Terminal window
nayaone-admin api adminDeleteForgeRepoBranch --param orgId=<orgId> --param owner=<owner> --param repo=<repo> --param branch=<branch> --body '{}'

REST fallback: DELETE /admin-api/forge-repos/{orgId}/{owner}/{repo}/branches/{branch}

Same-origin proxy for one Forge repo CI run (GET /api/v1/repos/{owner}/{repo}/actions/runs/{run_id})

CLI (preferred):

Terminal window
nayaone-admin api adminGetForgeRepoActionRun --param orgId=<orgId> --param owner=<owner> --param repo=<repo> --param runId=<runId>

REST fallback: GET /admin-api/forge-repos/{orgId}/{owner}/{repo}/actions/runs/{runId}

Same-origin proxy for listing a Forge repo’s CI runs (GET /api/v1/repos/{owner}/{repo}/actions/runs)

CLI (preferred):

Terminal window
nayaone-admin api adminListForgeRepoActionRuns --param orgId=<orgId> --param owner=<owner> --param repo=<repo>

REST fallback: GET /admin-api/forge-repos/{orgId}/{owner}/{repo}/actions/runs

Same-origin proxy for listing a Forge repo’s CI action tasks (GET /api/v1/repos/{owner}/{repo}/actions/tasks)

CLI (preferred):

Terminal window
nayaone-admin api adminListForgeRepoActionTasks --param orgId=<orgId> --param owner=<owner> --param repo=<repo>

REST fallback: GET /admin-api/forge-repos/{orgId}/{owner}/{repo}/actions/tasks

Same-origin proxy for listing a Forge repo’s collaborators (GET /api/v1/repos/{owner}/{repo}/collaborators)

CLI (preferred):

Terminal window
nayaone-admin api adminListForgeRepoCollaborators --param orgId=<orgId> --param owner=<owner> --param repo=<repo>

REST fallback: GET /admin-api/forge-repos/{orgId}/{owner}/{repo}/collaborators

Same-origin proxy for removing a Forge repo collaborator (DELETE /api/v1/repos/{owner}/{repo}/collaborators/{collaborator})

CLI (preferred):

Terminal window
nayaone-admin api adminRemoveForgeRepoCollaborator --param orgId=<orgId> --param owner=<owner> --param repo=<repo> --param collaborator=<collaborator> --body '{}'

REST fallback: DELETE /admin-api/forge-repos/{orgId}/{owner}/{repo}/collaborators/{collaborator}

Same-origin proxy for toggling a Forge repo’s public/private visibility (PATCH /api/v1/repos/{owner}/{repo})

CLI (preferred):

Terminal window
nayaone-admin api adminSetForgeRepoVisibility --param orgId=<orgId> --param owner=<owner> --param repo=<repo> --body '{}'

REST fallback: PATCH /admin-api/forge-repos/{orgId}/{owner}/{repo}/visibility