BlueGit

timfa bluegit

Files

bluegit / internal / server / api_routes.go

api_routes.go

api_routes.go 25.8 KiB Download Raw
1package server
2
3import (
4 "net/http"
5
6 "gitlab.com/Timfa/bluegit/internal/access"
7)
8
9var apiCatalog = []apiRoute{
10 {http.MethodGet, "/api/v1/admin/pipelines/settings", access.ScopeAdmin, authUser, "Pipeline settings: stale_manual_days (instance admin)", (*Server).apiAdminPipelineSettings},
11 {http.MethodPut, "/api/v1/admin/pipelines/settings", access.ScopeAdmin, authUser, "Change stale_manual_days: manual jobs expire when their pipeline waited only for manual action this many days; 0 = off (instance admin)", (*Server).apiAdminPipelineSettings},
12 {http.MethodPost, "/api/v1/admin/pipelines/expire-stale", access.ScopeAdmin, authUser, "Expire stale manual jobs now (superseded and age rule) and list what expired (instance admin)", (*Server).apiAdminExpireStale},
13 {http.MethodGet, "/api/v1/admin/users", access.ScopeAdmin, authUser, "List users and their admin status (instance admin)", (*Server).apiAdminUsers},
14 {http.MethodPut, "/api/v1/admin/users/{username}/admin", access.ScopeAdmin, authUser, "Grant or revoke instance admin (instance admin; not yourself)", (*Server).apiAdminUserRole},
15 {http.MethodGet, "/api/v1/admin/runner/status", access.ScopeRunnerRead, authUser, "Built-in runner status (instance admin)", (*Server).apiAdminRunnerStatus},
16 {http.MethodGet, "/api/v1/admin/runner/settings", access.ScopeRunnerRead, authUser, "Get built-in runner settings (instance admin)", (*Server).apiAdminRunnerSettings},
17 {http.MethodPut, "/api/v1/admin/runner/settings", access.ScopeRunnerWrite, authUser, "Change built-in runner settings (instance admin)", (*Server).apiAdminRunnerSettings},
18 {http.MethodGet, "/api/v1/admin/runner/jobs", access.ScopeRunnerRead, authUser, "Active and recent jobs of the built-in runner (instance admin)", (*Server).apiAdminRunnerJobs},
19 {http.MethodPost, "/api/v1/admin/runner/pause", access.ScopeRunnerWrite, authUser, "Pause (drain) the built-in runner (instance admin)", (*Server).apiAdminRunnerPause},
20 {http.MethodPost, "/api/v1/admin/runner/resume", access.ScopeRunnerWrite, authUser, "Resume the built-in runner (instance admin)", (*Server).apiAdminRunnerResume},
21 {http.MethodGet, "/api/v1/admin/runners", access.ScopeRunnerRead, authUser, "List global runners (instance admin)", (*Server).apiRunners},
22 {http.MethodPost, "/api/v1/admin/runners/registration-token", access.ScopeRunnerWrite, authUser, "Create global runner registration token (instance admin)", (*Server).apiRunnerRegToken},
23 {http.MethodGet, "/api/v1/admin/runners/{id}", access.ScopeRunnerRead, authUser, "Get global runner", (*Server).apiRunnerGet},
24 {http.MethodPut, "/api/v1/admin/runners/{id}", access.ScopeRunnerWrite, authUser, "Rename or pause global runner", (*Server).apiRunnerPut},
25 {http.MethodPost, "/api/v1/admin/runners/{id}/pause", access.ScopeRunnerWrite, authUser, "Pause global runner", (*Server).apiRunnerPause},
26 {http.MethodPost, "/api/v1/admin/runners/{id}/resume", access.ScopeRunnerWrite, authUser, "Resume global runner", (*Server).apiRunnerResume},
27 {http.MethodDelete, "/api/v1/admin/runners/{id}", access.ScopeRunnerWrite, authUser, "Revoke global runner. 409 while it runs a doNotInterrupt job, unless force=true.", (*Server).apiRunnerDelete},
28 {http.MethodGet, "/api/v1/admin/runners/{id}/jobs", access.ScopeRunnerRead, authUser, "Recent jobs of global runner", (*Server).apiRunnerJobs},
29 {http.MethodGet, "/api/v1/user/runners", access.ScopeRunnerRead, authUser, "List account runners", (*Server).apiRunners},
30 {http.MethodPost, "/api/v1/user/runners/registration-token", access.ScopeRunnerWrite, authUser, "Create account runner registration token", (*Server).apiRunnerRegToken},
31 {http.MethodGet, "/api/v1/user/runners/{id}", access.ScopeRunnerRead, authUser, "Get account runner", (*Server).apiRunnerGet},
32 {http.MethodPut, "/api/v1/user/runners/{id}", access.ScopeRunnerWrite, authUser, "Rename or pause account runner", (*Server).apiRunnerPut},
33 {http.MethodPost, "/api/v1/user/runners/{id}/pause", access.ScopeRunnerWrite, authUser, "Pause account runner", (*Server).apiRunnerPause},
34 {http.MethodPost, "/api/v1/user/runners/{id}/resume", access.ScopeRunnerWrite, authUser, "Resume account runner", (*Server).apiRunnerResume},
35 {http.MethodDelete, "/api/v1/user/runners/{id}", access.ScopeRunnerWrite, authUser, "Revoke account runner", (*Server).apiRunnerDelete},
36 {http.MethodGet, "/api/v1/user/runners/{id}/jobs", access.ScopeRunnerRead, authUser, "Recent jobs of account runner", (*Server).apiRunnerJobs},
37 {http.MethodGet, "/api/v1/groups/{path}/runners", access.ScopeRunnerRead, authUser, "List group runners", (*Server).apiRunners},
38 {http.MethodPost, "/api/v1/groups/{path}/runners/registration-token", access.ScopeRunnerWrite, authUser, "Create group runner registration token", (*Server).apiRunnerRegToken},
39 {http.MethodGet, "/api/v1/groups/{path}/runners/{id}", access.ScopeRunnerRead, authUser, "Get group runner", (*Server).apiRunnerGet},
40 {http.MethodPut, "/api/v1/groups/{path}/runners/{id}", access.ScopeRunnerWrite, authUser, "Rename or pause group runner", (*Server).apiRunnerPut},
41 {http.MethodPost, "/api/v1/groups/{path}/runners/{id}/pause", access.ScopeRunnerWrite, authUser, "Pause group runner", (*Server).apiRunnerPause},
42 {http.MethodPost, "/api/v1/groups/{path}/runners/{id}/resume", access.ScopeRunnerWrite, authUser, "Resume group runner", (*Server).apiRunnerResume},
43 {http.MethodDelete, "/api/v1/groups/{path}/runners/{id}", access.ScopeRunnerWrite, authUser, "Revoke group runner", (*Server).apiRunnerDelete},
44 {http.MethodGet, "/api/v1/groups/{path}/runners/{id}/jobs", access.ScopeRunnerRead, authUser, "Recent jobs of group runner", (*Server).apiRunnerJobs},
45 {http.MethodGet, "/api/v1/user/runner-settings", access.ScopeRunnerRead, authUser, "Get runner preference", (*Server).apiUserRunnerSettings},
46 {http.MethodPut, "/api/v1/user/runner-settings", access.ScopeRunnerWrite, authUser, "Set runner preference", (*Server).apiUserRunnerSettings},
47 {http.MethodGet, "/api/v1/groups/{path}/runner-settings", access.ScopeRunnerRead, authUser, "Get group runner settings", (*Server).apiGroupRunnerSettings},
48 {http.MethodPut, "/api/v1/groups/{path}/runner-settings", access.ScopeRunnerWrite, authUser, "Set group runner settings", (*Server).apiGroupRunnerSettings},
49 {http.MethodGet, "/api/v1/groups/{path}/runner-optin", access.ScopeRunnerRead, authUser, "Get own runner opt-in for group", (*Server).apiGroupRunnerOptIn},
50 {http.MethodPut, "/api/v1/groups/{path}/runner-optin", access.ScopeRunnerWrite, authUser, "Set own runner opt-in for group", (*Server).apiGroupRunnerOptIn},
51
52 {http.MethodGet, "/api/v1/ci/spec", access.ScopePublic, authPublic, "CI specification", (*Server).ciSpec},
53 {http.MethodGet, "/api/v1/ci/presets", access.ScopePublic, authPublic, "CI image presets", (*Server).apiPresets},
54
55 {http.MethodGet, "/api/v1/user", access.ScopeRead, authUser, "Current user", (*Server).apiGetUser},
56 {http.MethodPut, "/api/v1/user", access.ScopeWrite, authUser, "Update profile", (*Server).apiPutUser},
57 {http.MethodGet, "/api/v1/user/export", access.ScopeRead, authUser, "Export account", (*Server).apiExport},
58 {http.MethodGet, "/api/v1/users/{username}", access.ScopeRead, authOptional, "User profile", (*Server).apiUserByName},
59 {http.MethodGet, "/api/v1/user/tokens", access.ScopeRead, authUser, "List access tokens", (*Server).apiListTokens},
60 {http.MethodPost, "/api/v1/user/tokens", access.ScopeWrite, authUser, "Create access token", (*Server).apiCreateToken},
61 {http.MethodDelete, "/api/v1/user/tokens/{id}", access.ScopeWrite, authUser, "Revoke access token", (*Server).apiDeleteToken},
62 {http.MethodGet, "/api/v1/user/keys", access.ScopeRead, authUser, "List SSH keys", (*Server).apiListKeys},
63 {http.MethodPost, "/api/v1/user/keys", access.ScopeWrite, authUser, "Add SSH key", (*Server).apiAddKey},
64 {http.MethodDelete, "/api/v1/user/keys/{id}", access.ScopeWrite, authUser, "Remove SSH key", (*Server).apiDeleteKey},
65
66 {http.MethodGet, "/api/v1/groups", access.ScopeRead, authUser, "List groups you are a member of. page and per_page paginate; sort=pushed orders by the most recent push, like the dashboard.", (*Server).apiListGroups},
67 {http.MethodPost, "/api/v1/groups", access.ScopeWrite, authUser, "Create group", (*Server).apiCreateGroup},
68 {http.MethodGet, "/api/v1/groups/{path}", access.ScopeRead, authUser, "Get group", (*Server).apiGetGroup},
69 {http.MethodPut, "/api/v1/groups/{path}", access.ScopeWrite, authUser, "Update group", (*Server).apiPutGroup},
70 {http.MethodDelete, "/api/v1/groups/{path}", access.ScopeWrite, authUser, "Delete an empty group. Body {\"confirm\": name or path}. 409 while the group still has repositories; no force. Members, invitations, group secrets, webhooks and approval rules are removed; group runners are revoked.", (*Server).apiDeleteGroup},
71 {http.MethodPost, "/api/v1/groups/{path}/transfer", access.ScopeWrite, authUser, "Transfer group owner", (*Server).apiTransferGroup},
72 {http.MethodGet, "/api/v1/groups/{path}/projects", access.ScopeRead, authUser, "List group projects", (*Server).apiGroupProjects},
73 {http.MethodGet, "/api/v1/groups/{path}/members", access.ScopeRead, authUser, "List group members", (*Server).apiGroupMembers},
74 {http.MethodPost, "/api/v1/groups/{path}/members", access.ScopeWrite, authUser, "Add group member", (*Server).apiGroupMembers},
75 {http.MethodDelete, "/api/v1/groups/{path}/members/{username}", access.ScopeWrite, authUser, "Remove group member", (*Server).apiDeleteGroupMember},
76 {http.MethodGet, "/api/v1/groups/{path}/secrets", access.ScopeRead, authUser, "List group secrets", (*Server).apiGroupSecrets},
77 {http.MethodPost, "/api/v1/groups/{path}/secrets", access.ScopeWrite, authUser, "Set group secret", (*Server).apiGroupSecrets},
78 {http.MethodDelete, "/api/v1/groups/{path}/secrets/{name}", access.ScopeWrite, authUser, "Delete group secret", (*Server).apiDeleteGroupSecret},
79 {http.MethodGet, "/api/v1/groups/{path}/webhooks", access.ScopeRead, authUser, "List group webhooks", (*Server).apiGroupHooks},
80 {http.MethodPost, "/api/v1/groups/{path}/webhooks", access.ScopeWrite, authUser, "Create group webhook", (*Server).apiGroupHooks},
81 {http.MethodDelete, "/api/v1/groups/{path}/webhooks/{id}", access.ScopeWrite, authUser, "Delete group webhook", (*Server).apiDeleteGroupHook},
82 {http.MethodPatch, "/api/v1/groups/{path}/webhooks/{id}", access.ScopeWrite, authUser, "Update group webhook. Omitted fields and an empty token keep the stored value.", (*Server).apiPatchGroupHook},
83 {http.MethodPost, "/api/v1/groups/{path}/webhooks/{id}/copy", access.ScopeWrite, authUser, "Copy group webhook to a project or group, secrets stay server-side", (*Server).apiCopyGroupHook},
84 {http.MethodGet, "/api/v1/groups/{path}/approvals", access.ScopeRead, authUser, "Get group approvals", (*Server).apiGroupApproval},
85 {http.MethodPut, "/api/v1/groups/{path}/approvals", access.ScopeWrite, authUser, "Save group approvals", (*Server).apiGroupApproval},
86 {http.MethodGet, "/api/v1/groups/{path}/logo", access.ScopeRead, authUser, "Group logo", (*Server).apiGroupLogo},
87 {http.MethodPost, "/api/v1/groups/{path}/logo", access.ScopeWrite, authUser, "Upload group logo", (*Server).apiGroupLogo},
88
89 {http.MethodGet, "/api/v1/projects", access.ScopeRead, authUser, "List projects you can access. page and per_page paginate; sort=pushed orders by the most recent push, like the dashboard.", (*Server).apiListProjects},
90 {http.MethodPost, "/api/v1/projects", access.ScopeWrite, authUser, "Create project", (*Server).apiCreateProject},
91 {http.MethodGet, "/api/v1/projects/{owner}/{repo}", access.ScopeRepoRead, authOptional, "Get project", (*Server).apiGetProject},
92 {http.MethodPut, "/api/v1/projects/{owner}/{repo}", access.ScopeWrite, authUser, "Update project", (*Server).apiPutProject},
93 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/fork", access.ScopeWrite, authUser, "Fork a project with all branches and tags. Body {namespace: group path or empty for your account, name: optional}. 409 if the name is taken. A fork of a private project is private.", (*Server).apiForkProject},
94 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/sync-upstream", access.ScopeWrite, authUser, "Fast-forward a branch of this fork to upstream. Body {branch: optional, default branch}. 409 when the fork has diverged (no force). Needs developer on the fork and read access to upstream.", (*Server).apiSyncUpstream},
95 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/upstream-merge-requests", access.ScopeWrite, authUser, "Open a merge request in the upstream of this fork. Body {source_branch (fork), target_branch (upstream, default its default branch), title, description, draft}. The source is mirrored to forks/<fork id>/<branch> in upstream; pipelines there never get upstream secrets. Needs read access to upstream and the role that may open merge requests there.", (*Server).apiForkMR},
96 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/forks", access.ScopeRead, authUser, "List forks of a project you can see.", (*Server).apiListForks},
97 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}", access.ScopeWrite, authUser, "Delete project. A running doNotInterrupt job makes this 409 unless the query has force=true.", (*Server).apiDeleteProject},
98 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/star", access.ScopeWrite, authUser, "Toggle star", (*Server).apiStar},
99 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/logo", access.ScopeRepoRead, authOptional, "Project logo", (*Server).apiProjectLogo},
100 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/logo", access.ScopeWrite, authUser, "Upload project logo", (*Server).apiProjectLogo},
101 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/members", access.ScopeRead, authUser, "List project members", (*Server).apiProjectMembers},
102 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/members", access.ScopeWrite, authUser, "Add project member", (*Server).apiProjectMembers},
103 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/members/{username}", access.ScopeWrite, authUser, "Remove project member", (*Server).apiDeleteProjectMember},
104 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/secrets", access.ScopeRead, authUser, "List project secrets", (*Server).apiProjectSecrets},
105 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/secrets/inherited", access.ScopeRead, authUser, "List group secrets this project inherits (names only). overridden is true when a project secret with the same name wins.", (*Server).apiProjectInheritedSecrets},
106 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/secrets", access.ScopeWrite, authUser, "Set project secret", (*Server).apiProjectSecrets},
107 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/secrets/{name}", access.ScopeWrite, authUser, "Delete project secret", (*Server).apiDeleteProjectSecret},
108 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/webhooks", access.ScopeRead, authUser, "List project webhooks", (*Server).apiProjectHooks},
109 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/webhooks", access.ScopeWrite, authUser, "Create project webhook", (*Server).apiProjectHooks},
110 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/webhooks/{id}", access.ScopeWrite, authUser, "Delete project webhook", (*Server).apiDeleteProjectHook},
111 {http.MethodPatch, "/api/v1/projects/{owner}/{repo}/webhooks/{id}", access.ScopeWrite, authUser, "Update project webhook. Omitted fields and an empty token keep the stored value.", (*Server).apiPatchProjectHook},
112 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/webhooks/{id}/copy", access.ScopeWrite, authUser, "Copy project webhook to a project or group, secrets stay server-side", (*Server).apiCopyProjectHook},
113 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/approvals", access.ScopeRead, authUser, "Get project approvals", (*Server).apiProjectApproval},
114 {http.MethodPut, "/api/v1/projects/{owner}/{repo}/approvals", access.ScopeWrite, authUser, "Save project approvals", (*Server).apiProjectApproval},
115 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/protected_branches", access.ScopeRead, authUser, "List protected branches", (*Server).apiProtectBranches},
116 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/protected_branches", access.ScopeWrite, authUser, "Protect branch pattern", (*Server).apiProtectBranches},
117 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/protected_branches/{pattern...}", access.ScopeWrite, authUser, "Unprotect branch pattern", (*Server).apiUnprotectBranch},
118 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/protected_tags", access.ScopeRead, authUser, "List protected tags", (*Server).apiProtectTags},
119 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/protected_tags", access.ScopeWrite, authUser, "Protect tag pattern", (*Server).apiProtectTags},
120 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/protected_tags/{pattern...}", access.ScopeWrite, authUser, "Unprotect tag pattern", (*Server).apiUnprotectTag},
121
122 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/branches", access.ScopeRepoRead, authOptional, "List branches", (*Server).apiBranches},
123 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/repository/branches", access.ScopeRepoWrite, authUser, "Create branch", (*Server).apiBranches},
124 {http.MethodPut, "/api/v1/projects/{owner}/{repo}/repository/branches/{branch...}", access.ScopeRepoWrite, authUser, "Rename branch", (*Server).apiBranch},
125 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/repository/branches/{branch...}", access.ScopeRepoWrite, authUser, "Delete branch", (*Server).apiBranch},
126 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/tags", access.ScopeRepoRead, authOptional, "List tags", (*Server).apiTags},
127 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/repository/tags", access.ScopeRepoWrite, authUser, "Create tag", (*Server).apiTags},
128 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/repository/tags/{tag}", access.ScopeRepoWrite, authUser, "Delete tag", (*Server).apiDeleteTag},
129 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/tags/{tag}/archive", access.ScopeRepoRead, authOptional, "Download tag archive", (*Server).apiTagArchive},
130 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/tree", access.ScopeRepoRead, authOptional, "List tree", (*Server).apiTree},
131 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/files/{path...}", access.ScopeRepoRead, authOptional, "Read file", (*Server).apiFile},
132 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/commits", access.ScopeRepoRead, authOptional, "List commits", (*Server).apiCommits},
133 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/repository/commits", access.ScopeRepoWrite, authUser, "Create commit", (*Server).apiCommits},
134 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/commits/{sha}", access.ScopeRepoRead, authOptional, "Get commit", (*Server).apiCommit},
135 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/repository/commits/{sha}/diff", access.ScopeRepoRead, authOptional, "Commit diff", (*Server).apiCommitDiff},
136
137 {http.MethodGet, "/api/v1/repos/{owner}/{repo}/issues", access.ScopeRead, authOptional, "List issues", (*Server).issuesAPI},
138 {http.MethodPost, "/api/v1/repos/{owner}/{repo}/issues", access.ScopeWrite, authUser, "Create issue", (*Server).issuesAPI},
139 {http.MethodGet, "/api/v1/repos/{owner}/{repo}/issues/{number}", access.ScopeRead, authOptional, "Get issue", (*Server).issueAPI},
140 {http.MethodPut, "/api/v1/repos/{owner}/{repo}/issues/{number}", access.ScopeWrite, authUser, "Update issue", (*Server).issueAPI},
141 {http.MethodDelete, "/api/v1/repos/{owner}/{repo}/issues/{number}", access.ScopeWrite, authUser, "Delete issue", (*Server).issueAPI},
142 {http.MethodPost, "/api/v1/repos/{owner}/{repo}/issues/{number}/notes", access.ScopeWrite, authUser, "Create issue note", (*Server).issueNoteAPI},
143
144 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/merge_requests", access.ScopeRead, authOptional, "List merge requests. Optional query: state (open, merged, closed, all), source_branch, target_branch.", (*Server).apiMRs},
145 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests", access.ScopeWrite, authUser, "Create merge request", (*Server).apiMRs},
146 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}", access.ScopeRead, authOptional, "Get merge request", (*Server).apiMR},
147 {http.MethodPut, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}", access.ScopeWrite, authUser, "Update merge request", (*Server).apiMR},
148 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/notes", access.ScopeRead, authOptional, "List notes", (*Server).apiMRNotes},
149 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/notes", access.ScopeWrite, authUser, "Create note", (*Server).apiMRNotes},
150 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/reviews", access.ScopeWrite, authUser, "Submit review", (*Server).apiReview},
151 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/reviews/dismiss", access.ScopeWrite, authUser, "Dismiss review", (*Server).apiDismissReview},
152 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/suggestions", access.ScopeRepoWrite, authUser, "Apply suggestions", (*Server).apiSuggestions},
153 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/merge", access.ScopeRepoWrite, authUser, "Merge merge request", (*Server).apiMerge},
154 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/close", access.ScopeWrite, authUser, "Close merge request", (*Server).apiCloseMR},
155 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/merge_requests/{number}/reopen", access.ScopeWrite, authUser, "Reopen merge request", (*Server).apiReopenMR},
156
157 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines", access.ScopeRead, authOptional, "List pipelines, newest first. Optional query: sha (7-40 hex, prefix), ref (branch, tag or full ref), mr (merge request number; its pipelines plus pushes to its source branch).", (*Server).apiPipelines},
158 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/pipelines", access.ScopeWrite, authUser, "Start pipeline", (*Server).apiPipelines},
159 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines/{id}", access.ScopeRead, authOptional, "Get pipeline", (*Server).apiPipeline},
160 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/cancel", access.ScopeWrite, authUser, "Cancel pipeline. A running doNotInterrupt job makes this 409 unless the query has force=true.", (*Server).apiCancelPipeline},
161 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/retry", access.ScopeWrite, authUser, "Retry pipeline", (*Server).apiRetryPipeline},
162 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs", access.ScopeRead, authOptional, "List jobs", (*Server).apiJobs},
163 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}", access.ScopeRead, authOptional, "Get job", (*Server).apiJob},
164 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}/log", access.ScopeRead, authOptional, "Job log", (*Server).apiJobLog},
165 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}/play", access.ScopeWrite, authUser, "Play manual job", (*Server).apiPlayJob},
166 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}/retry", access.ScopeWrite, authUser, "Retry job", (*Server).apiRetryJob},
167 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}/cancel", access.ScopeWrite, authUser, "Cancel job. A running doNotInterrupt job needs force=true in the query, otherwise 409.", (*Server).apiCancelJob},
168 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}/artifacts", access.ScopeRead, authOptional, "List artifacts", (*Server).apiArtifacts},
169 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/pipelines/{id}/jobs/{job}/artifacts/{path...}", access.ScopeRead, authOptional, "Download artifact", (*Server).apiArtifact},
170
171 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/ci/file", access.ScopeRepoRead, authOptional, "Read CI file", (*Server).apiCIFile},
172 {http.MethodPut, "/api/v1/projects/{owner}/{repo}/ci/file", access.ScopeRepoWrite, authUser, "Save CI file", (*Server).apiCIFile},
173 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/ci/lint", access.ScopeRead, authUser, "Lint CI file", (*Server).apiLintCI},
174 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/releases", access.ScopeRead, authOptional, "List releases", (*Server).apiReleases},
175 {http.MethodPost, "/api/v1/projects/{owner}/{repo}/releases", access.ScopeWrite, authUser, "Publish release", (*Server).createRelease},
176 {http.MethodGet, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeRead, authOptional, "Download release asset", (*Server).apiReleaseAsset},
177 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}", access.ScopeWrite, authUser, "Delete release (assets included). Query delete_tag=true also deletes the git tag.", (*Server).apiDeleteRelease},
178 {http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeWrite, authUser, "Delete one release asset (tag and source stay)", (*Server).apiDeleteReleaseAsset},
179 {http.MethodPost, "/api/v1/repos/{owner}/{repo}/releases", access.ScopeWrite, authRelease, "Publish release from a job or user token. A job token may send replace=true to replace its own release: running job of this project, pipeline on an unprotected branch (not forks/*), actor maintainer or higher, existing release made by a job on the same branch. Audited.", (*Server).createRelease},
180
181 {http.MethodGet, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Read instance storage", (*Server).apiAdminStorage},
182 {http.MethodPut, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Set instance storage", (*Server).apiAdminStorage},
183 {http.MethodPost, "/api/v1/admin/self-update/force", access.ScopeAdmin, authUser, "Install the pending self-update now, without waiting for running jobs", (*Server).apiForceUpdate},
184 {http.MethodGet, "/api/v1/admin/cache", access.ScopeAdmin, authUser, "Read cache settings and usage", (*Server).apiAdminCache},
185 {http.MethodPut, "/api/v1/admin/cache", access.ScopeAdmin, authUser, "Set cache path", (*Server).apiAdminCache},
186 {http.MethodPost, "/api/v1/admin/cache/clear", access.ScopeAdmin, authUser, "Clear the read cache", (*Server).apiAdminCacheClear},
187}