diff --git a/templates/swagger/v1_groups.json b/templates/swagger/v1_groups.json index c830fd6661..5bf56d2120 100644 --- a/templates/swagger/v1_groups.json +++ b/templates/swagger/v1_groups.json @@ -1,9 +1,140 @@ { "paths": { - "/repos/{owner}/group/{group_id}/{repo}/milestones": { + "/repos/{owner}/group/{group_id}/{repo}/topics": { "get": { - "summary": "Get all of a repository's opened milestones", - "operationId": "issueGetMilestonesList", + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get list of topics that a repository has", + "operationId": "repoListTopics", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "description": "page size of results", + "name": "limit", + "in": "query", + "type": "integer" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/TopicNames" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "put": { + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/invalidTopicsError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Replace list of topics for a repository", + "operationId": "repoUpdateTopics", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/RepoTopicOptions" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/page/{pageName}": { + "patch": { + "responses": { + "200": { + "$ref": "#/responses/WikiPage" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Edit a wiki page", + "operationId": "repoEditWikiPage", "parameters": [ { "required": true, @@ -20,16 +151,2729 @@ "required": true }, { + "in": "path", + "required": true, + "type": "string", + "description": "name of the page", + "name": "pageName" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateWikiPageOptions" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + }, + "get": { + "tags": [ + "repository" + ], + "summary": "Get a wiki page", + "operationId": "repoGetWikiPage", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "string", + "description": "name of the page", + "name": "pageName", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WikiPage" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "summary": "Delete a wiki page", + "operationId": "repoDeleteWikiPage", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the page", + "name": "pageName", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/commits/{sha}.{diffType}": { + "get": { + "produces": [ + "text/plain" + ], + "tags": [ + "repository" + ], + "summary": "Get a commit's diff or patch", + "operationId": "repoDownloadCommitDiffOrPatch", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "SHA of the commit to get", + "name": "sha", + "in": "path", + "required": true + }, + { + "name": "diffType", + "in": "path", + "required": true, + "enum": [ + "diff", + "patch" + ], + "type": "string", + "description": "whether the output is diff or patch" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/string" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/licenses": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/LicensesList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get repo licenses", + "operationId": "repoGetLicenses", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/teams/{team}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Check if a team is assigned to a repository", + "operationId": "repoCheckTeam", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "team name", + "name": "team" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/Team" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "405": { + "$ref": "#/responses/error" + } + } + }, + "put": { + "summary": "Add a team to a repository", + "operationId": "repoAddTeam", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "team name", + "name": "team", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "405": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a team from a repository", + "operationId": "repoDeleteTeam", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "team name", + "name": "team" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "405": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/dispatches": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a workflow dispatch event", + "operationId": "ActionsDispatchWorkflow", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "string", + "description": "id of the workflow", + "name": "workflow_id", + "in": "path", + "required": true + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/CreateActionWorkflowDispatch" + }, + "name": "body" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "description": "No Content" + }, + "400": { + "$ref": "#/responses/error" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/assets": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List comment's attachments", + "operationId": "issueListIssueCommentAttachments", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the comment", + "name": "id", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/AttachmentList" + }, + "404": { + "$ref": "#/responses/error" + } + } + }, + "post": { + "consumes": [ + "multipart/form-data" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create a comment attachment", + "operationId": "issueCreateIssueCommentAttachment", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the comment", + "name": "id", + "in": "path", + "required": true + }, + { + "description": "name of the attachment", + "name": "name", + "in": "query", + "type": "string" + }, + { + "name": "attachment", + "in": "formData", + "required": true, + "type": "file", + "description": "attachment to upload" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/error" + }, + "413": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Attachment" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/contents/{filepath}": { + "post": { + "responses": { + "201": { + "$ref": "#/responses/FileResponse" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a file in a repository", + "operationId": "repoCreateFile", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "path of the file to create", + "name": "filepath" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/CreateFileOptions" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a file in a repository", + "operationId": "repoDeleteFile", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "path of the file to delete", + "name": "filepath", + "in": "path", + "required": true + }, + { + "required": true, + "schema": { + "$ref": "#/definitions/DeleteFileOptions" + }, + "name": "body", + "in": "body" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "200": { + "$ref": "#/responses/FileDeleteResponse" + } + }, + "consumes": [ + "application/json" + ] + }, + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir.", + "operationId": "repoGetContents", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "path of the dir, file, symlink or submodule in the repo", + "name": "filepath", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", + "name": "ref", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ContentsResponse" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "description": "This API follows GitHub's design, and it is not easy to use. Recommend users to use the \"contents-ext\" API instead." + }, + "put": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Update a file in a repository if SHA is set, or create the file if SHA is not set", + "operationId": "repoUpdateFile", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "path of the file to update", + "name": "filepath", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/UpdateFileOptions" + } + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/FileResponse" + }, + "201": { + "$ref": "#/responses/FileResponse" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/variables": { + "get": { + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/VariableList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get repo-level variables list", + "operationId": "getRepoVariablesList", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query", + "type": "integer" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/comments/{id}": { + "delete": { + "tags": [ + "issue" + ], + "summary": "Delete a comment", + "operationId": "issueDeleteCommentDeprecated", + "deprecated": true, + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "description": "this parameter is ignored", + "name": "index" + }, + { + "format": "int64", + "description": "id of comment to delete", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "patch": { + "responses": { + "200": { + "$ref": "#/responses/Comment" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "summary": "Edit a comment", + "tags": [ + "issue" + ], + "operationId": "issueEditCommentDeprecated", + "deprecated": true, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "description": "this parameter is ignored", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the comment to edit", + "name": "id", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditIssueCommentOption" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/dismissals": { + "post": { + "tags": [ + "repository" + ], + "summary": "Dismiss a review for a pull request", + "operationId": "repoDismissPullReview", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the review", + "name": "id" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/DismissPullReviewOptions" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/PullReview" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues": { + "get": { + "tags": [ + "issue" + ], + "summary": "List a repository's issues", + "operationId": "issueListIssues", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "enum": [ + "closed", + "open", + "all" + ], + "type": "string", + "description": "whether issue is open or closed", "name": "state", + "in": "query" + }, + { "in": "query", "type": "string", - "description": "Milestone state, Recognized values are open, closed and all. Defaults to \"open\"" + "description": "comma separated list of label names. Fetch only issues that have any of this label names. Non existent labels are discarded.", + "name": "labels" + }, + { + "type": "string", + "description": "search string", + "name": "q", + "in": "query" + }, + { + "enum": [ + "issues", + "pulls" + ], + "type": "string", + "description": "filter by type (issues / pulls) if set", + "name": "type", + "in": "query" + }, + { + "name": "milestones", + "in": "query", + "type": "string", + "description": "comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded" + }, + { + "type": "string", + "format": "date-time", + "description": "Only show items updated after the given time. This is a timestamp in RFC 3339 format", + "name": "since", + "in": "query" + }, + { + "format": "date-time", + "description": "Only show items updated before the given time. This is a timestamp in RFC 3339 format", + "name": "before", + "in": "query", + "type": "string" + }, + { + "name": "created_by", + "in": "query", + "type": "string", + "description": "Only show items which were created by the given user" + }, + { + "type": "string", + "description": "Only show items for which the given user is assigned", + "name": "assigned_by", + "in": "query" + }, + { + "type": "string", + "description": "Only show items in which the given user was mentioned", + "name": "mentioned_by", + "in": "query" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/IssueList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create an issue. If using deadline only the date will be taken into account, and time of day ignored.", + "operationId": "issueCreateIssue", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateIssueOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Issue" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "412": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/reactions": { + "get": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a list reactions of an issue", + "operationId": "issueGetIssueReactions", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ReactionList" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "summary": "Add a reaction to an issue", + "operationId": "issuePostIssueReaction", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "name": "content", + "in": "body", + "schema": { + "$ref": "#/definitions/EditReactionOption" + } + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Reaction" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/Reaction" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Remove a reaction from an issue", + "operationId": "issueDeleteIssueReaction", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index" + }, + { + "name": "content", + "in": "body", + "schema": { + "$ref": "#/definitions/EditReactionOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/reviewers": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/UserList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Return all users that can be requested to review in this repo", + "operationId": "repoGetReviewers", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the release" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/AttachmentList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List release's attachments", + "operationId": "repoListReleaseAttachments" + }, + "post": { + "consumes": [ + "multipart/form-data", + "application/octet-stream" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a release attachment", + "operationId": "repoCreateReleaseAttachment", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the release", + "name": "id" }, { "name": "name", "in": "query", "type": "string", - "description": "filter by milestone name" + "description": "name of the attachment" + }, + { + "type": "file", + "description": "attachment to upload", + "name": "attachment", + "in": "formData" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "413": { + "$ref": "#/responses/error" + }, + "201": { + "$ref": "#/responses/Attachment" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/latest": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at", + "operationId": "repoGetLatestRelease", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/enable": { + "put": { + "responses": { + "409": { + "$ref": "#/responses/conflict" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "description": "No Content" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Enable a workflow", + "operationId": "ActionsEnableWorkflow", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "string", + "description": "id of the workflow", + "name": "workflow_id", + "in": "path", + "required": true + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/contents": { + "post": { + "summary": "Modify multiple files in a repository", + "operationId": "repoChangeFiles", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/ChangeFilesOptions" + } + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "201": { + "$ref": "#/responses/FilesResponse" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "get": { + "responses": { + "200": { + "$ref": "#/responses/ContentsListResponse" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "description": "This API follows GitHub's design, and it is not easy to use. Recommend users to use our \"contents-ext\" API instead.", + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets the metadata of all the entries of the root dir.", + "operationId": "repoGetContentsList", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "query", + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", + "name": "ref" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/{id}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a release", + "operationId": "repoGetRelease", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "format": "int64", + "description": "id of the release to get", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "summary": "Delete a release", + "operationId": "repoDeleteRelease", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the release to delete", + "name": "id", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "tags": [ + "repository" + ] + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Update a release", + "operationId": "repoEditRelease", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the release to edit", + "name": "id", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditReleaseOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/commits/{ref}/status": { + "get": { + "operationId": "repoGetCombinedStatusByRef", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of branch/tag/commit", + "name": "ref", + "in": "path", + "required": true + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/CombinedStatus" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a commit's combined status, by branch/tag/commit reference" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/teams": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's teams", + "operationId": "repoListTeams", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TeamList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/merge-upstream": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Merge a branch from upstream", + "operationId": "repoMergeUpstream", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/MergeUpstreamRequest" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/MergeUpstreamResponse" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a workflow", + "operationId": "ActionsGetWorkflow", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "name": "workflow_id", + "in": "path", + "required": true, + "type": "string", + "description": "id of the workflow" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ActionWorkflow" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "500": { + "$ref": "#/responses/error" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/times/{user}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a user's tracked times in a repo", + "operationId": "userTrackedTimes", + "deprecated": true, + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "username of the user whose tracked times are to be listed", + "name": "user", + "in": "path" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TrackedTimeList" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/labels/{id}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/Label" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a single label", + "operationId": "issueGetLabel", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "format": "int64", + "description": "id of the label to get", + "name": "id", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + }, + "delete": { + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "issue" + ], + "summary": "Delete a label", + "operationId": "issueDeleteLabel", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the label to delete", + "name": "id" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + }, + "patch": { + "operationId": "issueEditLabel", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "format": "int64", + "description": "id of the label to edit", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/EditLabelOption" + }, + "name": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/Label" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Update a label" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/pin/{position}": { + "patch": { + "operationId": "moveIssuePin", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "format": "int64", + "description": "index of issue", + "name": "index", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "the new position", + "name": "position" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "tags": [ + "issue" + ], + "summary": "Moves the Pin to the given Position" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/jobs/{job_id}/logs": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Downloads the job logs for a workflow run", + "operationId": "downloadActionsRunJobLogs", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repository" + }, + { + "type": "integer", + "description": "id of the job", + "name": "job_id", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "description": "output blob content" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/jobs": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Lists all jobs for a repository", + "operationId": "listWorkflowJobs", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", + "name": "status", + "in": "query", + "type": "string" + }, + { + "name": "page", + "in": "query", + "type": "integer", + "description": "page number of results to return (1-based)" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/WorkflowJobsList" + }, + "400": { + "$ref": "#/responses/error" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/labels": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get all of a repository's labels", + "operationId": "issueListLabels", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true }, { "type": "integer", @@ -54,82 +2898,16 @@ ], "responses": { "200": { - "$ref": "#/responses/MilestoneList" + "$ref": "#/responses/LabelList" }, "404": { "$ref": "#/responses/notFound" } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] + } }, "post": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Create a milestone", - "operationId": "issueCreateMilestone", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateMilestoneOption" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "201": { - "$ref": "#/responses/Milestone" - } - }, - "consumes": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets/{attachment_id}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a release attachment", - "operationId": "repoGetReleaseAttachment", + "summary": "Create a label", + "operationId": "issueCreateLabel", "parameters": [ { "type": "string", @@ -146,20 +2924,139 @@ "type": "string" }, { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateLabelOption" + } + }, + { + "name": "group_id", "type": "integer", "format": "int64", - "description": "id of the release", - "name": "id", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Label" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branches/{branch}": { + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a specific branch from a repository", + "operationId": "repoDeleteBranch", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", "in": "path", "required": true }, + { + "in": "path", + "required": true, + "type": "string", + "description": "branch to delete", + "name": "branch" + }, { "type": "integer", "format": "int64", - "description": "id of the attachment to get", - "name": "attachment_id", + "required": true, "in": "path", - "required": true + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Rename a branch", + "operationId": "repoRenameBranch", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "branch", + "in": "path", + "required": true, + "type": "string", + "description": "name of the branch" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/RenameBranchRepoOption" + }, + "name": "body" }, { "required": true, @@ -170,17 +3067,404 @@ "format": "int64" } ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + }, + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Retrieve a specific branch from a repository, including its effective branch protection", + "operationId": "repoGetBranch", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "branch", + "in": "path", + "required": true, + "type": "string", + "description": "branch to get" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], "responses": { "200": { - "$ref": "#/responses/Attachment" + "$ref": "#/responses/Branch" }, "404": { "$ref": "#/responses/notFound" } } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/notes/{sha}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a note corresponding to a single commit from a repository", + "operationId": "repoGetNote", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "a git ref or commit sha", + "name": "sha", + "in": "path", + "required": true + }, + { + "type": "boolean", + "description": "include verification for every commit (disable for speedup, default 'true')", + "name": "verification", + "in": "query" + }, + { + "type": "boolean", + "description": "include a list of affected files for every commit (disable for speedup, default 'true')", + "name": "files", + "in": "query" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Note" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/lock": { + "put": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/LockIssueOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Lock an issue", + "operationId": "issueLockIssue" }, "delete": { - "operationId": "repoDeleteReleaseAttachment", + "summary": "Unlock an issue", + "operationId": "issueUnlockIssue", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/undismissals": { + "post": { + "tags": [ + "repository" + ], + "summary": "Cancel to dismiss a review for a pull request", + "operationId": "repoUnDismissPullReview", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the review" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullReview" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/commits": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get commits for a pull request", + "operationId": "repoGetPullRequestCommits", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request to get", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "description": "page size of results", + "name": "limit", + "in": "query", + "type": "integer" + }, + { + "description": "include verification for every commit (disable for speedup, default 'true')", + "name": "verification", + "in": "query", + "type": "boolean" + }, + { + "type": "boolean", + "description": "include a list of affected files for every commit (disable for speedup, default 'true')", + "name": "files", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/CommitList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/assets/{attachment_id}": { + "get": { + "summary": "Get an issue attachment", + "operationId": "issueGetIssueAttachment", "parameters": [ { "type": "string", @@ -197,20 +3481,2172 @@ "name": "repo" }, { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "attachment_id", "in": "path", "required": true, "type": "integer", "format": "int64", - "description": "id of the release", - "name": "id" + "description": "id of the attachment to get" }, { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Delete an issue attachment", + "operationId": "issueDeleteIssueAttachment", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "name": "index", + "in": "path", + "required": true, "type": "integer", + "format": "int64", + "description": "index of the issue" + }, + { "format": "int64", "description": "id of the attachment to delete", "name": "attachment_id", "in": "path", + "required": true, + "type": "integer" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", "required": true + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + }, + "patch": { + "tags": [ + "issue" + ], + "summary": "Edit an issue attachment", + "operationId": "issueEditIssueAttachment", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the attachment to edit", + "name": "attachment_id" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditAttachmentOptions" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/labels": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get an issue's labels", + "operationId": "issueGetLabels", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/LabelList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "put": { + "tags": [ + "issue" + ], + "summary": "Replace an issue's labels", + "operationId": "issueReplaceLabels", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/IssueLabelsOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/LabelList" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + }, + "post": { + "summary": "Add a label to an issue", + "operationId": "issueAddLabel", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/IssueLabelsOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/LabelList" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Remove all labels from an issue", + "operationId": "issueClearLabels", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/secrets": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List an repo's actions secrets", + "operationId": "repoListActionsSecrets", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repository", + "name": "repo" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/SecretList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/new": { + "post": { + "consumes": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a wiki page", + "operationId": "repoCreateWikiPage", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "schema": { + "$ref": "#/definitions/CreateWikiPageOptions" + }, + "name": "body", + "in": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "201": { + "$ref": "#/responses/WikiPage" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/start": { + "post": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "format": "int64", + "description": "index of the issue to create the stopwatch on", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "201": { + "$ref": "#/responses/empty" + }, + "403": { + "description": "Not repo writer, user does not have rights to toggle stopwatch" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "description": "Cannot start a stopwatch again if it already exists" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Start stopwatch on an issue.", + "operationId": "issueStartStopWatch" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issue_config/validate": { + "get": { + "summary": "Returns the validation information for a issue config", + "operationId": "repoValidateIssueConfig", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RepoIssueConfigValidation" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions": { + "get": { + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/UserList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get users who subscribed on an issue.", + "operationId": "issueSubscriptions" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tag_protections/{id}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get a specific tag protection for the repository", + "operationId": "repoGetTagProtection", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "integer", + "description": "id of the tag protect to get", + "name": "id", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/TagProtection" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "summary": "Delete a specific tag protection for the repository", + "operationId": "repoDeleteTagProtection", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "required": true, + "type": "integer", + "description": "id of protected tag", + "name": "id", + "in": "path" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Edit a tag protections for a repository. Only fields that are set will be changed", + "operationId": "repoEditTagProtection", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "description": "id of protected tag", + "name": "id", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditTagProtectionOption" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TagProtection" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}": { + "get": { + "operationId": "issueGetIssue", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue to get", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Issue" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get an issue" + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Delete an issue", + "operationId": "issueDelete", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of issue to delete", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "patch": { + "tags": [ + "issue" + ], + "summary": "Edit an issue. If using deadline only the date will be taken into account, and time of day ignored.", + "operationId": "issueEditIssue", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue to edit", + "name": "index" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditIssueOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "412": { + "$ref": "#/responses/error" + }, + "201": { + "$ref": "#/responses/Issue" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}/jobs": { + "get": { + "tags": [ + "repository" + ], + "summary": "Lists all jobs for a workflow run", + "operationId": "listWorkflowRunJobs", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "integer", + "description": "runid of the workflow run", + "name": "run" + }, + { + "type": "string", + "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", + "name": "status", + "in": "query" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WorkflowJobsList" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/milestones/{id}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/Milestone" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a milestone", + "operationId": "issueGetMilestone", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "description": "the milestone to get, identified by ID and if not available by name", + "name": "id", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + }, + "delete": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "description": "the milestone to delete, identified by ID and if not available by name", + "name": "id", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "issue" + ], + "summary": "Delete a milestone", + "operationId": "issueDeleteMilestone" + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Update a milestone", + "operationId": "issueEditMilestone", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "string", + "description": "the milestone to edit, identified by ID and if not available by name" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditMilestoneOption" + } + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Milestone" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/revisions/{pageName}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get revisions of a wiki page", + "operationId": "repoGetWikiPageRevisions", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "name of the page", + "name": "pageName", + "in": "path", + "required": true + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WikiCommitList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/blobs/{sha}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets the blob of a repository.", + "operationId": "GetBlob", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "sha of the commit", + "name": "sha" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/GitBlobResponse" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/commits": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a list of all commits from a repository", + "operationId": "repoGetAllCommits", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "SHA or branch to start listing commits from (usually 'master')", + "name": "sha", + "in": "query" + }, + { + "type": "string", + "description": "filepath of a file/dir", + "name": "path", + "in": "query" + }, + { + "type": "string", + "format": "date-time", + "description": "Only commits after this date will be returned (ISO 8601 format)", + "name": "since", + "in": "query" + }, + { + "type": "string", + "format": "date-time", + "description": "Only commits before this date will be returned (ISO 8601 format)", + "name": "until", + "in": "query" + }, + { + "type": "boolean", + "description": "include diff stats for every commit (disable for speedup, default 'true')", + "name": "stat", + "in": "query" + }, + { + "name": "verification", + "in": "query", + "type": "boolean", + "description": "include verification for every commit (disable for speedup, default 'true')" + }, + { + "type": "boolean", + "description": "include a list of affected files for every commit (disable for speedup, default 'true')", + "name": "files", + "in": "query" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "name": "limit", + "in": "query", + "type": "integer", + "description": "page size of results (ignored if used with 'path')" + }, + { + "type": "string", + "description": "commits that match the given specifier will not be listed.", + "name": "not", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/CommitList" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/EmptyRepository" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List repository workflows", + "operationId": "ActionsListRepositoryWorkflows", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ActionWorkflowList" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "500": { + "$ref": "#/responses/error" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/collaborators": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's collaborators", + "operationId": "repoListCollaborators", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "page", + "in": "query", + "type": "integer", + "description": "page number of results to return (1-based)" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/UserList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "name", + "in": "query", + "type": "string", + "description": "name of the artifact" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/ArtifactsList" + }, + "400": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Lists all artifacts for a repository", + "operationId": "getArtifacts" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/commits/{sha}/pull": { + "get": { + "operationId": "repoGetCommitPullRequest", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "SHA of the commit to get", + "name": "sha", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullRequest" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get the merged pull request of the commit" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branch_protections": { + "get": { + "tags": [ + "repository" + ], + "summary": "List branch protections for a repository", + "operationId": "repoListBranchProtection", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/BranchProtectionList" + } + }, + "produces": [ + "application/json" + ] + }, + "post": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "schema": { + "$ref": "#/definitions/CreateBranchProtectionOption" + }, + "name": "body", + "in": "body" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "201": { + "$ref": "#/responses/BranchProtection" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a branch protections for a repository", + "operationId": "repoCreateBranchProtection" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/assets": { + "get": { + "operationId": "issueListIssueAttachments", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/AttachmentList" + }, + "404": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List issue's attachments" + }, + "post": { + "consumes": [ + "multipart/form-data" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create an issue attachment", + "operationId": "issueCreateIssueAttachment", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the attachment", + "name": "name", + "in": "query" + }, + { + "required": true, + "type": "file", + "description": "attachment to upload", + "name": "attachment", + "in": "formData" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Attachment" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/error" + }, + "413": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}": { + "put": { + "tags": [ + "repository" + ], + "summary": "Add or Update a collaborator to a repository", + "operationId": "repoAddCollaborator", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "username of the user to add or update as a collaborator", + "name": "collaborator" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/AddCollaboratorOption" + }, + "name": "body" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a collaborator from a repository", + "operationId": "repoDeleteCollaborator", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "username of the collaborator to delete", + "name": "collaborator" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + }, + "get": { + "summary": "Check if a user is a collaborator of a repository", + "operationId": "repoCheckCollaborator", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "username of the user to check for being a collaborator", + "name": "collaborator", + "in": "path", + "required": true + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a hook", + "operationId": "repoGetHook", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the hook to get", + "name": "id", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/Hook" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "operationId": "repoDeleteHook", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "id of the hook to delete", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" }, { "description": "group ID of the repo", @@ -235,17 +5671,128 @@ "tags": [ "repository" ], - "summary": "Delete a release attachment" + "summary": "Delete a hook in a repository" }, "patch": { + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "description": "index of the hook", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditHookOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Hook" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, "produces": [ "application/json" ], "tags": [ "repository" ], - "summary": "Edit a release attachment", - "operationId": "repoEditReleaseAttachment", + "summary": "Edit a hook in a repository", + "operationId": "repoEditHook" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/languages": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/LanguageStatistics" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get languages and number of bytes of code written", + "operationId": "repoGetLanguages", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/subscribers": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/UserList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's watchers", + "operationId": "repoListSubscribers", "parameters": [ { "type": "string", @@ -262,27 +5809,126 @@ "description": "name of the repo" }, { - "required": true, "type": "integer", - "format": "int64", - "description": "id of the release", - "name": "id", - "in": "path" + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" }, { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "name": "group_id", "type": "integer", "format": "int64", - "description": "id of the attachment to edit", - "name": "attachment_id", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/raw/{filepath}": { + "get": { + "produces": [ + "application/octet-stream" + ], + "tags": [ + "repository" + ], + "summary": "Get a file from a repository", + "operationId": "repoGetRawFile", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", "in": "path", "required": true }, { - "name": "body", - "in": "body", + "in": "path", + "required": true, + "type": "string", + "description": "path of the file to get, it should be \"{ref}/{filepath}\". If there is no ref could be inferred, it will be treated as the default branch", + "name": "filepath" + }, + { + "in": "query", + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch", + "name": "ref" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { "schema": { - "$ref": "#/definitions/EditAttachmentOptions" - } + "type": "file" + }, + "description": "Returns raw file content." + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/dependencies": { + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Remove an issue dependency", + "operationId": "issueRemoveIssueDependencies", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "schema": { + "$ref": "#/definitions/IssueMeta" + }, + "name": "body", + "in": "body" }, { "description": "group ID of the repo", @@ -294,31 +5940,148 @@ } ], "responses": { - "201": { - "$ref": "#/responses/Attachment" + "200": { + "$ref": "#/responses/Issue" }, "404": { "$ref": "#/responses/notFound" }, - "422": { - "$ref": "#/responses/validationError" + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + }, + "get": { + "summary": "List an issue's dependencies, i.e all issues that block this issue.", + "operationId": "issueListIssueDependencies", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "index of the issue", + "name": "index" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/IssueList" + }, + "404": { + "$ref": "#/responses/notFound" } }, - "consumes": [ + "produces": [ "application/json" + ], + "tags": [ + "issue" ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/comments": { - "get": { + }, + "post": { + "operationId": "issueCreateIssueDependencies", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/IssueMeta" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Issue" + }, + "404": { + "description": "the issue does not exist" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, "produces": [ "application/json" ], "tags": [ "issue" ], - "summary": "List all comments on an issue", - "operationId": "issueGetComments", + "summary": "Make the issue in the url depend on the issue in the form." + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/pinned": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's pinned issues", + "operationId": "repoListPinnedIssues", "parameters": [ { "description": "owner of the repo", @@ -335,26 +6098,1323 @@ "required": true }, { + "description": "group ID of the repo", + "name": "group_id", "type": "integer", "format": "int64", - "description": "index of the issue", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/IssueList" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/tags/{sha}": { + "get": { + "operationId": "GetAnnotatedTag", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "sha of the tag. The Git tags API only supports annotated tag objects, not lightweight tags.", + "name": "sha", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/AnnotatedTag" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets the tag object of an annotated tag (not lightweight tags)" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branch_protections/{name}": { + "get": { + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "name of protected branch", + "name": "name", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/BranchProtection" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a specific branch protection for the repository", + "operationId": "repoGetBranchProtection" + }, + "delete": { + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a specific branch protection for the repository", + "operationId": "repoDeleteBranchProtection", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of protected branch", + "name": "name", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Edit a branch protections for a repository. Only fields that are set will be changed", + "operationId": "repoEditBranchProtection", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of protected branch", + "name": "name", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditBranchProtectionOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/BranchProtection" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/times": { + "get": { + "summary": "List a repo's tracked times", + "operationId": "repoTrackedTimes", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "optional filter by user (available for issue managers)", + "name": "user", + "in": "query", + "type": "string" + }, + { + "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format", + "name": "since", + "in": "query", + "type": "string", + "format": "date-time" + }, + { + "name": "before", + "in": "query", + "type": "string", + "format": "date-time", + "description": "Only show times updated before the given time. This is a timestamp in RFC 3339 format" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/TrackedTimeList" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/media/{filepath}": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "path of the file to get, it should be \"{ref}/{filepath}\". If there is no ref could be inferred, it will be treated as the default branch", + "name": "filepath", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch", + "name": "ref", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "description": "Returns raw file content.", + "schema": { + "type": "file" + } + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/octet-stream" + ], + "tags": [ + "repository" + ], + "summary": "Get a file or it's LFS object from a repository", + "operationId": "repoGetRawFileOrLFS" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/trees/{sha}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Gets the tree of a repository.", + "operationId": "GetTree", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "required": true, + "type": "string", + "description": "sha of the commit", + "name": "sha", + "in": "path" + }, + { + "type": "boolean", + "description": "show all directories and files", + "name": "recursive", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page number; the 'truncated' field in the response will be true if there are still more items after this page, false if the last page", + "name": "page" + }, + { + "description": "number of items per page", + "name": "per_page", + "in": "query", + "type": "integer" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/GitTreeResponse" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/notifications": { + "get": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "notification" + ], + "summary": "List users's notification threads on a specific repo", + "operationId": "notifyGetRepoList", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "boolean", + "description": "If true, show notifications marked as read. Default value is false", + "name": "all", + "in": "query" + }, + { + "type": "array", + "items": { + "type": "string" + }, + "collectionFormat": "multi", + "description": "Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread & pinned", + "name": "status-types", + "in": "query" + }, + { + "description": "filter notifications by subject type", + "name": "subject-type", + "in": "query", + "type": "array", + "items": { + "enum": [ + "issue", + "pull", + "commit", + "repository" + ], + "type": "string" + }, + "collectionFormat": "multi" + }, + { + "type": "string", + "format": "date-time", + "description": "Only show notifications updated after the given time. This is a timestamp in RFC 3339 format", + "name": "since", + "in": "query" + }, + { + "description": "Only show notifications updated before the given time. This is a timestamp in RFC 3339 format", + "name": "before", + "in": "query", + "type": "string", + "format": "date-time" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "description": "page size of results", + "name": "limit", + "in": "query", + "type": "integer" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/NotificationThreadList" + } + } + }, + "put": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "notification" + ], + "summary": "Mark notification threads as read, pinned or unread on a specific repo", + "operationId": "notifyReadRepoList", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "name": "all", + "in": "query", + "type": "string", + "description": "If true, mark all notifications on this repo. Default value is false" + }, + { + "collectionFormat": "multi", + "description": "Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread.", + "name": "status-types", + "in": "query", + "type": "array", + "items": { + "type": "string" + } + }, + { + "name": "to-status", + "in": "query", + "type": "string", + "description": "Status to mark notifications as. Defaults to read." + }, + { + "in": "query", + "type": "string", + "format": "date-time", + "description": "Describes the last point that notifications were checked. Anything updated since this time will not be updated.", + "name": "last_read_at" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "205": { + "$ref": "#/responses/NotificationThreadList" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/variables/{variablename}": { + "put": { + "operationId": "updateRepoVariable", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "variablename", + "in": "path", + "required": true, + "type": "string", + "description": "name of the variable" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/UpdateVariableOption" + } + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "201": { + "description": "response when updating a repo-level variable" + }, + "204": { + "description": "response when updating a repo-level variable" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Update a repo-level variable" + }, + "post": { + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the variable", + "name": "variablename", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateVariableOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "description": "response when creating a repo-level variable" + }, + "400": { + "$ref": "#/responses/error" + }, + "409": { + "description": "variable name already exists." + }, + "500": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a repo-level variable", + "operationId": "createRepoVariable" + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a repo-level variable", + "operationId": "deleteRepoVariable", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repository", + "name": "repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the variable", + "name": "variablename" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/ActionVariable" + }, + "201": { + "description": "response when deleting a variable" + }, + "204": { + "description": "response when deleting a variable" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "get": { + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/ActionVariable" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a repo-level variable", + "operationId": "getRepoVariable", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the variable", + "name": "variablename", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/file-contents": { + "get": { + "operationId": "repoGetFileContents", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", + "name": "ref", + "in": "query" + }, + { + "in": "query", + "required": true, + "type": "string", + "description": "The JSON encoded body (see the POST request): {\"files\": [\"filename1\", \"filename2\"]}", + "name": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/ContentsListResponse" + } + }, + "description": "See the POST method. This GET method supports using JSON encoded request body in query parameter.", + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get the metadata and contents of requested files" + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get the metadata and contents of requested files", + "operationId": "repoGetFileContentsPost", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "query", + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", + "name": "ref" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/GetFilesOptions" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/ContentsListResponse" + } + }, + "description": "Uses automatic pagination based on default page size and max response size and returns the maximum allowed number of files. Files which could not be retrieved are null. Files which are too large are being returned with `encoding == null`, `content == null` and `size > 0`, they can be requested separately by using the `download_url`." + } + }, + "/repos/{owner}/group/{group_id}/{repo}/push_mirrors/{name}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/PushMirror" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get push mirror of the repository by remoteName", + "operationId": "repoGetPushMirrorByRemoteName", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "remote name of push mirror", + "name": "name", + "in": "path", + "required": true + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ] + }, + "delete": { + "operationId": "repoDeletePushMirror", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "string", + "description": "remote name of the pushMirror", + "name": "name", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "deletes a push mirror from a repository by remoteName" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/jobs/{job_id}": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "id of the job", + "name": "job_id", + "in": "path", + "required": true + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WorkflowJob" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets a specific workflow job for a workflow run", + "operationId": "getWorkflowJob" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/refs/{ref}": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "part or full name of the ref", + "name": "ref", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/ReferenceList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get specified ref or filtered repository's refs", + "operationId": "repoListGitRefs" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/files": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get changed files for a pull request", + "operationId": "repoGetPullRequestFiles", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request to get", "name": "index", "in": "path", "required": true }, { - "name": "since", - "in": "query", "type": "string", - "format": "date-time", - "description": "if provided, only comments updated since the specified time are returned." + "description": "skip to given file", + "name": "skip-to", + "in": "query" }, { + "enum": [ + "ignore-all", + "ignore-change", + "ignore-eol", + "show-all" + ], + "type": "string", + "description": "whitespace behavior", + "name": "whitespace", + "in": "query" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "description": "page size of results", + "name": "limit", "in": "query", + "type": "integer" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ChangedFileList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/comments": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List all comments on an issue", + "operationId": "issueGetComments", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue" + }, + { + "type": "string", + "format": "date-time", + "description": "if provided, only comments updated since the specified time are returned.", + "name": "since", + "in": "query" + }, + { "type": "string", "format": "date-time", "description": "if provided, only comments updated before the provided time are returned.", - "name": "before" + "name": "before", + "in": "query" }, { "description": "group ID of the repo", @@ -402,11 +7462,11 @@ "operationId": "issueCreateComment", "parameters": [ { - "required": true, "type": "string", "description": "owner of the repo", "name": "owner", - "in": "path" + "in": "path", + "required": true }, { "type": "string", @@ -416,55 +7476,19 @@ "required": true }, { - "description": "index of the issue", "name": "index", "in": "path", "required": true, "type": "integer", - "format": "int64" + "format": "int64", + "description": "index of the issue" }, { - "name": "body", - "in": "body", "schema": { "$ref": "#/definitions/CreateIssueCommentOption" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases/tags/{tag}": { - "get": { - "operationId": "repoGetReleaseByTag", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "tag name of the release to get", - "name": "tag" + }, + "name": "body", + "in": "body" }, { "format": "int64", @@ -474,81 +7498,17 @@ "name": "group_id", "type": "integer" } - ], + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}/tests": { + "post": { "responses": { - "200": { - "$ref": "#/responses/Release" - }, "404": { "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a release by tag name" - }, - "delete": { - "tags": [ - "repository" - ], - "summary": "Delete a release by tag name", - "operationId": "repoDeleteReleaseByTag", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "tag name of the release to delete", - "name": "tag", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { "204": { "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases/latest": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/Release" - }, - "404": { - "$ref": "#/responses/notFound" } }, "produces": [ @@ -557,8 +7517,8 @@ "tags": [ "repository" ], - "summary": "Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at", - "operationId": "repoGetLatestRelease", + "summary": "Test a push webhook", + "operationId": "repoTestHook", "parameters": [ { "type": "string", @@ -567,108 +7527,6 @@ "in": "path", "required": true }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/notes/{sha}": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/Note" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a note corresponding to a single commit from a repository", - "operationId": "repoGetNote", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "a git ref or commit sha", - "name": "sha", - "in": "path", - "required": true - }, - { - "type": "boolean", - "description": "include verification for every commit (disable for speedup, default 'true')", - "name": "verification", - "in": "query" - }, - { - "type": "boolean", - "description": "include a list of affected files for every commit (disable for speedup, default 'true')", - "name": "files", - "in": "query" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/commits/{sha}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a single commit from a repository", - "operationId": "repoGetSingleCommit", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, { "required": true, "type": "string", @@ -677,122 +7535,101 @@ "in": "path" }, { - "in": "path", - "required": true, - "type": "string", - "description": "a git ref or commit sha", - "name": "sha" - }, - { - "in": "query", - "type": "boolean", - "description": "include diff stats for every commit (disable for speedup, default 'true')", - "name": "stat" - }, - { - "name": "verification", - "in": "query", - "type": "boolean", - "description": "include verification for every commit (disable for speedup, default 'true')" - }, - { - "type": "boolean", - "description": "include a list of affected files for every commit (disable for speedup, default 'true')", - "name": "files", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", "type": "integer", "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "200": { - "$ref": "#/responses/Commit" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/times/{id}": { - "delete": { - "operationId": "issueDeleteTime", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { + "description": "id of the hook to test", "name": "id", "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of time to delete" + "required": true + }, + { + "type": "string", + "description": "The name of the commit/branch/tag, indicates which commit will be loaded to the webhook payload.", + "name": "ref", + "in": "query" }, { - "required": true, - "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", - "format": "int64" + "format": "int64", + "required": true, + "in": "path" } - ], + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments": { + "get": { "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" + "200": { + "$ref": "#/responses/CommentList" }, "404": { "$ref": "#/responses/notFound" } }, - "consumes": [ - "application/json" - ], "produces": [ "application/json" ], "tags": [ "issue" ], - "summary": "Delete specific tracked time" + "summary": "List all comments in a repository", + "operationId": "issueGetRepoComments", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "query", + "type": "string", + "format": "date-time", + "description": "if provided, only comments updated since the provided time are returned.", + "name": "since" + }, + { + "type": "string", + "format": "date-time", + "description": "if provided, only comments updated before the provided time are returned.", + "name": "before", + "in": "query" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] } }, - "/repos/{owner}/group/{group_id}/{repo}/actions/tasks": { + "/repos/{owner}/group/{group_id}/{repo}/push_mirrors": { "get": { "produces": [ "application/json" @@ -800,8 +7637,8 @@ "tags": [ "repository" ], - "summary": "List a repository's action tasks", - "operationId": "ListActionTasks", + "summary": "Get all push mirrors of the repository", + "operationId": "repoListPushMirrors", "parameters": [ { "description": "owner of the repo", @@ -811,21 +7648,21 @@ "type": "string" }, { - "name": "repo", - "in": "path", "required": true, "type": "string", - "description": "name of the repo" - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" + "description": "name of the repo", + "name": "repo", + "in": "path" }, { "type": "integer", - "description": "page size of results, default maximum page size is 50", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", "name": "limit", "in": "query" }, @@ -848,68 +7685,37 @@ "404": { "$ref": "#/responses/notFound" }, - "409": { - "$ref": "#/responses/conflict" - }, - "422": { - "$ref": "#/responses/validationError" - }, "200": { - "$ref": "#/responses/TasksList" + "$ref": "#/responses/PushMirrorList" } } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/transfer/accept": { + }, "post": { - "summary": "Accept a repo transfer", - "operationId": "acceptRepoTransfer", - "parameters": [ - { - "type": "string", - "description": "owner of the repo to transfer", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo to transfer", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], "responses": { - "202": { - "$ref": "#/responses/Repository" - }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/PushMirror" + }, + "400": { + "$ref": "#/responses/error" } }, + "consumes": [ + "application/json" + ], "produces": [ "application/json" ], "tags": [ "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets": { - "get": { - "operationId": "repoListReleaseAttachments", + ], + "summary": "add a push mirror to the repository", + "operationId": "repoAddPushMirror", "parameters": [ { "description": "owner of the repo", @@ -919,19 +7725,54 @@ "type": "string" }, { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreatePushMirrorOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runners": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get repo-level runners", + "operationId": "getRepoRunners", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", "required": true, "type": "string", "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "type": "integer", - "format": "int64", - "description": "id of the release", - "name": "id", - "in": "path", - "required": true + "name": "repo" }, { "in": "path", @@ -944,60 +7785,48 @@ ], "responses": { "200": { - "$ref": "#/responses/AttachmentList" + "$ref": "#/definitions/ActionRunnersResponse" + }, + "400": { + "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List release's attachments" - }, - "post": { - "tags": [ - "repository" - ], - "summary": "Create a release attachment", - "operationId": "repoCreateReleaseAttachment", + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/{user}": { + "put": { "parameters": [ { - "type": "string", - "description": "owner of the repo", "name": "owner", "in": "path", - "required": true + "required": true, + "type": "string", + "description": "owner of the repo" }, { - "type": "string", - "description": "name of the repo", "name": "repo", "in": "path", - "required": true + "required": true, + "type": "string", + "description": "name of the repo" }, { + "in": "path", "required": true, "type": "integer", "format": "int64", - "description": "id of the release", - "name": "id", - "in": "path" + "description": "index of the issue", + "name": "index" }, { - "type": "string", - "description": "name of the attachment", - "name": "name", - "in": "query" - }, - { - "in": "formData", - "type": "file", - "description": "attachment to upload", - "name": "attachment" + "description": "username of the user to subscribe the issue to", + "name": "user", + "in": "path", + "required": true, + "type": "string" }, { "required": true, @@ -1009,31 +7838,102 @@ } ], "responses": { + "304": { + "description": "User can only subscribe itself if he is no admin" + }, "404": { "$ref": "#/responses/notFound" }, - "413": { - "$ref": "#/responses/error" + "200": { + "description": "Already subscribed" }, "201": { - "$ref": "#/responses/Attachment" - }, - "400": { - "$ref": "#/responses/error" + "description": "Successfully Subscribed" } }, "consumes": [ - "multipart/form-data", - "application/octet-stream" + "application/json" ], "produces": [ "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Subscribe user to issue", + "operationId": "issueAddSubscription" + }, + "delete": { + "summary": "Unsubscribe user from issue", + "operationId": "issueDeleteSubscription", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue" + }, + { + "type": "string", + "description": "username of the user to unsubscribe from an issue", + "name": "user", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "description": "Already unsubscribed" + }, + "201": { + "description": "Successfully Unsubscribed" + }, + "304": { + "description": "User can only subscribe itself if he is no admin" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" ] } }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}": { - "get": { - "operationId": "repoGetPullRequest", + "/repos/{owner}/group/{group_id}/{repo}/actions/runners/{runner_id}": { + "delete": { + "summary": "Delete an repo-level runner", + "operationId": "deleteRepoRunner", "parameters": [ { "type": "string", @@ -1043,19 +7943,130 @@ "required": true }, { - "required": true, "type": "string", "description": "name of the repo", "name": "repo", - "in": "path" + "in": "path", + "required": true }, { "in": "path", "required": true, + "type": "string", + "description": "id of the runner", + "name": "runner_id" + }, + { "type": "integer", "format": "int64", - "description": "index of the pull request to get", - "name": "index" + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "description": "runner has been deleted" + }, + "400": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "get": { + "summary": "Get an repo-level runner", + "operationId": "getRepoRunner", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "id of the runner", + "name": "runner_id", + "in": "path", + "required": true + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/definitions/ActionRunner" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets a specific workflow run", + "operationId": "GetWorkflowRun", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repository" + }, + { + "type": "string", + "description": "id of the run", + "name": "run", + "in": "path", + "required": true }, { "description": "group ID of the repo", @@ -1068,154 +8079,25 @@ ], "responses": { "200": { - "$ref": "#/responses/PullRequest" + "$ref": "#/responses/WorkflowRun" }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a pull request" - }, - "patch": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Update a pull request. If using deadline only the date will be taken into account, and time of day ignored.", - "operationId": "repoEditPullRequest", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "integer", - "format": "int64", - "description": "index of the pull request to edit", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditPullRequestOption" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "409": { + "400": { "$ref": "#/responses/error" }, - "412": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "201": { - "$ref": "#/responses/PullRequest" - }, - "403": { - "$ref": "#/responses/forbidden" - }, "404": { "$ref": "#/responses/notFound" } } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/archive/{archive}": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get an archive of a repository", - "operationId": "repoGetArchive", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "the git reference for download with attached archive format (e.g. master.zip)", - "name": "archive", - "in": "path", - "required": true - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "description": "success" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}/artifacts": { - "get": { + }, + "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], - "summary": "Lists all artifacts for a repository run", - "operationId": "getArtifactsOfRun", + "summary": "Delete a workflow run", + "operationId": "deleteActionRun", "parameters": [ { "type": "string", @@ -1225,11 +8107,11 @@ "required": true }, { - "in": "path", - "required": true, "type": "string", "description": "name of the repository", - "name": "repo" + "name": "repo", + "in": "path", + "required": true }, { "type": "integer", @@ -1239,26 +8121,20 @@ "required": true }, { - "name": "name", - "in": "query", - "type": "string", - "description": "name of the artifact" - }, - { - "description": "group ID of the repo", "name": "group_id", "type": "integer", "format": "int64", "required": true, - "in": "path" + "in": "path", + "description": "group ID of the repo" } ], "responses": { "404": { "$ref": "#/responses/notFound" }, - "200": { - "$ref": "#/responses/ArtifactsList" + "204": { + "description": "No Content" }, "400": { "$ref": "#/responses/error" @@ -1266,384 +8142,32 @@ } } }, - "/repos/{owner}/group/{group_id}/{repo}/signing-key.pub": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "description": "ssh public key", - "schema": { - "type": "string" - } - } - }, - "produces": [ - "text/plain" - ], - "tags": [ - "repository" - ], - "summary": "Get signing-key.pub for given repository", - "operationId": "repoSigningKeySSH" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/stop": { - "post": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Stop an issue's existing stopwatch.", - "operationId": "issueStopStopWatch", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue to stop the stopwatch on" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "409": { - "description": "Cannot stop a non-existent stopwatch" - }, - "201": { - "$ref": "#/responses/empty" - }, - "403": { - "description": "Not repo writer, user does not have rights to toggle stopwatch" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/dependencies": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "List an issue's dependencies, i.e all issues that block this issue.", - "operationId": "issueListIssueDependencies", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "description": "page size of results", - "name": "limit", - "in": "query", - "type": "integer" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/IssueList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "summary": "Make the issue in the url depend on the issue in the form.", - "operationId": "issueCreateIssueDependencies", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "index of the issue", - "name": "index", - "in": "path" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/IssueMeta" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "404": { - "description": "the issue does not exist" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/Issue" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "delete": { - "operationId": "issueRemoveIssueDependencies", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "schema": { - "$ref": "#/definitions/IssueMeta" - }, - "name": "body", - "in": "body" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Issue" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Remove an issue dependency" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/labels/{id}": { - "delete": { - "operationId": "issueRemoveLabel", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the label to remove", - "name": "id" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Remove a label from an issue" - } - }, "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/delete": { "delete": { "summary": "Delete an issue's existing stopwatch.", "operationId": "issueDeleteStopWatch", "parameters": [ { - "type": "string", - "description": "owner of the repo", "name": "owner", "in": "path", - "required": true + "required": true, + "type": "string", + "description": "owner of the repo" }, { + "in": "path", + "required": true, "type": "string", "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true + "name": "repo" }, { + "name": "index", + "in": "path", "required": true, "type": "integer", "format": "int64", - "description": "index of the issue to stop the stopwatch on", - "name": "index", - "in": "path" + "description": "index of the issue to stop the stopwatch on" }, { "name": "group_id", @@ -1679,1636 +8203,7 @@ ] } }, - "/repos/{owner}/group/{group_id}/{repo}/issue_templates": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get available issue templates for a repository", - "operationId": "repoGetIssueTemplates", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/IssueTemplates" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/statuses/{sha}": { - "get": { - "summary": "Get a commit's statuses", - "operationId": "repoListStatuses", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "sha of the commit", - "name": "sha", - "in": "path", - "required": true, - "type": "string" - }, - { - "enum": [ - "oldest", - "recentupdate", - "leastupdate", - "leastindex", - "highestindex" - ], - "type": "string", - "description": "type of sort", - "name": "sort", - "in": "query" - }, - { - "enum": [ - "pending", - "success", - "error", - "failure", - "warning" - ], - "type": "string", - "description": "type of state", - "name": "state", - "in": "query" - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/CommitStatusList" - }, - "400": { - "$ref": "#/responses/error" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - }, - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a commit status", - "operationId": "repoCreateStatus", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "description": "sha of the commit", - "name": "sha", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateStatusOption" - } - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "201": { - "$ref": "#/responses/CommitStatus" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/pinned": { - "get": { - "tags": [ - "repository" - ], - "summary": "List a repo's pinned issues", - "operationId": "repoListPinnedIssues", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/IssueList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/notifications": { - "get": { - "operationId": "notifyGetRepoList", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "boolean", - "description": "If true, show notifications marked as read. Default value is false", - "name": "all", - "in": "query" - }, - { - "type": "array", - "items": { - "type": "string" - }, - "collectionFormat": "multi", - "description": "Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread & pinned", - "name": "status-types", - "in": "query" - }, - { - "in": "query", - "type": "array", - "items": { - "enum": [ - "issue", - "pull", - "commit", - "repository" - ], - "type": "string" - }, - "collectionFormat": "multi", - "description": "filter notifications by subject type", - "name": "subject-type" - }, - { - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only show notifications updated after the given time. This is a timestamp in RFC 3339 format", - "name": "since" - }, - { - "type": "string", - "format": "date-time", - "description": "Only show notifications updated before the given time. This is a timestamp in RFC 3339 format", - "name": "before", - "in": "query" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "in": "query", - "type": "integer", - "description": "page size of results", - "name": "limit" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/NotificationThreadList" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "notification" - ], - "summary": "List users's notification threads on a specific repo" - }, - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "notification" - ], - "summary": "Mark notification threads as read, pinned or unread on a specific repo", - "operationId": "notifyReadRepoList", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "If true, mark all notifications on this repo. Default value is false", - "name": "all", - "in": "query" - }, - { - "name": "status-types", - "in": "query", - "type": "array", - "items": { - "type": "string" - }, - "collectionFormat": "multi", - "description": "Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread." - }, - { - "name": "to-status", - "in": "query", - "type": "string", - "description": "Status to mark notifications as. Defaults to read." - }, - { - "type": "string", - "format": "date-time", - "description": "Describes the last point that notifications were checked. Anything updated since this time will not be updated.", - "name": "last_read_at", - "in": "query" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "205": { - "$ref": "#/responses/NotificationThreadList" - } - }, - "consumes": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/keys": { - "post": { - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateKeyOption" - } - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "201": { - "$ref": "#/responses/DeployKey" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Add a key to a repository", - "operationId": "repoCreateKey" - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repository's keys", - "operationId": "repoListKeys", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "integer", - "description": "the key_id to search for", - "name": "key_id", - "in": "query" - }, - { - "name": "fingerprint", - "in": "query", - "type": "string", - "description": "fingerprint of the key" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/DeployKeyList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/tags/{tag}": { - "delete": { - "summary": "Delete a repository's tag by name", - "operationId": "repoDeleteTag", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of tag to delete", - "name": "tag", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "405": { - "$ref": "#/responses/empty" - }, - "409": { - "$ref": "#/responses/conflict" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get the tag of a repository by tag name", - "operationId": "repoGetTag", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of tag", - "name": "tag", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/Tag" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/wiki/new": { - "post": { - "responses": { - "201": { - "$ref": "#/responses/WikiPage" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a wiki page", - "operationId": "repoCreateWikiPage", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "schema": { - "$ref": "#/definitions/CreateWikiPageOptions" - }, - "name": "body", - "in": "body" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/contents": { - "get": { - "description": "This API follows GitHub's design, and it is not easy to use. Recommend users to use our \"contents-ext\" API instead.", - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets the metadata of all the entries of the root dir.", - "operationId": "repoGetContentsList", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", - "name": "ref", - "in": "query" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/ContentsListResponse" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Modify multiple files in a repository", - "operationId": "repoChangeFiles", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/ChangeFilesOptions" - } - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/error" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/FilesResponse" - }, - "403": { - "$ref": "#/responses/error" - } - }, - "consumes": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/labels": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get an issue's labels", - "operationId": "issueGetLabels", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/LabelList" - } - } - }, - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Replace an issue's labels", - "operationId": "issueReplaceLabels", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/IssueLabelsOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/LabelList" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ] - }, - "post": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Add a label to an issue", - "operationId": "issueAddLabel", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/IssueLabelsOption" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "$ref": "#/responses/LabelList" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "delete": { - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Remove all labels from an issue", - "operationId": "issueClearLabels", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/merge": { - "post": { - "responses": { - "405": { - "$ref": "#/responses/empty" - }, - "409": { - "$ref": "#/responses/error" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "200": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Merge a pull request", - "operationId": "repoMergePullRequest", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request to merge" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/MergePullRequestOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Cancel the scheduled auto merge for the given pull request", - "operationId": "repoCancelScheduledAutoMerge", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "description": "index of the pull request to merge", - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - } - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Check if a pull request has been merged", - "operationId": "repoPullRequestIsMerged", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "404": { - "description": "pull request has not been merged" - }, - "204": { - "description": "pull request has been merged" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runners/{runner_id}": { - "delete": { - "summary": "Delete an repo-level runner", - "operationId": "deleteRepoRunner", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "id of the runner", - "name": "runner_id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "description": "runner has been deleted" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get an repo-level runner", - "operationId": "getRepoRunner", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "name": "runner_id", - "in": "path", - "required": true, - "type": "string", - "description": "id of the runner" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/definitions/ActionRunner" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/lock": { - "delete": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Unlock an issue", - "operationId": "issueUnlockIssue", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Lock an issue", - "operationId": "issueLockIssue", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/LockIssueOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "consumes": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/assets": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "List comment's attachments", - "operationId": "issueListIssueCommentAttachments", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "description": "id of the comment", - "name": "id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "$ref": "#/responses/AttachmentList" - }, - "404": { - "$ref": "#/responses/error" - } - } - }, - "post": { - "operationId": "issueCreateIssueCommentAttachment", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the comment", - "name": "id", - "in": "path" - }, - { - "type": "string", - "description": "name of the attachment", - "name": "name", - "in": "query" - }, - { - "description": "attachment to upload", - "name": "attachment", - "in": "formData", - "required": true, - "type": "file" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "413": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/Attachment" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/error" - } - }, - "consumes": [ - "multipart/form-data" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Create a comment attachment" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/pinned": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repo's pinned pull requests", - "operationId": "repoListPinnedPullRequests", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/PullRequestList" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/commits/{sha}.{diffType}": { + "/repos/{owner}/group/{group_id}/{repo}/signing-key.pub": { "get": { "produces": [ "text/plain" @@ -3316,676 +8211,8 @@ "tags": [ "repository" ], - "summary": "Get a commit's diff or patch", - "operationId": "repoDownloadCommitDiffOrPatch", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "sha", - "in": "path", - "required": true, - "type": "string", - "description": "SHA of the commit to get" - }, - { - "name": "diffType", - "in": "path", - "required": true, - "enum": [ - "diff", - "patch" - ], - "type": "string", - "description": "whether the output is diff or patch" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/string" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Lists all artifacts for a repository", - "operationId": "getArtifacts", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "name", - "in": "query", - "type": "string", - "description": "name of the artifact" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ArtifactsList" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/reactions": { - "delete": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Remove a reaction from an issue", - "operationId": "issueDeleteIssueReaction", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "content", - "in": "body", - "schema": { - "$ref": "#/definitions/EditReactionOption" - } - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "get": { - "summary": "Get a list reactions of an issue", - "operationId": "issueGetIssueReactions", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue" - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/ReactionList" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/EditReactionOption" - }, - "name": "content" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/Reaction" - }, - "201": { - "$ref": "#/responses/Reaction" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Add a reaction to an issue", - "operationId": "issuePostIssueReaction" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/secrets/{secretname}": { - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create or Update a secret value in a repository", - "operationId": "updateRepoSecret", - "parameters": [ - { - "description": "owner of the repository", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the secret", - "name": "secretname", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateOrUpdateSecretOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "201": { - "description": "response when creating a secret" - }, - "204": { - "description": "response when updating a secret" - }, - "400": { - "$ref": "#/responses/error" - } - }, - "consumes": [ - "application/json" - ] - }, - "delete": { - "tags": [ - "repository" - ], - "summary": "Delete a secret in a repository", - "operationId": "deleteRepoSecret", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repository", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo" - }, - { - "description": "name of the secret", - "name": "secretname", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "description": "delete one secret of the repository" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/branches": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/BranchList" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repository's branches", - "operationId": "repoListBranches", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "in": "query", - "type": "integer", - "description": "page size of results", - "name": "limit" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ] - }, - "post": { - "tags": [ - "repository" - ], - "summary": "Create a branch", - "operationId": "repoCreateBranch", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateBranchRepoOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Branch" - }, - "403": { - "description": "The branch is archived or a mirror." - }, - "404": { - "description": "The old branch does not exist." - }, - "409": { - "description": "The branch with the same name already exists." - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/jobs": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Lists all jobs for a repository", - "operationId": "listWorkflowJobs", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repository" - }, - { - "type": "string", - "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", - "name": "status", - "in": "query" - }, - { - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/WorkflowJobsList" - }, - "400": { - "$ref": "#/responses/error" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "format": "int64", - "description": "id of the comment", - "name": "id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Comment" - }, - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get a comment", - "operationId": "issueGetComment" - }, - "delete": { - "summary": "Delete a comment", - "operationId": "issueDeleteComment", + "summary": "Get signing-key.pub for given repository", + "operationId": "repoSigningKeySSH", "parameters": [ { "type": "string", @@ -4001,2276 +8228,6 @@ "type": "string", "description": "name of the repo" }, - { - "format": "int64", - "description": "id of comment to delete", - "name": "id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "tags": [ - "issue" - ] - }, - "patch": { - "responses": { - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "200": { - "$ref": "#/responses/Comment" - }, - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Edit a comment", - "operationId": "issueEditComment", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the comment to edit", - "name": "id", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditIssueCommentOption" - } - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/file-contents": { - "get": { - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/ContentsListResponse" - } - }, - "description": "See the POST method. This GET method supports using JSON encoded request body in query parameter.", - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get the metadata and contents of requested files", - "operationId": "repoGetFileContents", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", - "name": "ref", - "in": "query" - }, - { - "type": "string", - "description": "The JSON encoded body (see the POST request): {\"files\": [\"filename1\", \"filename2\"]}", - "name": "body", - "in": "query", - "required": true - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ] - }, - "post": { - "responses": { - "200": { - "$ref": "#/responses/ContentsListResponse" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "description": "Uses automatic pagination based on default page size and max response size and returns the maximum allowed number of files. Files which could not be retrieved are null. Files which are too large are being returned with `encoding == null`, `content == null` and `size > 0`, they can be requested separately by using the `download_url`.", - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get the metadata and contents of requested files", - "operationId": "repoGetFileContentsPost", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", - "name": "ref", - "in": "query", - "type": "string" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/GetFilesOptions" - } - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/undismissals": { - "post": { - "operationId": "repoUnDismissPullReview", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the review", - "name": "id" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "200": { - "$ref": "#/responses/PullReview" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Cancel to dismiss a review for a pull request" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues": { - "get": { - "summary": "List a repository's issues", - "operationId": "issueListIssues", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "enum": [ - "closed", - "open", - "all" - ], - "type": "string", - "description": "whether issue is open or closed", - "name": "state", - "in": "query" - }, - { - "type": "string", - "description": "comma separated list of label names. Fetch only issues that have any of this label names. Non existent labels are discarded.", - "name": "labels", - "in": "query" - }, - { - "description": "search string", - "name": "q", - "in": "query", - "type": "string" - }, - { - "enum": [ - "issues", - "pulls" - ], - "type": "string", - "description": "filter by type (issues / pulls) if set", - "name": "type", - "in": "query" - }, - { - "type": "string", - "description": "comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded", - "name": "milestones", - "in": "query" - }, - { - "name": "since", - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only show items updated after the given time. This is a timestamp in RFC 3339 format" - }, - { - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only show items updated before the given time. This is a timestamp in RFC 3339 format", - "name": "before" - }, - { - "type": "string", - "description": "Only show items which were created by the given user", - "name": "created_by", - "in": "query" - }, - { - "type": "string", - "description": "Only show items for which the given user is assigned", - "name": "assigned_by", - "in": "query" - }, - { - "type": "string", - "description": "Only show items in which the given user was mentioned", - "name": "mentioned_by", - "in": "query" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/IssueList" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "post": { - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateIssueOption" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/Issue" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "412": { - "$ref": "#/responses/error" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Create an issue. If using deadline only the date will be taken into account, and time of day ignored.", - "operationId": "issueCreateIssue" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/subscription": { - "put": { - "tags": [ - "repository" - ], - "summary": "Watch a repo", - "operationId": "userCurrentPutSubscription", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/WatchInfo" - } - } - }, - "delete": { - "summary": "Unwatch a repo", - "operationId": "userCurrentDeleteSubscription", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "tags": [ - "repository" - ] - }, - "get": { - "tags": [ - "repository" - ], - "summary": "Check if the current user is watching a repo", - "operationId": "userCurrentCheckSubscription", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WatchInfo" - }, - "404": { - "description": "User is not watching this repo or repo do not exist" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/refs": { - "get": { - "summary": "Get specified ref or filtered repository's refs", - "operationId": "repoListAllGitRefs", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/ReferenceList" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/contents-ext/{filepath}": { - "get": { - "description": "It guarantees that only one of the response fields is set if the request succeeds. Users can pass \"includes=file_content\" or \"includes=lfs_metadata\" to retrieve more fields. \"includes=file_content\" only works for single file, if you need to retrieve file contents in batch, use \"file-contents\" API after listing the directory.", - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "The extended \"contents\" API, to get file metadata and/or content, or list a directory.", - "operationId": "repoGetContentsExt", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "name": "filepath", - "in": "path", - "required": true, - "type": "string", - "description": "path of the dir, file, symlink or submodule in the repo. Swagger requires path parameter to be \"required\", you can leave it empty or pass a single dot (\".\") to get the root directory." - }, - { - "description": "the name of the commit/branch/tag, default to the repository’s default branch.", - "name": "ref", - "in": "query", - "type": "string" - }, - { - "description": "By default this API's response only contains file's metadata. Use comma-separated \"includes\" options to retrieve more fields. Option \"file_content\" will try to retrieve the file content, \"lfs_metadata\" will try to retrieve LFS metadata, \"commit_metadata\" will try to retrieve commit metadata, and \"commit_message\" will try to retrieve commit message.", - "name": "includes", - "in": "query", - "type": "string" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ContentsExtResponse" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/forks": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repository's forks", - "operationId": "listForks", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" - }, - { - "description": "page size of results", - "name": "limit", - "in": "query", - "type": "integer" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/RepositoryList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo to fork", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo to fork" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateForkOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "202": { - "$ref": "#/responses/Repository" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "description": "The repository with the same name already exists." - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Fork a repository", - "operationId": "createFork" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{base}/{head}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a pull request by base and head", - "operationId": "repoGetPullRequestByBaseHead", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "base of the pull request to get", - "name": "base" - }, - { - "required": true, - "type": "string", - "description": "head of the pull request to get", - "name": "head", - "in": "path" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/PullRequest" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/blobs/{sha}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets the blob of a repository.", - "operationId": "GetBlob", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "sha of the commit", - "name": "sha", - "in": "path", - "required": true - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/GitBlobResponse" - }, - "400": { - "$ref": "#/responses/error" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/commits": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request to get", - "name": "index", - "in": "path" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "type": "boolean", - "description": "include verification for every commit (disable for speedup, default 'true')", - "name": "verification", - "in": "query" - }, - { - "name": "files", - "in": "query", - "type": "boolean", - "description": "include a list of affected files for every commit (disable for speedup, default 'true')" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/CommitList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get commits for a pull request", - "operationId": "repoGetPullRequestCommits" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/secrets": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List an repo's actions secrets", - "operationId": "repoListActionsSecrets", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/SecretList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/pin/{position}": { - "patch": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of issue", - "name": "index", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "the new position", - "name": "position" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "tags": [ - "issue" - ], - "summary": "Moves the Pin to the given Position", - "operationId": "moveIssuePin" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/mirror-sync": { - "post": { - "summary": "Sync a mirrored repository", - "operationId": "repoMirrorSync", - "parameters": [ - { - "type": "string", - "description": "owner of the repo to sync", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo to sync", - "name": "repo", - "in": "path" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runs": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Lists all runs for a repository run", - "operationId": "getWorkflowRuns", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo" - }, - { - "type": "string", - "description": "workflow event name", - "name": "event", - "in": "query" - }, - { - "type": "string", - "description": "workflow branch", - "name": "branch", - "in": "query" - }, - { - "type": "string", - "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", - "name": "status", - "in": "query" - }, - { - "in": "query", - "type": "string", - "description": "triggered by user", - "name": "actor" - }, - { - "type": "string", - "description": "triggering sha of the workflow run", - "name": "head_sha", - "in": "query" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WorkflowRunsList" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}": { - "get": { - "summary": "Get an issue", - "operationId": "issueGetIssue", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue to get", - "name": "index", - "in": "path" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Issue" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "delete": { - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "tags": [ - "issue" - ], - "summary": "Delete an issue", - "operationId": "issueDelete", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of issue to delete", - "name": "index", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - }, - "patch": { - "summary": "Edit an issue. If using deadline only the date will be taken into account, and time of day ignored.", - "operationId": "issueEditIssue", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue to edit", - "name": "index", - "in": "path" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditIssueOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "412": { - "$ref": "#/responses/error" - }, - "201": { - "$ref": "#/responses/Issue" - }, - "403": { - "$ref": "#/responses/forbidden" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/editorconfig/{filepath}": { - "get": { - "operationId": "repoGetEditorConfig", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "filepath of file to get", - "name": "filepath", - "in": "path", - "required": true - }, - { - "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", - "name": "ref", - "in": "query", - "type": "string" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "description": "success" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get the EditorConfig definitions of a file in a repository" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/teams/{team}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Check if a team is assigned to a repository", - "operationId": "repoCheckTeam", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "type": "string", - "description": "team name", - "name": "team", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Team" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "405": { - "$ref": "#/responses/error" - } - } - }, - "put": { - "tags": [ - "repository" - ], - "summary": "Add a team to a repository", - "operationId": "repoAddTeam", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "team name", - "name": "team", - "in": "path" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "405": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - }, - "delete": { - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "405": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a team from a repository", - "operationId": "repoDeleteTeam", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "type": "string", - "description": "team name", - "name": "team", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/tag_protections/{id}": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get a specific tag protection for the repository", - "operationId": "repoGetTagProtection", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "integer", - "description": "id of the tag protect to get", - "name": "id", - "in": "path" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/TagProtection" - } - }, - "produces": [ - "application/json" - ] - }, - "delete": { - "tags": [ - "repository" - ], - "summary": "Delete a specific tag protection for the repository", - "operationId": "repoDeleteTagProtection", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "description": "id of protected tag", - "name": "id" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - }, - "patch": { - "responses": { - "200": { - "$ref": "#/responses/TagProtection" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Edit a tag protections for a repository. Only fields that are set will be changed", - "operationId": "repoEditTagProtection", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "description": "id of protected tag", - "name": "id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditTagProtectionOption" - } - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/Repository" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a repository", - "operationId": "repoGet" - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a repository", - "operationId": "repoDelete", - "parameters": [ - { - "type": "string", - "description": "owner of the repo to delete", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo to delete", - "name": "repo" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "patch": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Edit a repository's properties. Only fields that are set will be changed.", - "operationId": "repoEdit", - "parameters": [ - { - "type": "string", - "description": "owner of the repo to edit", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo to edit", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "Properties of a repo that you can edit", - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditRepoOption" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "200": { - "$ref": "#/responses/Repository" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/languages": { - "get": { - "summary": "Get languages and number of bytes of code written", - "operationId": "repoGetLanguages", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/LanguageStatistics" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/subscribers": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repo's watchers", - "operationId": "repoListSubscribers", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/UserList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}.{diffType}": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/string" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "text/plain" - ], - "tags": [ - "repository" - ], - "summary": "Get a pull request diff or patch", - "operationId": "repoDownloadPullDiffOrPatch", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request to get" - }, - { - "enum": [ - "diff", - "patch" - ], - "type": "string", - "description": "whether the output is diff or patch", - "name": "diffType", - "in": "path", - "required": true - }, - { - "type": "boolean", - "description": "whether to include binary file changes. if true, the diff is applicable with `git apply`", - "name": "binary", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/raw/{filepath}": { - "get": { - "produces": [ - "application/octet-stream" - ], - "tags": [ - "repository" - ], - "summary": "Get a file from a repository", - "operationId": "repoGetRawFile", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "path of the file to get, it should be \"{ref}/{filepath}\". If there is no ref could be inferred, it will be treated as the default branch", - "name": "filepath", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "The name of the commit/branch/tag. Default to the repository’s default branch", - "name": "ref", - "in": "query" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "description": "Returns raw file content.", - "schema": { - "type": "file" - } - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/transfer": { - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo to transfer", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo to transfer", - "name": "repo", - "in": "path" - }, - { - "required": true, - "schema": { - "$ref": "#/definitions/TransferRepoOption" - }, - "description": "Transfer Options", - "name": "body", - "in": "body" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "202": { - "$ref": "#/responses/Repository" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Transfer a repo ownership", - "operationId": "repoTransfer" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/signing-key.gpg": { - "get": { - "produces": [ - "text/plain" - ], - "tags": [ - "repository" - ], - "summary": "Get signing-key.gpg for given repository", - "operationId": "repoSigningKey", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, { "description": "group ID of the repo", "name": "group_id", @@ -6282,5284 +8239,12 @@ ], "responses": { "200": { + "description": "ssh public key", "schema": { "type": "string" - }, - "description": "GPG armored public key" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issue_config/validate": { - "get": { - "tags": [ - "repository" - ], - "summary": "Returns the validation information for a issue config", - "operationId": "repoValidateIssueConfig", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/RepoIssueConfigValidation" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases/{id}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a release", - "operationId": "repoGetRelease", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the release to get" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Release" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "delete": { - "summary": "Delete a release", - "operationId": "repoDeleteRelease", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the release to delete", - "name": "id", - "in": "path" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "tags": [ - "repository" - ] - }, - "patch": { - "operationId": "repoEditRelease", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the release to edit", - "name": "id", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditReleaseOption" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Release" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Update a release" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/check": { - "get": { - "tags": [ - "issue" - ], - "summary": "Check if user is subscribed to an issue", - "operationId": "issueCheckSubscription", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WatchInfo" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runners": { - "get": { - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/definitions/ActionRunnersResponse" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get repo-level runners", - "operationId": "getRepoRunners", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/git": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List the Git hooks in a repository", - "operationId": "repoListGitHooks", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/GitHookList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions": { - "get": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get users who subscribed on an issue.", - "operationId": "issueSubscriptions", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index" - }, - { - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page" - }, - { - "name": "limit", - "in": "query", - "type": "integer", - "description": "page size of results" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/UserList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/assignees": { - "get": { - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/UserList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Return all users that have write access and can be assigned to issues", - "operationId": "repoGetAssignees" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/assets/{attachment_id}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get a comment attachment", - "operationId": "issueGetIssueCommentAttachment", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "id of the comment", - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "format": "int64", - "description": "id of the attachment to get", - "name": "attachment_id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Attachment" - }, - "404": { - "$ref": "#/responses/error" - } - } - }, - "delete": { - "summary": "Delete a comment attachment", - "operationId": "issueDeleteIssueCommentAttachment", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the comment", - "name": "id", - "in": "path", - "required": true - }, - { - "name": "attachment_id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the attachment to delete" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/error" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "patch": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "description": "id of the comment", - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "format": "int64", - "description": "id of the attachment to edit", - "name": "attachment_id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditAttachmentOptions" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Attachment" - }, - "404": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Edit a comment attachment", - "operationId": "issueEditIssueCommentAttachment" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/dispatches": { - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a workflow dispatch event", - "operationId": "ActionsDispatchWorkflow", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "id of the workflow", - "name": "workflow_id", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateActionWorkflowDispatch" - } - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "204": { - "description": "No Content" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/reviewers": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/UserList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Return all users that can be requested to review in this repo", - "operationId": "repoGetReviewers" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}/tests": { - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Test a push webhook", - "operationId": "repoTestHook", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "integer", - "format": "int64", - "description": "id of the hook to test", - "name": "id", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "The name of the commit/branch/tag, indicates which commit will be loaded to the webhook payload.", - "name": "ref", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo" - }, - { - "name": "run", - "in": "path", - "required": true, - "type": "string", - "description": "id of the run" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/WorkflowRun" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets a specific workflow run", - "operationId": "GetWorkflowRun" - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a workflow run", - "operationId": "deleteActionRun", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "run", - "in": "path", - "required": true, - "type": "integer", - "description": "runid of the workflow run" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "description": "No Content" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/trees/{sha}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets the tree of a repository.", - "operationId": "GetTree", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "sha of the commit", - "name": "sha", - "in": "path", - "required": true - }, - { - "name": "recursive", - "in": "query", - "type": "boolean", - "description": "show all directories and files" - }, - { - "type": "integer", - "description": "page number; the 'truncated' field in the response will be true if there are still more items after this page, false if the last page", - "name": "page", - "in": "query" - }, - { - "in": "query", - "type": "integer", - "description": "number of items per page", - "name": "per_page" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/GitTreeResponse" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a workflow", - "operationId": "ActionsGetWorkflow", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "id of the workflow", - "name": "workflow_id", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "500": { - "$ref": "#/responses/error" - }, - "200": { - "$ref": "#/responses/ActionWorkflow" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/enable": { - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Enable a workflow", - "operationId": "ActionsEnableWorkflow", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "id of the workflow", - "name": "workflow_id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "description": "No Content" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "$ref": "#/responses/conflict" - }, - "422": { - "$ref": "#/responses/validationError" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/commits/{sha}/pull": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get the merged pull request of the commit", - "operationId": "repoGetCommitPullRequest", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "SHA of the commit to get", - "name": "sha", - "in": "path" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/PullRequest" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/commits/{ref}/status": { - "get": { - "operationId": "repoGetCombinedStatusByRef", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of branch/tag/commit", - "name": "ref" - }, - { - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page" - }, - { - "name": "limit", - "in": "query", - "type": "integer", - "description": "page size of results" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/CombinedStatus" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a commit's combined status, by branch/tag/commit reference" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/wiki/revisions/{pageName}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get revisions of a wiki page", - "operationId": "repoGetWikiPageRevisions", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "required": true, - "type": "string", - "description": "name of the page", - "name": "pageName", - "in": "path" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WikiCommitList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/labels/{id}": { - "delete": { - "operationId": "issueDeleteLabel", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the label to delete", - "name": "id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "tags": [ - "issue" - ], - "summary": "Delete a label" - }, - "patch": { - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "200": { - "$ref": "#/responses/Label" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Update a label", - "operationId": "issueEditLabel", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the label to edit" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditLabelOption" - } - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ] - }, - "get": { - "tags": [ - "issue" - ], - "summary": "Get a single label", - "operationId": "issueGetLabel", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the label to get", - "name": "id" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Label" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a specific review for a pull request", - "operationId": "repoGetPullReview", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path" - }, - { - "description": "id of the review", - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/PullReview" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the review" - }, - { - "required": true, - "schema": { - "$ref": "#/definitions/SubmitPullReviewOptions" - }, - "name": "body", - "in": "body" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "200": { - "$ref": "#/responses/PullReview" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Submit a pending review to an pull request", - "operationId": "repoSubmitPullReview" - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a specific review from a pull request", - "operationId": "repoDeletePullReview", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "description": "id of the review", - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/collaborators": { - "get": { - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/UserList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repository's collaborators", - "operationId": "repoListCollaborators" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/wiki/pages": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get all wiki pages", - "operationId": "repoGetWikiPages", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WikiPageList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/comments": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "List all comments in a repository", - "operationId": "issueGetRepoComments", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "string", - "format": "date-time", - "description": "if provided, only comments updated since the provided time are returned.", - "name": "since", - "in": "query" - }, - { - "in": "query", - "type": "string", - "format": "date-time", - "description": "if provided, only comments updated before the provided time are returned.", - "name": "before" - }, - { - "name": "page", - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/CommentList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/pin": { - "post": { - "tags": [ - "issue" - ], - "summary": "Pin an Issue", - "operationId": "pinIssue", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "integer", - "format": "int64", - "description": "index of issue to pin", - "name": "index", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - } - } - }, - "delete": { - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "tags": [ - "issue" - ], - "summary": "Unpin an Issue", - "operationId": "unpinIssue", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of issue to unpin" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}/permission": { - "get": { - "operationId": "repoGetRepoPermissions", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "username of the collaborator whose permissions are to be obtained", - "name": "collaborator", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/RepoCollaboratorPermission" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get repository permissions for a user" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issue_config": { - "get": { - "operationId": "repoGetIssueConfig", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "200": { - "$ref": "#/responses/RepoIssueConfig" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Returns the issue config for a repo" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/topics": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get list of topics that a repository has", - "operationId": "repoListTopics", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TopicNames" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "put": { - "operationId": "repoUpdateTopics", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/RepoTopicOptions" - }, - "name": "body" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/invalidTopicsError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Replace list of topics for a repository" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases": { - "get": { - "tags": [ - "repository" - ], - "summary": "List a repo's releases", - "operationId": "repoListReleases", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "name": "draft", - "in": "query", - "type": "boolean", - "description": "filter (exclude / include) drafts, if you dont have repo write access none will show" - }, - { - "type": "boolean", - "description": "filter (exclude / include) pre-releases", - "name": "pre-release", - "in": "query" - }, - { - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page" - }, - { - "description": "page size of results", - "name": "limit", - "in": "query", - "type": "integer" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ReleaseList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - }, - "post": { - "summary": "Create a release", - "operationId": "repoCreateRelease", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "schema": { - "$ref": "#/definitions/CreateReleaseOption" - }, - "name": "body", - "in": "body" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Release" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/git/{id}": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get a Git hook", - "operationId": "repoGetGitHook", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "id of the hook to get", - "name": "id", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/GitHook" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a Git hook in a repository", - "operationId": "repoDeleteGitHook", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "string", - "description": "id of the hook to get" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "patch": { - "tags": [ - "repository" - ], - "summary": "Edit a Git hook in a repository", - "operationId": "repoEditGitHook", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "id of the hook to get", - "name": "id" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/EditGitHookOption" - }, - "name": "body" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/GitHook" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/start": { - "post": { - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "format": "int64", - "description": "index of the issue to create the stopwatch on", - "name": "index", - "in": "path", - "required": true, - "type": "integer" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "403": { - "description": "Not repo writer, user does not have rights to toggle stopwatch" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "description": "Cannot start a stopwatch again if it already exists" - }, - "201": { - "$ref": "#/responses/empty" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Start stopwatch on an issue.", - "operationId": "issueStartStopWatch" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/timeline": { - "get": { - "tags": [ - "issue" - ], - "summary": "List all comments and events on an issue", - "operationId": "issueGetCommentsAndTimeline", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "type": "string", - "format": "date-time", - "description": "if provided, only comments updated since the specified time are returned.", - "name": "since", - "in": "query" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "type": "string", - "format": "date-time", - "description": "if provided, only comments updated before the provided time are returned.", - "name": "before", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TimelineList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Check if a user is a collaborator of a repository", - "operationId": "repoCheckCollaborator", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "username of the user to check for being a collaborator", - "name": "collaborator", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "204": { - "$ref": "#/responses/empty" - } - } - }, - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Add or Update a collaborator to a repository", - "operationId": "repoAddCollaborator", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "collaborator", - "in": "path", - "required": true, - "type": "string", - "description": "username of the user to add or update as a collaborator" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/AddCollaboratorOption" - } - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - } - } - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a collaborator from a repository", - "operationId": "repoDeleteCollaborator", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "username of the collaborator to delete", - "name": "collaborator", - "in": "path", - "required": true - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks": { - "get": { - "summary": "List the hooks in a repository", - "operationId": "repoListHooks", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/HookList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - }, - "post": { - "tags": [ - "repository" - ], - "summary": "Create a hook", - "operationId": "repoCreateHook", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateHookOption" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Hook" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/merge-upstream": { - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Merge a branch from upstream", - "operationId": "repoMergeUpstream", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/MergeUpstreamRequest" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/MergeUpstreamResponse" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/contents/{filepath}": { - "post": { - "operationId": "repoCreateFile", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "path of the file to create", - "name": "filepath", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/CreateFileOptions" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/error" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/FileResponse" - }, - "403": { - "$ref": "#/responses/error" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a file in a repository" - }, - "delete": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a file in a repository", - "operationId": "repoDeleteFile", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "path of the file to delete", - "name": "filepath", - "in": "path", - "required": true - }, - { - "schema": { - "$ref": "#/definitions/DeleteFileOptions" - }, - "name": "body", - "in": "body", - "required": true - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "200": { - "$ref": "#/responses/FileDeleteResponse" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/error" - } - } - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir.", - "operationId": "repoGetContents", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "path of the dir, file, symlink or submodule in the repo", - "name": "filepath", - "in": "path" - }, - { - "type": "string", - "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", - "name": "ref", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ContentsResponse" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "description": "This API follows GitHub's design, and it is not easy to use. Recommend users to use the \"contents-ext\" API instead." - }, - "put": { - "responses": { - "403": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/error" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "200": { - "$ref": "#/responses/FileResponse" - }, - "201": { - "$ref": "#/responses/FileResponse" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Update a file in a repository if SHA is set, or create the file if SHA is not set", - "operationId": "repoUpdateFile", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "path of the file to update", - "name": "filepath", - "in": "path", - "required": true - }, - { - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/UpdateFileOptions" - }, - "name": "body" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/branch_protections/priority": { - "post": { - "summary": "Update the priorities of branch protections for a repository.", - "operationId": "repoUpdateBranchProtectionPriories", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/UpdateBranchProtectionPriories" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}/jobs": { - "get": { - "tags": [ - "repository" - ], - "summary": "Lists all jobs for a workflow run", - "operationId": "listWorkflowRunJobs", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "run", - "in": "path", - "required": true, - "type": "integer", - "description": "runid of the workflow run" - }, - { - "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", - "name": "status", - "in": "query", - "type": "string" - }, - { - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/WorkflowJobsList" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/dismissals": { - "post": { - "tags": [ - "repository" - ], - "summary": "Dismiss a review for a pull request", - "operationId": "repoDismissPullReview", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the review" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/DismissPullReviewOptions" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/PullReview" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/disable": { - "put": { - "tags": [ - "repository" - ], - "summary": "Disable a workflow", - "operationId": "ActionsDisableWorkflow", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "id of the workflow", - "name": "workflow_id", - "in": "path", - "required": true - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "204": { - "description": "No Content" - }, - "400": { - "$ref": "#/responses/error" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/requested_reviewers": { - "post": { - "operationId": "repoCreatePullReviewRequests", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/PullReviewRequestOptions" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "201": { - "$ref": "#/responses/PullReviewList" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "create review requests for a pull request" - }, - "delete": { - "summary": "cancel review requests for a pull request", - "operationId": "repoDeletePullReviewRequests", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/PullReviewRequestOptions" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the hook to get", - "name": "id", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Hook" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a hook", - "operationId": "repoGetHook" - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a hook in a repository", - "operationId": "repoDeleteHook", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the hook to delete" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "patch": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Edit a hook in a repository", - "operationId": "repoEditHook", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the hook", - "name": "id", - "in": "path" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditHookOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Hook" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/media/{filepath}": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get a file or it's LFS object from a repository", - "operationId": "repoGetRawFileOrLFS", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "path of the file to get, it should be \"{ref}/{filepath}\". If there is no ref could be inferred, it will be treated as the default branch", - "name": "filepath", - "in": "path", - "required": true - }, - { - "description": "The name of the commit/branch/tag. Default to the repository’s default branch", - "name": "ref", - "in": "query", - "type": "string" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "description": "Returns raw file content.", - "schema": { - "type": "file" } } - }, - "produces": [ - "application/octet-stream" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/update": { - "post": { - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request to get", - "name": "index" - }, - { - "enum": [ - "merge", - "rebase" - ], - "type": "string", - "description": "how to update pull request", - "name": "style", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Merge PR's baseBranch into headBranch", - "operationId": "repoUpdatePullRequest" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/times": { - "post": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Add tracked time to a issue", - "operationId": "issueAddTime", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/AddTimeOption" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/TrackedTime" - }, - "400": { - "$ref": "#/responses/error" - } } - }, - "delete": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Reset a tracked time of an issue", - "operationId": "issueResetTime", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "description": "index of the issue to add tracked time to", - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - } - }, - "get": { - "summary": "List an issue's tracked times", - "operationId": "issueTrackedTimes", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "type": "string", - "description": "optional filter by user (available for issue managers)", - "name": "user", - "in": "query" - }, - { - "type": "string", - "format": "date-time", - "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format", - "name": "since", - "in": "query" - }, - { - "name": "before", - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only show times updated before the given time. This is a timestamp in RFC 3339 format" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TrackedTimeList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/push_mirrors/{name}": { - "get": { - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/PushMirror" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get push mirror of the repository by remoteName", - "operationId": "repoGetPushMirrorByRemoteName", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "name", - "in": "path", - "required": true, - "type": "string", - "description": "remote name of push mirror" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - }, - "delete": { - "operationId": "repoDeletePushMirror", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "remote name of the pushMirror", - "name": "name", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "deletes a push mirror from a repository by remoteName" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews": { - "get": { - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", - "in": "path" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/PullReviewList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List all reviews for a pull request", - "operationId": "repoListPullReviews" - }, - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/CreatePullReviewOptions" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "200": { - "$ref": "#/responses/PullReview" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a review to an pull request", - "operationId": "repoCreatePullReview" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts/{artifact_id}": { - "get": { - "operationId": "getArtifact", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path" - }, - { - "required": true, - "type": "string", - "description": "id of the artifact", - "name": "artifact_id", - "in": "path" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/Artifact" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets a specific artifact for a workflow run" - }, - "delete": { - "summary": "Deletes a specific artifact for a workflow run", - "operationId": "deleteArtifact", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "id of the artifact", - "name": "artifact_id", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "204": { - "description": "No Content" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runners/registration-token": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get a repository's actions runner registration token", - "operationId": "repoGetRunnerRegistrationToken", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/RegistrationToken" - } - }, - "produces": [ - "application/json" - ] - }, - "post": { - "tags": [ - "repository" - ], - "summary": "Get a repository's actions runner registration token", - "operationId": "repoCreateRunnerRegistrationToken", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/RegistrationToken" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/tags": { - "get": { - "tags": [ - "repository" - ], - "summary": "List a repository's tags", - "operationId": "repoListTags", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" - }, - { - "type": "integer", - "description": "page size of results, default maximum page size is 50", - "name": "limit", - "in": "query" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TagList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - }, - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "schema": { - "$ref": "#/definitions/CreateTagOption" - }, - "name": "body", - "in": "body" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Tag" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "405": { - "$ref": "#/responses/empty" - }, - "409": { - "$ref": "#/responses/conflict" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a new git tag in a repository", - "operationId": "repoCreateTag" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/reactions": { - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the comment to edit", - "name": "id", - "in": "path", - "required": true - }, - { - "schema": { - "$ref": "#/definitions/EditReactionOption" - }, - "name": "content", - "in": "body" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Reaction" - }, - "201": { - "$ref": "#/responses/Reaction" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Add a reaction to a comment of an issue", - "operationId": "issuePostCommentReaction" - }, - "delete": { - "summary": "Remove a reaction from a comment of an issue", - "operationId": "issueDeleteCommentReaction", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the comment to edit", - "name": "id" - }, - { - "schema": { - "$ref": "#/definitions/EditReactionOption" - }, - "name": "content", - "in": "body" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get a list of reactions from a comment of an issue", - "operationId": "issueGetCommentReactions", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the comment to edit" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ReactionList" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/times": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/TrackedTimeList" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repo's tracked times", - "operationId": "repoTrackedTimes", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "optional filter by user (available for issue managers)", - "name": "user", - "in": "query" - }, - { - "name": "since", - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format" - }, - { - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only show times updated before the given time. This is a timestamp in RFC 3339 format", - "name": "before" - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/jobs/{job_id}/logs": { - "get": { - "tags": [ - "repository" - ], - "summary": "Downloads the job logs for a workflow run", - "operationId": "downloadActionsRunJobLogs", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path" - }, - { - "type": "integer", - "description": "id of the job", - "name": "job_id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "description": "output blob content" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/jobs/{job_id}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets a specific workflow job for a workflow run", - "operationId": "getWorkflowJob", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "id of the job", - "name": "job_id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/WorkflowJob" - }, - "400": { - "$ref": "#/responses/error" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/keys/{id}": { - "get": { - "operationId": "repoGetKey", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the key to get" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/DeployKey" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a repository's key by id" - }, - "delete": { - "tags": [ - "repository" - ], - "summary": "Delete a key from a repository", - "operationId": "repoDeleteKey", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the key to delete", - "name": "id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/assets/{attachment_id}": { - "get": { - "tags": [ - "issue" - ], - "summary": "Get an issue attachment", - "operationId": "issueGetIssueAttachment", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "id of the attachment to get", - "name": "attachment_id", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Attachment" - }, - "404": { - "$ref": "#/responses/error" - } - }, - "produces": [ - "application/json" - ] - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Delete an issue attachment", - "operationId": "issueDeleteIssueAttachment", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "format": "int64", - "description": "id of the attachment to delete", - "name": "attachment_id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/error" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - } - }, - "patch": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Edit an issue attachment", - "operationId": "issueEditIssueAttachment", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "name": "attachment_id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the attachment to edit" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditAttachmentOptions" - } - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Attachment" - }, - "404": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ] } }, "/repos/{owner}/group/{group_id}/{repo}/push_mirrors-sync": { @@ -11601,6 +8286,46 @@ "in": "path", "required": true }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts/{artifact_id}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Gets a specific artifact for a workflow run", + "operationId": "getArtifact", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "id of the artifact", + "name": "artifact_id" + }, { "required": true, "in": "path", @@ -11609,26 +8334,2103 @@ "type": "integer", "format": "int64" } + ], + "responses": { + "200": { + "$ref": "#/responses/Artifact" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "summary": "Deletes a specific artifact for a workflow run", + "operationId": "deleteArtifact", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "id of the artifact", + "name": "artifact_id" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "204": { + "description": "No Content" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" ] } }, - "/repos/{owner}/group/{group_id}/{repo}/transfer/reject": { + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/stop": { "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Stop an issue's existing stopwatch.", + "operationId": "issueStopStopWatch", "parameters": [ { - "description": "owner of the repo to transfer", + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue to stop the stopwatch on" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "$ref": "#/responses/empty" + }, + "403": { + "description": "Not repo writer, user does not have rights to toggle stopwatch" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "description": "Cannot stop a non-existent stopwatch" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/mirror-sync": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Sync a mirrored repository", + "operationId": "repoMirrorSync", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo to sync", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo to sync", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tags": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's tags", + "operationId": "repoListTags", + "parameters": [ + { + "description": "owner of the repo", "name": "owner", "in": "path", "required": true, "type": "string" }, { + "in": "path", "required": true, "type": "string", - "description": "name of the repo to transfer", + "description": "name of the repo", + "name": "repo" + }, + { + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query", + "type": "integer" + }, + { + "type": "integer", + "description": "page size of results, default maximum page size is 50", + "name": "limit", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TagList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "summary": "Create a new git tag in a repository", + "operationId": "repoCreateTag", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/CreateTagOption" + }, + "name": "body" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "200": { + "$ref": "#/responses/Tag" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "405": { + "$ref": "#/responses/empty" + }, + "409": { + "$ref": "#/responses/conflict" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a specific review for a pull request", + "operationId": "repoGetPullReview", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the review", + "name": "id", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullReview" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Submit a pending review to an pull request", + "operationId": "repoSubmitPullReview", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index" + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the review" + }, + { + "required": true, + "schema": { + "$ref": "#/definitions/SubmitPullReviewOptions" + }, + "name": "body", + "in": "body" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullReview" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + }, + "delete": { + "operationId": "repoDeletePullReview", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "description": "id of the review", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a specific review from a pull request" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/comments": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the review", + "name": "id" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullReviewCommentList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a specific review for a pull request", + "operationId": "repoGetPullReviewComments" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/signing-key.gpg": { + "get": { + "produces": [ + "text/plain" + ], + "tags": [ + "repository" + ], + "summary": "Get signing-key.gpg for given repository", + "operationId": "repoSigningKey", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "description": "GPG armored public key", + "schema": { + "type": "string" + } + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/keys/{id}": { + "get": { + "summary": "Get a repository's key by id", + "operationId": "repoGetKey", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "description": "id of the key to get", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/DeployKey" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "summary": "Delete a key from a repository", + "operationId": "repoDeleteKey", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the key to delete", + "name": "id", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/refs": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get specified ref or filtered repository's refs", + "operationId": "repoListAllGitRefs", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ReferenceList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/check": { + "get": { + "operationId": "issueCheckSubscription", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", "name": "repo", "in": "path" }, + { + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WatchInfo" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Check if user is subscribed to an issue" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/commits/{ref}/statuses": { + "get": { + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of branch/tag/commit", + "name": "ref", + "in": "path", + "required": true + }, + { + "name": "sort", + "in": "query", + "enum": [ + "oldest", + "recentupdate", + "leastupdate", + "leastindex", + "highestindex" + ], + "type": "string", + "description": "type of sort" + }, + { + "name": "state", + "in": "query", + "enum": [ + "pending", + "success", + "error", + "failure", + "warning" + ], + "type": "string", + "description": "type of state" + }, + { + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query", + "type": "integer" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/CommitStatusList" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a commit's statuses, by branch/tag/commit reference", + "operationId": "repoListStatusesByRef" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/merge": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "404": { + "description": "pull request has not been merged" + }, + "204": { + "description": "pull request has been merged" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Check if a pull request has been merged", + "operationId": "repoPullRequestIsMerged" + }, + "post": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request to merge", + "name": "index", + "in": "path" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/MergePullRequestOption" + }, + "name": "body" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "200": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "405": { + "$ref": "#/responses/empty" + }, + "409": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Merge a pull request", + "operationId": "repoMergePullRequest" + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Cancel the scheduled auto merge for the given pull request", + "operationId": "repoCancelScheduledAutoMerge", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request to merge", + "name": "index", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "204": { + "$ref": "#/responses/empty" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls": { + "get": { + "operationId": "repoListPullRequests", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "Name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "Filter by target base branch of the pull request", + "name": "base_branch", + "in": "query" + }, + { + "enum": [ + "open", + "closed", + "all" + ], + "type": "string", + "default": "open", + "description": "State of pull request", + "name": "state", + "in": "query" + }, + { + "enum": [ + "oldest", + "recentupdate", + "recentclose", + "leastupdate", + "mostcomment", + "leastcomment", + "priority" + ], + "type": "string", + "description": "Type of sort", + "name": "sort", + "in": "query" + }, + { + "type": "integer", + "format": "int64", + "description": "ID of the milestone", + "name": "milestone", + "in": "query" + }, + { + "type": "array", + "items": { + "type": "integer", + "format": "int64" + }, + "collectionFormat": "multi", + "description": "Label IDs", + "name": "labels", + "in": "query" + }, + { + "type": "string", + "description": "Filter by pull request author", + "name": "poster", + "in": "query" + }, + { + "minimum": 1, + "type": "integer", + "default": 1, + "description": "Page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "minimum": 0, + "type": "integer", + "description": "Page size of results", + "name": "limit", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "500": { + "$ref": "#/responses/error" + }, + "200": { + "$ref": "#/responses/PullRequestList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's pull requests" + }, + "post": { + "summary": "Create a pull request", + "operationId": "repoCreatePullRequest", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreatePullRequestOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/PullRequest" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runs": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Lists all runs for a repository run", + "operationId": "getWorkflowRuns", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "workflow event name", + "name": "event", + "in": "query" + }, + { + "name": "branch", + "in": "query", + "type": "string", + "description": "workflow branch" + }, + { + "type": "string", + "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", + "name": "status", + "in": "query" + }, + { + "description": "triggered by user", + "name": "actor", + "in": "query", + "type": "string" + }, + { + "description": "triggering sha of the workflow run", + "name": "head_sha", + "in": "query", + "type": "string" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WorkflowRunsList" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/new_pin_allowed": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Returns if new Issue Pins are allowed", + "operationId": "repoNewPinAllowed", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/RepoNewIssuePinsAllowed" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's releases", + "operationId": "repoListReleases", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "filter (exclude / include) drafts, if you dont have repo write access none will show", + "name": "draft", + "in": "query", + "type": "boolean" + }, + { + "name": "pre-release", + "in": "query", + "type": "boolean", + "description": "filter (exclude / include) pre-releases" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "name": "limit", + "in": "query", + "type": "integer", + "description": "page size of results" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ReleaseList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "responses": { + "201": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a release", + "operationId": "repoCreateRelease", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateReleaseOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/compare/{basehead}": { + "get": { + "summary": "Get commit comparison information", + "operationId": "repoCompareDiff", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "string", + "description": "compare two branches or commits", + "name": "basehead", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Compare" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}.{diffType}": { + "get": { + "produces": [ + "text/plain" + ], + "tags": [ + "repository" + ], + "summary": "Get a pull request diff or patch", + "operationId": "repoDownloadPullDiffOrPatch", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request to get", + "name": "index" + }, + { + "name": "diffType", + "in": "path", + "required": true, + "enum": [ + "diff", + "patch" + ], + "type": "string", + "description": "whether the output is diff or patch" + }, + { + "type": "boolean", + "description": "whether to include binary file changes. if true, the diff is applicable with `git apply`", + "name": "binary", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/string" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tags/{tag}": { + "get": { + "summary": "Get the tag of a repository by tag name", + "operationId": "repoGetTag", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of tag", + "name": "tag", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Tag" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of tag to delete", + "name": "tag", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "405": { + "$ref": "#/responses/empty" + }, + "409": { + "$ref": "#/responses/conflict" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "204": { + "$ref": "#/responses/empty" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a repository's tag by name", + "operationId": "repoDeleteTag" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/subscription": { + "put": { + "summary": "Watch a repo", + "operationId": "userCurrentPutSubscription", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WatchInfo" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "repository" + ] + }, + "delete": { + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "repository" + ], + "summary": "Unwatch a repo", + "operationId": "userCurrentDeleteSubscription" + }, + "get": { + "tags": [ + "repository" + ], + "summary": "Check if the current user is watching a repo", + "operationId": "userCurrentCheckSubscription", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WatchInfo" + }, + "404": { + "description": "User is not watching this repo or repo do not exist" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/hooks": { + "post": { + "operationId": "repoCreateHook", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "schema": { + "$ref": "#/definitions/CreateHookOption" + }, + "name": "body", + "in": "body" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Hook" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a hook" + }, + "get": { + "operationId": "repoListHooks", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/HookList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List the hooks in a repository" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{base}/{head}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get a pull request by base and head", + "operationId": "repoGetPullRequestByBaseHead", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "string", + "description": "base of the pull request to get", + "name": "base", + "in": "path", + "required": true + }, + { + "description": "head of the pull request to get", + "name": "head", + "in": "path", + "required": true, + "type": "string" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullRequest" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issue_templates": { + "get": { + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/IssueTemplates" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get available issue templates for a repository", + "operationId": "repoGetIssueTemplates" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}": { + "get": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a comment", + "operationId": "issueGetComment", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "id of the comment", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, { "description": "group ID of the repo", "name": "group_id", @@ -11646,7 +10448,448 @@ "$ref": "#/responses/notFound" }, "200": { - "$ref": "#/responses/Repository" + "$ref": "#/responses/Comment" + }, + "204": { + "$ref": "#/responses/empty" + } + } + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Delete a comment", + "operationId": "issueDeleteComment", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of comment to delete" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "patch": { + "summary": "Edit a comment", + "operationId": "issueEditComment", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "description": "id of the comment to edit", + "name": "id", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditIssueCommentOption" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "200": { + "$ref": "#/responses/Comment" + }, + "204": { + "$ref": "#/responses/empty" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/blocks": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List issues that are blocked by this issue", + "operationId": "issueListBlocks", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/IssueList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "summary": "Block the issue given in the body by the issue in path", + "operationId": "issueCreateIssueBlocking", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "string", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/IssueMeta" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Issue" + }, + "404": { + "description": "the issue does not exist" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + }, + "delete": { + "responses": { + "200": { + "$ref": "#/responses/Issue" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Unblock the issue given in the body by the issue in path", + "operationId": "issueRemoveIssueBlocking", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "string", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/IssueMeta" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/statuses/{sha}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a commit's statuses", + "operationId": "repoListStatuses", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "sha of the commit", + "name": "sha", + "in": "path" + }, + { + "enum": [ + "oldest", + "recentupdate", + "leastupdate", + "leastindex", + "highestindex" + ], + "type": "string", + "description": "type of sort", + "name": "sort", + "in": "query" + }, + { + "in": "query", + "enum": [ + "pending", + "success", + "error", + "failure", + "warning" + ], + "type": "string", + "description": "type of state", + "name": "state" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/CommitStatusList" + }, + "400": { + "$ref": "#/responses/error" + } + } + }, + "post": { + "operationId": "repoCreateStatus", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "string", + "description": "sha of the commit", + "name": "sha", + "in": "path" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateStatusOption" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "201": { + "$ref": "#/responses/CommitStatus" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" } }, "produces": [ @@ -11655,17 +10898,16 @@ "tags": [ "repository" ], - "summary": "Reject a repo transfer", - "operationId": "rejectRepoTransfer" + "summary": "Create a commit status" } }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/files": { - "get": { + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/disable": { + "put": { "tags": [ "repository" ], - "summary": "Get changed files for a pull request", - "operationId": "repoGetPullRequestFiles", + "summary": "Disable a workflow", + "operationId": "ActionsDisableWorkflow", "parameters": [ { "name": "owner", @@ -11681,31 +10923,134 @@ "in": "path", "required": true }, + { + "type": "string", + "description": "id of the workflow", + "name": "workflow_id", + "in": "path", + "required": true + }, { "format": "int64", - "description": "index of the pull request to get", - "name": "index", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "description": "No Content" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/forks": { + "post": { + "parameters": [ + { "in": "path", "required": true, - "type": "integer" + "type": "string", + "description": "owner of the repo to fork", + "name": "owner" }, { "type": "string", - "description": "skip to given file", - "name": "skip-to", - "in": "query" + "description": "name of the repo to fork", + "name": "repo", + "in": "path", + "required": true }, { - "in": "query", - "enum": [ - "ignore-all", - "ignore-change", - "ignore-eol", - "show-all" - ], + "in": "body", + "schema": { + "$ref": "#/definitions/CreateForkOption" + }, + "name": "body" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "202": { + "$ref": "#/responses/Repository" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "description": "The repository with the same name already exists." + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Fork a repository", + "operationId": "createFork" + }, + "get": { + "responses": { + "200": { + "$ref": "#/responses/RepositoryList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's forks", + "operationId": "listForks", + "parameters": [ + { "type": "string", - "description": "whitespace behavior", - "name": "whitespace" + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" }, { "type": "integer", @@ -11714,10 +11059,466 @@ "in": "query" }, { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/tags/{tag}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get a release by tag name", + "operationId": "repoGetReleaseByTag", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "tag name of the release to get", + "name": "tag", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a release by tag name", + "operationId": "repoDeleteReleaseByTag", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "tag name of the release to delete", + "name": "tag", + "in": "path" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/editorconfig/{filepath}": { + "get": { + "summary": "Get the EditorConfig definitions of a file in a repository", + "operationId": "repoGetEditorConfig", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "filepath", + "in": "path", + "required": true, + "type": "string", + "description": "filepath of file to get" + }, + { + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch.", + "name": "ref", + "in": "query" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "description": "success" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/times/{id}": { + "delete": { + "tags": [ + "issue" + ], + "summary": "Delete specific tracked time", + "operationId": "issueDeleteTime", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of time to delete", + "name": "id", + "in": "path", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + }, + "400": { + "$ref": "#/responses/error" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets/{attachment_id}": { + "get": { + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "format": "int64", + "description": "id of the release", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "description": "id of the attachment to get", + "name": "attachment_id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a release attachment", + "operationId": "repoGetReleaseAttachment" + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a release attachment", + "operationId": "repoDeleteReleaseAttachment", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the release" + }, + { + "description": "id of the attachment to delete", + "name": "attachment_id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + } + } + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Edit a release attachment", + "operationId": "repoEditReleaseAttachment", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "description": "id of the release", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the attachment to edit", + "name": "attachment_id" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditAttachmentOptions" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/pages": { + "get": { + "operationId": "repoGetWikiPages", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", "description": "page size of results", "name": "limit", - "in": "query", - "type": "integer" + "in": "query" }, { "description": "group ID of the repo", @@ -11730,7 +11531,121 @@ ], "responses": { "200": { - "$ref": "#/responses/ChangedFileList" + "$ref": "#/responses/WikiPageList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get all wiki pages" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/labels/{id}": { + "delete": { + "tags": [ + "issue" + ], + "summary": "Remove a label from an issue", + "operationId": "issueRemoveLabel", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the label to remove", + "name": "id", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get a repository", + "operationId": "repoGet", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Repository" }, "404": { "$ref": "#/responses/notFound" @@ -11739,9 +11654,2010 @@ "produces": [ "application/json" ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a repository", + "operationId": "repoDelete", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo to delete", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo to delete", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "patch": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Edit a repository's properties. Only fields that are set will be changed.", + "operationId": "repoEdit", + "parameters": [ + { + "description": "owner of the repo to edit", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo to edit", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "Properties of a repo that you can edit", + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditRepoOption" + } + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/Repository" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } } }, - "/repos/{owner}/group/{group_id}/{repo}/diffpatch": { + "/repos/{owner}/group/{group_id}/{repo}/issue_config": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Returns the issue config for a repo", + "operationId": "repoGetIssueConfig", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RepoIssueConfig" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List all reviews for a pull request", + "operationId": "repoListPullReviews", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "page", + "in": "query", + "type": "integer", + "description": "page number of results to return (1-based)" + }, + { + "description": "page size of results", + "name": "limit", + "in": "query", + "type": "integer" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullReviewList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a review to an pull request", + "operationId": "repoCreatePullReview", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/CreatePullReviewOptions" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/PullReview" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/pinned": { + "get": { + "operationId": "repoListPinnedPullRequests", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullRequestList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's pinned pull requests" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/secrets/{secretname}": { + "put": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create or Update a secret value in a repository", + "operationId": "updateRepoSecret", + "parameters": [ + { + "type": "string", + "description": "owner of the repository", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "name of the secret", + "name": "secretname", + "in": "path", + "required": true, + "type": "string" + }, + { + "schema": { + "$ref": "#/definitions/CreateOrUpdateSecretOption" + }, + "name": "body", + "in": "body" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "description": "response when creating a secret" + }, + "204": { + "description": "response when updating a secret" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a secret in a repository", + "operationId": "deleteRepoSecret", + "parameters": [ + { + "type": "string", + "description": "owner of the repository", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repository" + }, + { + "description": "name of the secret", + "name": "secretname", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "204": { + "description": "delete one secret of the repository" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tag_protections": { + "get": { + "operationId": "repoListTagProtection", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TagProtectionList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List tag protections for a repository" + }, + "post": { + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/CreateTagProtectionOption" + }, + "name": "body" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/TagProtection" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a tag protections for a repository", + "operationId": "repoCreateTagProtection" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/times": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List an issue's tracked times", + "operationId": "issueTrackedTimes", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "description": "optional filter by user (available for issue managers)", + "name": "user", + "in": "query", + "type": "string" + }, + { + "name": "since", + "in": "query", + "type": "string", + "format": "date-time", + "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format" + }, + { + "description": "Only show times updated before the given time. This is a timestamp in RFC 3339 format", + "name": "before", + "in": "query", + "type": "string", + "format": "date-time" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TrackedTimeList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "responses": { + "200": { + "$ref": "#/responses/TrackedTime" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Add tracked time to a issue", + "operationId": "issueAddTime", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/AddTimeOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ] + }, + "delete": { + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue to add tracked time to", + "name": "index", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Reset a tracked time of an issue", + "operationId": "issueResetTime" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/transfer": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Transfer a repo ownership", + "operationId": "repoTransfer", + "parameters": [ + { + "type": "string", + "description": "owner of the repo to transfer", + "name": "owner", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "name of the repo to transfer", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "Transfer Options", + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/TransferRepoOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "202": { + "$ref": "#/responses/Repository" + }, + "403": { + "$ref": "#/responses/forbidden" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/deadline": { + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Set an issue deadline. If set to null, the deadline is deleted. If using deadline only the date will be taken into account, and time of day ignored.", + "operationId": "issueEditIssueDeadline", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue to create or update a deadline on", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditDeadlineOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "201": { + "$ref": "#/responses/IssueDeadline" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/avatar": { + "post": { + "summary": "Update avatar", + "operationId": "repoUpdateAvatar", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/UpdateRepoAvatarOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete avatar", + "operationId": "repoDeleteAvatar", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/topics/{topic}": { + "put": { + "operationId": "repoAddTopic", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "name of the topic to add", + "name": "topic", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "422": { + "$ref": "#/responses/invalidTopicsError" + }, + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Add a topic to a repository" + }, + "delete": { + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/invalidTopicsError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a topic from a repository", + "operationId": "repoDeleteTopic", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "description": "name of the topic to delete", + "name": "topic", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branches": { + "get": { + "summary": "List a repository's branches", + "operationId": "repoListBranches", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/BranchList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "post": { + "summary": "Create a branch", + "operationId": "repoCreateBranch", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateBranchRepoOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "409": { + "description": "The branch with the same name already exists." + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Branch" + }, + "403": { + "description": "The branch is archived or a mirror." + }, + "404": { + "description": "The old branch does not exist." + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/commits/{sha}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/Commit" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a single commit from a repository", + "operationId": "repoGetSingleCommit", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "sha", + "in": "path", + "required": true, + "type": "string", + "description": "a git ref or commit sha" + }, + { + "type": "boolean", + "description": "include diff stats for every commit (disable for speedup, default 'true')", + "name": "stat", + "in": "query" + }, + { + "type": "boolean", + "description": "include verification for every commit (disable for speedup, default 'true')", + "name": "verification", + "in": "query" + }, + { + "name": "files", + "in": "query", + "type": "boolean", + "description": "include a list of affected files for every commit (disable for speedup, default 'true')" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/transfer/reject": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Reject a repo transfer", + "operationId": "rejectRepoTransfer", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo to transfer", + "name": "owner", + "in": "path" + }, + { + "type": "string", + "description": "name of the repo to transfer", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Repository" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/reactions": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "format": "int64", + "description": "id of the comment to edit", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ReactionList" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a list of reactions from a comment of an issue", + "operationId": "issueGetCommentReactions" + }, + "post": { + "responses": { + "200": { + "$ref": "#/responses/Reaction" + }, + "201": { + "$ref": "#/responses/Reaction" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Add a reaction to a comment of an issue", + "operationId": "issuePostCommentReaction", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the comment to edit", + "name": "id" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/EditReactionOption" + }, + "name": "content" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Remove a reaction from a comment of an issue", + "operationId": "issueDeleteCommentReaction", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "integer", + "format": "int64", + "description": "id of the comment to edit", + "name": "id", + "in": "path", + "required": true + }, + { + "name": "content", + "in": "body", + "schema": { + "$ref": "#/definitions/EditReactionOption" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts/{artifact_id}/zip": { + "get": { + "operationId": "downloadArtifact", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "id of the artifact", + "name": "artifact_id", + "in": "path", + "required": true + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "302": { + "description": "redirect to the blob download" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Downloads a specific artifact for a workflow run redirects to blob url" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runners/registration-token": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RegistrationToken" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a repository's actions runner registration token", + "operationId": "repoGetRunnerRegistrationToken" + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a repository's actions runner registration token", + "operationId": "repoCreateRunnerRegistrationToken", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RegistrationToken" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/assets/{attachment_id}": { + "get": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "description": "id of the comment", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the attachment to get", + "name": "attachment_id" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a comment attachment", + "operationId": "issueGetIssueCommentAttachment" + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Delete a comment attachment", + "operationId": "issueDeleteIssueCommentAttachment", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "description": "id of the comment", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "type": "integer", + "format": "int64", + "description": "id of the attachment to delete", + "name": "attachment_id", + "in": "path", + "required": true + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "produces": [ + "application/json" + ] + }, + "patch": { + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the comment", + "name": "id", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the attachment to edit", + "name": "attachment_id", + "in": "path", + "required": true + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/EditAttachmentOptions" + }, + "name": "body" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Edit a comment attachment", + "operationId": "issueEditIssueCommentAttachment" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/stargazers": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's stargazers", + "operationId": "repoListStargazers", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "in": "query", + "type": "integer", + "description": "page size of results", + "name": "limit" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/UserList" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/keys": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's keys", + "operationId": "repoListKeys", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "integer", + "description": "the key_id to search for", + "name": "key_id", + "in": "query" + }, + { + "name": "fingerprint", + "in": "query", + "type": "string", + "description": "fingerprint of the key" + }, + { + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query", + "type": "integer" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/DeployKeyList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "tags": [ + "repository" + ], + "summary": "Add a key to a repository", + "operationId": "repoCreateKey", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateKeyOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "201": { + "$ref": "#/responses/DeployKey" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/pin": { "post": { "parameters": [ { @@ -11759,20 +13675,175 @@ "required": true }, { - "in": "body", "required": true, - "schema": { - "$ref": "#/definitions/ApplyDiffPatchFileOptions" - }, - "name": "body" + "type": "integer", + "format": "int64", + "description": "index of issue to pin", + "name": "index", + "in": "path" }, { + "name": "group_id", "type": "integer", "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "tags": [ + "issue" + ], + "summary": "Pin an Issue", + "operationId": "pinIssue" + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Unpin an Issue", + "operationId": "unpinIssue", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of issue to unpin", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/archive/{archive}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get an archive of a repository", + "operationId": "repoGetArchive", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "the git reference for download with attached archive format (e.g. master.zip)", + "name": "archive", + "in": "path", + "required": true + }, + { "required": true, "in": "path", "description": "group ID of the repo", - "name": "group_id" + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "description": "success" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/diffpatch": { + "post": { + "summary": "Apply diff patch to repository", + "operationId": "repoApplyDiffPatch", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "required": true, + "schema": { + "$ref": "#/definitions/ApplyDiffPatchFileOptions" + }, + "name": "body", + "in": "body" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true } ], "responses": { @@ -11794,700 +13865,11 @@ ], "tags": [ "repository" - ], - "summary": "Apply diff patch to repository", - "operationId": "repoApplyDiffPatch" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts/{artifact_id}/zip": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Downloads a specific artifact for a workflow run redirects to blob url", - "operationId": "downloadArtifact", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "artifact_id", - "in": "path", - "required": true, - "type": "string", - "description": "id of the artifact" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "302": { - "description": "redirect to the blob download" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/labels": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get all of a repository's labels", - "operationId": "issueListLabels", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query", - "type": "integer" - }, - { - "name": "limit", - "in": "query", - "type": "integer", - "description": "page size of results" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/LabelList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "summary": "Create a label", - "operationId": "issueCreateLabel", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateLabelOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "422": { - "$ref": "#/responses/validationError" - }, - "201": { - "$ref": "#/responses/Label" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/commits": { - "get": { - "summary": "Get a list of all commits from a repository", - "operationId": "repoGetAllCommits", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "type": "string", - "description": "SHA or branch to start listing commits from (usually 'master')", - "name": "sha", - "in": "query" - }, - { - "in": "query", - "type": "string", - "description": "filepath of a file/dir", - "name": "path" - }, - { - "type": "string", - "format": "date-time", - "description": "Only commits after this date will be returned (ISO 8601 format)", - "name": "since", - "in": "query" - }, - { - "name": "until", - "in": "query", - "type": "string", - "format": "date-time", - "description": "Only commits before this date will be returned (ISO 8601 format)" - }, - { - "in": "query", - "type": "boolean", - "description": "include diff stats for every commit (disable for speedup, default 'true')", - "name": "stat" - }, - { - "name": "verification", - "in": "query", - "type": "boolean", - "description": "include verification for every commit (disable for speedup, default 'true')" - }, - { - "description": "include a list of affected files for every commit (disable for speedup, default 'true')", - "name": "files", - "in": "query", - "type": "boolean" - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results (ignored if used with 'path')", - "name": "limit", - "in": "query" - }, - { - "type": "string", - "description": "commits that match the given specifier will not be listed.", - "name": "not", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/CommitList" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "$ref": "#/responses/EmptyRepository" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/variables/{variablename}": { - "get": { - "operationId": "getRepoVariable", - "parameters": [ - { - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path" - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "variablename", - "in": "path", - "required": true, - "type": "string", - "description": "name of the variable" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ActionVariable" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a repo-level variable" - }, - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Update a repo-level variable", - "operationId": "updateRepoVariable", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo" - }, - { - "type": "string", - "description": "name of the variable", - "name": "variablename", - "in": "path", - "required": true - }, - { - "schema": { - "$ref": "#/definitions/UpdateVariableOption" - }, - "name": "body", - "in": "body" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "201": { - "description": "response when updating a repo-level variable" - }, - "204": { - "description": "response when updating a repo-level variable" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "operationId": "createRepoVariable", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path" - }, - { - "description": "name of the variable", - "name": "variablename", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/CreateVariableOption" - }, - "name": "body" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "409": { - "description": "variable name already exists." - }, - "500": { - "$ref": "#/responses/error" - }, - "201": { - "description": "response when creating a repo-level variable" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a repo-level variable" - }, - "delete": { - "tags": [ - "repository" - ], - "summary": "Delete a repo-level variable", - "operationId": "deleteRepoVariable", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repository", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the variable", - "name": "variablename", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/ActionVariable" - }, - "201": { - "description": "response when deleting a variable" - }, - "204": { - "description": "response when deleting a variable" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/workflows": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List repository workflows", - "operationId": "ActionsListRepositoryWorkflows", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/ActionWorkflowList" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "500": { - "$ref": "#/responses/error" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/git/tags/{sha}": { - "get": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path" - }, - { - "description": "sha of the tag. The Git tags API only supports annotated tag objects, not lightweight tags.", - "name": "sha", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/AnnotatedTag" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Gets the tag object of an annotated tag (not lightweight tags)", - "operationId": "GetAnnotatedTag" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/stargazers": { - "get": { - "tags": [ - "repository" - ], - "summary": "List a repo's stargazers", - "operationId": "repoListStargazers", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/UserList" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" ] } }, "/repos/{owner}/group/{group_id}/{repo}/activities/feeds": { "get": { - "responses": { - "200": { - "$ref": "#/responses/ActivityFeedsList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, "produces": [ "application/json" ], @@ -12525,39 +13907,41 @@ "in": "query" }, { - "type": "integer", - "description": "page size of results", "name": "limit", - "in": "query" + "in": "query", + "type": "integer", + "description": "page size of results" }, { - "description": "group ID of the repo", - "name": "group_id", "type": "integer", "format": "int64", "required": true, - "in": "path" + "in": "path", + "description": "group ID of the repo", + "name": "group_id" } - ] + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/ActivityFeedsList" + } + } } }, - "/repos/{owner}/group/{group_id}/{repo}/git/refs/{ref}": { + "/repos/{owner}/group/{group_id}/{repo}/hooks/git/{id}": { "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get specified ref or filtered repository's refs", - "operationId": "repoListGitRefs", + "summary": "Get a Git hook", + "operationId": "repoGetGitHook", "parameters": [ { - "type": "string", - "description": "owner of the repo", "name": "owner", "in": "path", - "required": true + "required": true, + "type": "string", + "description": "owner of the repo" }, { "type": "string", @@ -12567,45 +13951,206 @@ "required": true }, { - "type": "string", - "description": "part or full name of the ref", - "name": "ref", + "description": "id of the hook to get", + "name": "id", "in": "path", - "required": true + "required": true, + "type": "string" }, { - "required": true, - "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", - "format": "int64" + "format": "int64", + "required": true, + "in": "path" } ], "responses": { "200": { - "$ref": "#/responses/ReferenceList" + "$ref": "#/responses/GitHook" }, "404": { "$ref": "#/responses/notFound" } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/push_mirrors": { - "get": { + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "$ref": "#/responses/empty" + } + }, + "produces": [ + "application/json" + ], "tags": [ "repository" ], - "summary": "Get all push mirrors of the repository", - "operationId": "repoListPushMirrors", + "summary": "Delete a Git hook in a repository", + "operationId": "repoDeleteGitHook", "parameters": [ { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "id of the hook to get", + "name": "id", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + }, + "patch": { + "summary": "Edit a Git hook in a repository", + "operationId": "repoEditGitHook", + "parameters": [ + { + "in": "path", "required": true, "type": "string", "description": "owner of the repo", - "name": "owner", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "name": "id", + "in": "path", + "required": true, + "type": "string", + "description": "id of the hook to get" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditGitHookOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/GitHook" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/transfer/accept": { + "post": { + "summary": "Accept a repo transfer", + "operationId": "acceptRepoTransfer", + "parameters": [ + { + "type": "string", + "description": "owner of the repo to transfer", + "name": "owner", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo to transfer", + "name": "repo" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "202": { + "$ref": "#/responses/Repository" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/tasks": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's action tasks", + "operationId": "ListActionTasks", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true }, { "type": "string", @@ -12622,85 +14167,10 @@ }, { "type": "integer", - "description": "page size of results", + "description": "page size of results, default maximum page size is 50", "name": "limit", "in": "query" }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/PushMirrorList" - }, - "400": { - "$ref": "#/responses/error" - } - }, - "produces": [ - "application/json" - ] - }, - "post": { - "responses": { - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/PushMirror" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "add a push mirror to the repository", - "operationId": "repoAddPushMirror", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/CreatePushMirrorOption" - }, - "name": "body" - }, { "description": "group ID of the repo", "name": "group_id", @@ -12709,11 +14179,32 @@ "required": true, "in": "path" } - ] + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/conflict" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/TasksList" + } + } } }, - "/repos/{owner}/group/{group_id}/{repo}/pulls": { + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}": { "get": { + "operationId": "repoGetPullRequest", "parameters": [ { "description": "owner of the repo", @@ -12723,99 +14214,32 @@ "type": "string" }, { - "required": true, - "type": "string", - "description": "Name of the repo", + "description": "name of the repo", "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request to get", + "name": "index", "in": "path" }, { - "in": "query", - "type": "string", - "description": "Filter by target base branch of the pull request", - "name": "base_branch" - }, - { - "in": "query", - "enum": [ - "open", - "closed", - "all" - ], - "type": "string", - "default": "open", - "description": "State of pull request", - "name": "state" - }, - { - "in": "query", - "enum": [ - "oldest", - "recentupdate", - "recentclose", - "leastupdate", - "mostcomment", - "leastcomment", - "priority" - ], - "type": "string", - "description": "Type of sort", - "name": "sort" - }, - { - "description": "ID of the milestone", - "name": "milestone", - "in": "query", - "type": "integer", - "format": "int64" - }, - { - "name": "labels", - "in": "query", - "type": "array", - "items": { - "type": "integer", - "format": "int64" - }, - "collectionFormat": "multi", - "description": "Label IDs" - }, - { - "type": "string", - "description": "Filter by pull request author", - "name": "poster", - "in": "query" - }, - { - "name": "page", - "in": "query", - "minimum": 1, - "type": "integer", - "default": 1, - "description": "Page number of results to return (1-based)" - }, - { - "minimum": 0, - "type": "integer", - "description": "Page size of results", - "name": "limit", - "in": "query" - }, - { + "name": "group_id", "type": "integer", "format": "int64", "required": true, "in": "path", - "description": "group ID of the repo", - "name": "group_id" + "description": "group ID of the repo" } ], "responses": { - "500": { - "$ref": "#/responses/error" - }, "200": { - "$ref": "#/responses/PullRequestList" + "$ref": "#/responses/PullRequest" }, "404": { "$ref": "#/responses/notFound" @@ -12827,22 +14251,27 @@ "tags": [ "repository" ], - "summary": "List a repo's pull requests", - "operationId": "repoListPullRequests" + "summary": "Get a pull request" }, - "post": { + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], "tags": [ "repository" ], - "summary": "Create a pull request", - "operationId": "repoCreatePullRequest", + "summary": "Update a pull request. If using deadline only the date will be taken into account, and time of day ignored.", + "operationId": "repoEditPullRequest", "parameters": [ { + "description": "owner of the repo", + "name": "owner", "in": "path", "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" + "type": "string" }, { "name": "repo", @@ -12851,29 +14280,34 @@ "type": "string", "description": "name of the repo" }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request to edit", + "name": "index", + "in": "path", + "required": true + }, { "name": "body", "in": "body", "schema": { - "$ref": "#/definitions/CreatePullRequestOption" + "$ref": "#/definitions/EditPullRequestOption" } }, { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", "format": "int64", "required": true, - "in": "path" + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" } ], "responses": { "422": { "$ref": "#/responses/validationError" }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, "201": { "$ref": "#/responses/PullRequest" }, @@ -12885,26 +14319,86 @@ }, "409": { "$ref": "#/responses/error" + }, + "412": { + "$ref": "#/responses/error" } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] + } } }, - "/repos/{owner}/group/{group_id}/{repo}/wiki/page/{pageName}": { - "get": { + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/update": { + "post": { "produces": [ "application/json" ], "tags": [ "repository" ], - "summary": "Get a wiki page", - "operationId": "repoGetWikiPage", + "summary": "Merge PR's baseBranch into headBranch", + "operationId": "repoUpdatePullRequest", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request to get", + "name": "index" + }, + { + "type": "string", + "description": "how to update pull request", + "name": "style", + "in": "query", + "enum": [ + "merge", + "rebase" + ] + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/milestones": { + "get": { "parameters": [ { "type": "string", @@ -12913,6 +14407,83 @@ "in": "path", "required": true }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "string", + "description": "Milestone state, Recognized values are open, closed and all. Defaults to \"open\"", + "name": "state", + "in": "query" + }, + { + "type": "string", + "description": "filter by milestone name", + "name": "name", + "in": "query" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/MilestoneList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get all of a repository's opened milestones", + "operationId": "issueGetMilestonesList" + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create a milestone", + "operationId": "issueCreateMilestone", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo" + }, { "description": "name of the repo", "name": "repo", @@ -12921,11 +14492,310 @@ "type": "string" }, { - "name": "pageName", + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateMilestoneOption" + } + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "201": { + "$ref": "#/responses/Milestone" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/contents-ext/{filepath}": { + "get": { + "parameters": [ + { "in": "path", "required": true, "type": "string", - "description": "name of the page" + "description": "owner of the repo", + "name": "owner" + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "path of the dir, file, symlink or submodule in the repo. Swagger requires path parameter to be \"required\", you can leave it empty or pass a single dot (\".\") to get the root directory.", + "name": "filepath", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "the name of the commit/branch/tag, default to the repository’s default branch.", + "name": "ref", + "in": "query" + }, + { + "description": "By default this API's response only contains file's metadata. Use comma-separated \"includes\" options to retrieve more fields. Option \"file_content\" will try to retrieve the file content, \"lfs_metadata\" will try to retrieve LFS metadata, \"commit_metadata\" will try to retrieve commit metadata, and \"commit_message\" will try to retrieve commit message.", + "name": "includes", + "in": "query", + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ContentsExtResponse" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "description": "It guarantees that only one of the response fields is set if the request succeeds. Users can pass \"includes=file_content\" or \"includes=lfs_metadata\" to retrieve more fields. \"includes=file_content\" only works for single file, if you need to retrieve file contents in batch, use \"file-contents\" API after listing the directory.", + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "The extended \"contents\" API, to get file metadata and/or content, or list a directory.", + "operationId": "repoGetContentsExt" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/timeline": { + "get": { + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "string", + "format": "date-time", + "description": "if provided, only comments updated since the specified time are returned.", + "name": "since", + "in": "query" + }, + { + "name": "page", + "in": "query", + "type": "integer", + "description": "page number of results to return (1-based)" + }, + { + "type": "integer", + "description": "page size of results", + "name": "limit", + "in": "query" + }, + { + "description": "if provided, only comments updated before the provided time are returned.", + "name": "before", + "in": "query", + "type": "string", + "format": "date-time" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TimelineList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List all comments and events on an issue", + "operationId": "issueGetCommentsAndTimeline" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/hooks/git": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List the Git hooks in a repository", + "operationId": "repoListGitHooks", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/GitHookList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/requested_reviewers": { + "post": { + "summary": "create review requests for a pull request", + "operationId": "repoCreatePullReviewRequests", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "schema": { + "$ref": "#/definitions/PullReviewRequestOptions" + }, + "name": "body", + "in": "body", + "required": true + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "201": { + "$ref": "#/responses/PullReviewList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request", + "name": "index", + "in": "path" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/PullReviewRequestOptions" + } }, { "name": "group_id", @@ -12937,112 +14807,8 @@ } ], "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/WikiPage" - } - } - }, - "delete": { - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, "204": { "$ref": "#/responses/empty" - } - }, - "tags": [ - "repository" - ], - "summary": "Delete a wiki page", - "operationId": "repoDeleteWikiPage", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the page", - "name": "pageName" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ] - }, - "patch": { - "operationId": "repoEditWikiPage", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the page", - "name": "pageName", - "in": "path" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/CreateWikiPageOptions" - }, - "name": "body" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WikiPage" - }, - "400": { - "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" @@ -13050,282 +14816,8 @@ "404": { "$ref": "#/responses/notFound" }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Edit a wiki page" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/new_pin_allowed": { - "get": { - "summary": "Returns if new Issue Pins are allowed", - "operationId": "repoNewPinAllowed", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/RepoNewIssuePinsAllowed" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/milestones/{id}": { - "delete": { - "operationId": "issueDeleteMilestone", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "the milestone to delete, identified by ID and if not available by name", - "name": "id", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "tags": [ - "issue" - ], - "summary": "Delete a milestone" - }, - "patch": { - "tags": [ - "issue" - ], - "summary": "Update a milestone", - "operationId": "issueEditMilestone", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "description": "the milestone to edit, identified by ID and if not available by name", - "name": "id", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/EditMilestoneOption" - }, - "name": "body" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Milestone" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] - }, - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get a milestone", - "operationId": "issueGetMilestone", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "the milestone to get, identified by ID and if not available by name", - "name": "id", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Milestone" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/topics/{topic}": { - "put": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Add a topic to a repository", - "operationId": "repoAddTopic", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "topic", - "in": "path", - "required": true, - "type": "string", - "description": "name of the topic to add" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/invalidTopicsError" - }, - "204": { - "$ref": "#/responses/empty" - } - } - }, - "delete": { - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, "422": { - "$ref": "#/responses/invalidTopicsError" + "$ref": "#/responses/validationError" } }, "produces": [ @@ -13334,48 +14826,17 @@ "tags": [ "repository" ], - "summary": "Delete a topic from a repository", - "operationId": "repoDeleteTopic", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "name of the topic to delete", - "name": "topic", - "in": "path" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] + "summary": "cancel review requests for a pull request", + "operationId": "repoDeletePullReviewRequests" } }, - "/repos/{owner}/group/{group_id}/{repo}/teams": { + "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}/permission": { "get": { "tags": [ "repository" ], - "summary": "List a repository's teams", - "operationId": "repoListTeams", + "summary": "Get repository permissions for a user", + "operationId": "repoGetRepoPermissions", "parameters": [ { "type": "string", @@ -13384,247 +14845,6 @@ "in": "path", "required": true }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TeamList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/comments/{id}": { - "delete": { - "tags": [ - "issue" - ], - "summary": "Delete a comment", - "operationId": "issueDeleteCommentDeprecated", - "deprecated": true, - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "description": "this parameter is ignored" - }, - { - "type": "integer", - "format": "int64", - "description": "id of comment to delete", - "name": "id", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "patch": { - "consumes": [ - "application/json" - ], - "deprecated": true, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Edit a comment", - "operationId": "issueEditCommentDeprecated", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "description": "this parameter is ignored", - "name": "index", - "in": "path", - "required": true - }, - { - "format": "int64", - "description": "id of the comment to edit", - "name": "id", - "in": "path", - "required": true, - "type": "integer" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditIssueCommentOption" - } - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Comment" - }, - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/comments": { - "get": { - "operationId": "repoGetPullReviewComments", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request" - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "id of the review", - "name": "id" - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/responses/PullReviewCommentList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a specific review for a pull request" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/branch_protections": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List branch protections for a repository", - "operationId": "repoListBranchProtection", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, { "in": "path", "required": true, @@ -13633,43 +14853,11 @@ "name": "repo" }, { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/BranchProtectionList" - } - } - }, - "post": { - "operationId": "repoCreateBranchProtection", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", + "name": "collaborator", "in": "path", "required": true, "type": "string", - "description": "name of the repo" - }, - { - "in": "body", - "schema": { - "$ref": "#/definitions/CreateBranchProtectionOption" - }, - "name": "body" + "description": "username of the collaborator whose permissions are to be obtained" }, { "required": true, @@ -13681,97 +14869,23 @@ } ], "responses": { - "201": { - "$ref": "#/responses/BranchProtection" + "200": { + "$ref": "#/responses/RepoCollaboratorPermission" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" } }, - "consumes": [ - "application/json" - ], "produces": [ "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a branch protections for a repository" + ] } }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/assets": { + "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}/artifacts": { "get": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "List issue's attachments", - "operationId": "issueListIssueAttachments", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/AttachmentList" - }, - "404": { - "$ref": "#/responses/error" - } - } - }, - "post": { - "consumes": [ - "multipart/form-data" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Create an issue attachment", - "operationId": "issueCreateIssueAttachment", "parameters": [ { "type": "string", @@ -13780,247 +14894,6 @@ "in": "path", "required": true }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the attachment", - "name": "name", - "in": "query" - }, - { - "in": "formData", - "required": true, - "type": "file", - "description": "attachment to upload", - "name": "attachment" - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Attachment" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/error" - }, - "413": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/deadline": { - "post": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Set an issue deadline. If set to null, the deadline is deleted. If using deadline only the date will be taken into account, and time of day ignored.", - "operationId": "issueEditIssueDeadline", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue to create or update a deadline on" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditDeadlineOption" - } - }, - { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "201": { - "$ref": "#/responses/IssueDeadline" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/tag_protections": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List tag protections for a repository", - "operationId": "repoListTagProtection", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TagProtectionList" - } - } - }, - "post": { - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateTagProtectionOption" - } - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/TagProtection" - }, - "403": { - "$ref": "#/responses/forbidden" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Create a tag protections for a repository", - "operationId": "repoCreateTagProtection" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/variables": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get repo-level variables list", - "operationId": "getRepoVariablesList", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, { "type": "string", "description": "name of the repository", @@ -14029,16 +14902,126 @@ "required": true }, { + "required": true, "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", + "description": "runid of the workflow run", + "name": "run", + "in": "path" + }, + { + "type": "string", + "description": "name of the artifact", + "name": "name", "in": "query" }, { + "description": "group ID of the repo", + "name": "group_id", "type": "integer", - "description": "page size of results", - "name": "limit", - "in": "query" + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ArtifactsList" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Lists all artifacts for a repository run", + "operationId": "getArtifactsOfRun" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/assignees": { + "get": { + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/UserList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Return all users that have write access and can be assigned to issues", + "operationId": "repoGetAssignees", + "parameters": [ + { + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true + }, + { + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branch_protections/priority": { + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Update the priorities of branch protections for a repository.", + "operationId": "repoUpdateBranchProtectionPriories", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/UpdateBranchProtectionPriories" + } }, { "name": "group_id", @@ -14049,497 +15032,10 @@ "description": "group ID of the repo" } ], - "responses": { - "200": { - "$ref": "#/responses/VariableList" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/times/{user}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a user's tracked times in a repo", - "operationId": "userTrackedTimes", - "deprecated": true, - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "description": "username of the user whose tracked times are to be listed", - "name": "user", - "in": "path", - "required": true, - "type": "string" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "$ref": "#/responses/TrackedTimeList" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/blocks": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/IssueList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "List issues that are blocked by this issue", - "operationId": "issueListBlocks", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "page", - "in": "query", - "type": "integer", - "description": "page number of results to return (1-based)" - }, - { - "description": "page size of results", - "name": "limit", - "in": "query", - "type": "integer" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ] - }, - "post": { - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Block the issue given in the body by the issue in path", - "operationId": "issueCreateIssueBlocking", - "parameters": [ - { - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo", - "name": "repo" - }, - { - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/IssueMeta" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "201": { - "$ref": "#/responses/Issue" - }, - "404": { - "description": "the issue does not exist" - } - } - }, - "delete": { - "responses": { - "200": { - "$ref": "#/responses/Issue" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Unblock the issue given in the body by the issue in path", - "operationId": "issueRemoveIssueBlocking", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "index of the issue", - "name": "index", - "in": "path" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/IssueMeta" - } - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/licenses": { - "get": { - "summary": "Get repo licenses", - "operationId": "repoGetLicenses", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/LicensesList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/compare/{basehead}": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/Compare" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get commit comparison information", - "operationId": "repoCompareDiff", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "compare two branches or commits", - "name": "basehead", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/branch_protections/{name}": { - "get": { - "tags": [ - "repository" - ], - "summary": "Get a specific branch protection for the repository", - "operationId": "repoGetBranchProtection", - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of protected branch", - "name": "name" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/BranchProtection" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ] - }, - "delete": { - "operationId": "repoDeleteBranchProtection", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "type": "string", - "description": "name of protected branch", - "name": "name", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], "responses": { "204": { "$ref": "#/responses/empty" }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a specific branch protection for the repository" - }, - "patch": { - "tags": [ - "repository" - ], - "summary": "Edit a branch protections for a repository. Only fields that are set will be changed", - "operationId": "repoEditBranchProtection", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "name": "name", - "in": "path", - "required": true, - "type": "string", - "description": "name of protected branch" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/EditBranchProtectionOption" - } - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/BranchProtection" - }, "404": { "$ref": "#/responses/notFound" }, @@ -14549,504 +15045,8 @@ "423": { "$ref": "#/responses/repoArchivedError" } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/{user}": { - "put": { - "responses": { - "200": { - "description": "Already subscribed" - }, - "201": { - "description": "Successfully Subscribed" - }, - "304": { - "description": "User can only subscribe itself if he is no admin" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Subscribe user to issue", - "operationId": "issueAddSubscription", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "description": "index of the issue", - "name": "index", - "in": "path", - "required": true, - "type": "integer", - "format": "int64" - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "username of the user to subscribe the issue to", - "name": "user" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - }, - "delete": { - "responses": { - "200": { - "description": "Already unsubscribed" - }, - "201": { - "description": "Successfully Unsubscribed" - }, - "304": { - "description": "User can only subscribe itself if he is no admin" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Unsubscribe user from issue", - "operationId": "issueDeleteSubscription", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index" - }, - { - "type": "string", - "description": "username of the user to unsubscribe from an issue", - "name": "user", - "in": "path", - "required": true - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/avatar": { - "post": { - "parameters": [ - { - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/UpdateRepoAvatarOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Update avatar", - "operationId": "repoUpdateAvatar" - }, - "delete": { - "tags": [ - "repository" - ], - "summary": "Delete avatar", - "operationId": "repoDeleteAvatar", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "name": "repo", - "in": "path", - "required": true, - "type": "string", - "description": "name of the repo" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "produces": [ - "application/json" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/commits/{ref}/statuses": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get a commit's statuses, by branch/tag/commit reference", - "operationId": "repoListStatusesByRef", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "name of branch/tag/commit", - "name": "ref" - }, - { - "enum": [ - "oldest", - "recentupdate", - "leastupdate", - "leastindex", - "highestindex" - ], - "type": "string", - "description": "type of sort", - "name": "sort", - "in": "query" - }, - { - "type": "string", - "description": "type of state", - "name": "state", - "in": "query", - "enum": [ - "pending", - "success", - "error", - "failure", - "warning" - ] - }, - { - "type": "integer", - "description": "page number of results to return (1-based)", - "name": "page", - "in": "query" - }, - { - "description": "page size of results", - "name": "limit", - "in": "query", - "type": "integer" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ], - "responses": { - "200": { - "$ref": "#/responses/CommitStatusList" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } } } - }, - "/repos/{owner}/group/{group_id}/{repo}/branches/{branch}": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Retrieve a specific branch from a repository, including its effective branch protection", - "operationId": "repoGetBranch", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "branch to get", - "name": "branch", - "in": "path", - "required": true - }, - { - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Branch" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "delete": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Delete a specific branch from a repository", - "operationId": "repoDeleteBranch", - "parameters": [ - { - "name": "owner", - "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "required": true, - "type": "string", - "description": "branch to delete", - "name": "branch", - "in": "path" - }, - { - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - } - }, - "patch": { - "summary": "Rename a branch", - "operationId": "repoRenameBranch", - "parameters": [ - { - "type": "string", - "description": "owner of the repo", - "name": "owner", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true - }, - { - "type": "string", - "description": "name of the branch", - "name": "branch", - "in": "path", - "required": true - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/RenameBranchRepoOption" - } - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/validationError" - }, - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "$ref": "#/responses/forbidden" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } } } } \ No newline at end of file