diff --git a/templates/swagger/v1_groups.json b/templates/swagger/v1_groups.json index 5bf56d2120..0a73b3e46f 100644 --- a/templates/swagger/v1_groups.json +++ b/templates/swagger/v1_groups.json @@ -1,15 +1,8 @@ { "paths": { - "/repos/{owner}/group/{group_id}/{repo}/topics": { + "/repos/{owner}/group/{group_id}/{repo}/collaborators": { "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get list of topics that a repository has", - "operationId": "repoListTopics", + "operationId": "repoListCollaborators", "parameters": [ { "type": "string", @@ -19,11 +12,97 @@ "required": true }, { - "required": true, "type": "string", "description": "name of the repo", "name": "repo", - "in": "path" + "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" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's collaborators" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runs": { + "get": { + "operationId": "getWorkflowRuns", + "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": "workflow event name", + "name": "event", + "in": "query" + }, + { + "description": "workflow branch", + "name": "branch", + "in": "query", + "type": "string" + }, + { + "type": "string", + "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", + "name": "status", + "in": "query" + }, + { + "type": "string", + "description": "triggered by user", + "name": "actor", + "in": "query" + }, + { + "type": "string", + "description": "triggering sha of the workflow run", + "name": "head_sha", + "in": "query" }, { "type": "integer", @@ -48,24 +127,14 @@ ], "responses": { "200": { - "$ref": "#/responses/TopicNames" + "$ref": "#/responses/WorkflowRunsList" + }, + "400": { + "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } - } - }, - "put": { - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "422": { - "$ref": "#/responses/invalidTopicsError" - } }, "produces": [ "application/json" @@ -73,8 +142,13 @@ "tags": [ "repository" ], - "summary": "Replace list of topics for a repository", - "operationId": "repoUpdateTopics", + "summary": "Lists all runs for a repository run" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/avatar": { + "post": { + "summary": "Update avatar", + "operationId": "repoUpdateAvatar", "parameters": [ { "type": "string", @@ -83,6 +157,512 @@ "in": "path", "required": true }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "schema": { + "$ref": "#/definitions/UpdateRepoAvatarOption" + }, + "name": "body", + "in": "body" + }, + { + "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/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "delete": { + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete avatar", + "operationId": "repoDeleteAvatar", + "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 + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/commits/{sha}.{diffType}": { + "get": { + "summary": "Get a commit's diff or patch", + "operationId": "repoDownloadCommitDiffOrPatch", + "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": "sha", + "in": "path", + "required": true, + "type": "string", + "description": "SHA of the commit to get" + }, + { + "enum": [ + "diff", + "patch" + ], + "type": "string", + "description": "whether the output is diff or patch", + "name": "diffType", + "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/string" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "text/plain" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/labels/{id}": { + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Update a label", + "operationId": "issueEditLabel", + "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" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the label to edit", + "name": "id" + }, + { + "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" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/Label" + } + } + }, + "get": { + "operationId": "issueGetLabel", + "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": "id of the label to get", + "name": "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/Label" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a single label" + }, + "delete": { + "operationId": "issueDeleteLabel", + "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": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the label to delete" + }, + { + "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": [ + "issue" + ], + "summary": "Delete a label" + } + }, + "/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 + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue to stop the stopwatch on", + "name": "index", + "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" + }, + "409": { + "description": "Cannot cancel a non-existent stopwatch" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "description": "Not repo writer, user does not have rights to toggle stopwatch" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List a repository's issues", + "operationId": "issueListIssues", + "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": "whether issue is open or closed", + "name": "state", + "in": "query", + "enum": [ + "closed", + "open", + "all" + ], + "type": "string" + }, + { + "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", + "type": "string", + "description": "search string", + "name": "q" + }, + { + "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" + }, + { + "in": "query", + "type": "string", + "format": "date-time", + "description": "Only show items updated after the given time. This is a timestamp in RFC 3339 format", + "name": "since" + }, + { + "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" + }, + { + "in": "query", + "type": "string", + "description": "Only show items which were created by the given user", + "name": "created_by" + }, + { + "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" + }, + { + "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" + }, + { + "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": { + "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": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, { "in": "path", "required": true, @@ -94,7 +674,564 @@ "name": "body", "in": "body", "schema": { - "$ref": "#/definitions/RepoTopicOptions" + "$ref": "#/definitions/CreateIssueOption" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "412": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Issue" + } + }, + "consumes": [ + "application/json" + ], + "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": [ + { + "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" + }, + { + "required": true, + "type": "string", + "description": "name of branch/tag/commit", + "name": "ref", + "in": "path" + }, + { + "name": "sort", + "in": "query", + "enum": [ + "oldest", + "recentupdate", + "leastupdate", + "leastindex", + "highestindex" + ], + "type": "string", + "description": "type of sort" + }, + { + "enum": [ + "pending", + "success", + "error", + "failure", + "warning" + ], + "type": "string", + "description": "type of state", + "name": "state", + "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" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/CommitStatusList" + }, + "400": { + "$ref": "#/responses/error" + }, + "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": [ + { + "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": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "format": "int64", + "description": "id of the attachment to get", + "name": "attachment_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": { + "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": [ + { + "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" + }, + { + "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 delete", + "name": "attachment_id" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/error" + } + } + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Edit an issue attachment", + "operationId": "issueEditIssueAttachment", + "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", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "id of the attachment to edit", + "name": "attachment_id", + "in": "path", + "required": true + }, + { + "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": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/timeline": { + "get": { + "tags": [ + "issue" + ], + "summary": "List all comments and events on an issue", + "operationId": "issueGetCommentsAndTimeline", + "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" + }, + { + "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" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TimelineList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/start": { + "post": { + "operationId": "issueStartStopWatch", + "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 the issue to create the stopwatch on", + "name": "index", + "in": "path", + "required": true + }, + { + "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." + } + }, + "/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 + }, + { + "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}/statuses/{sha}": { + "post": { + "responses": { + "201": { + "$ref": "#/responses/CommitStatus" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a commit status", + "operationId": "repoCreateStatus", + "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": "sha of the commit", + "name": "sha", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateStatusOption" } }, { @@ -106,10 +1243,241 @@ "format": "int64" } ] + }, + "get": { + "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": "string", + "description": "sha of the commit", + "name": "sha", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "type of sort", + "name": "sort", + "in": "query", + "enum": [ + "oldest", + "recentupdate", + "leastupdate", + "leastindex", + "highestindex" + ] + }, + { + "description": "type of state", + "name": "state", + "in": "query", + "enum": [ + "pending", + "success", + "error", + "failure", + "warning" + ], + "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" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/CommitStatusList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a commit's statuses", + "operationId": "repoListStatuses" } }, "/repos/{owner}/group/{group_id}/{repo}/wiki/page/{pageName}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a wiki page", + "operationId": "repoGetWikiPage", + "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" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the page", + "name": "pageName" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WikiPage" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "tags": [ + "repository" + ], + "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 + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the page", + "name": "pageName" + }, + { + "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" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, "patch": { + "summary": "Edit a wiki page", + "operationId": "repoEditWikiPage", + "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": "name of the page", + "name": "pageName", + "in": "path" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/CreateWikiPageOptions" + }, + "name": "body" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], "responses": { "200": { "$ref": "#/responses/WikiPage" @@ -132,54 +1500,19 @@ ], "tags": [ "repository" - ], - "summary": "Edit a wiki page", - "operationId": "repoEditWikiPage", - "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": "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" - } ] - }, + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/jobs/{job_id}/logs": { "get": { + "produces": [ + "application/json" + ], "tags": [ "repository" ], - "summary": "Get a wiki page", - "operationId": "repoGetWikiPage", + "summary": "Downloads the job logs for a workflow run", + "operationId": "downloadActionsRunJobLogs", "parameters": [ { "name": "owner", @@ -189,16 +1522,79 @@ "description": "owner of the repo" }, { + "description": "name of the repository", "name": "repo", "in": "path", "required": true, - "type": "string", - "description": "name of the repo" + "type": "string" }, { + "type": "integer", + "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": { + "description": "output blob content" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/undismissals": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Cancel to dismiss a review for a pull request", + "operationId": "repoUnDismissPullReview", + "parameters": [ + { + "description": "owner of the repo", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "in": "path", + "required": true, "type": "string", - "description": "name of the page", - "name": "pageName", + "description": "name of the repo", + "name": "repo" + }, + { + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request" + }, + { + "type": "integer", + "format": "int64", + "description": "id of the review", + "name": "id", "in": "path", "required": true }, @@ -212,128 +1608,17 @@ } ], "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" + "422": { + "$ref": "#/responses/validationError" }, - { - "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" + "$ref": "#/responses/PullReview" } } } @@ -356,6 +1641,278 @@ ], "summary": "Get repo licenses", "operationId": "repoGetLicenses", + "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", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/variables/{variablename}": { + "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 + }, + { + "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" + }, + { + "schema": { + "$ref": "#/definitions/UpdateVariableOption" + }, + "name": "body", + "in": "body" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "201": { + "description": "response when updating a repo-level variable" + }, + "204": { + "description": "response when updating a repo-level variable" + } + } + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a repo-level variable", + "operationId": "createRepoVariable", + "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": "name of the variable", + "name": "variablename", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateVariableOption" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "201": { + "description": "response when creating a repo-level variable" + }, + "400": { + "$ref": "#/responses/error" + }, + "409": { + "description": "variable name already exists." + }, + "500": { + "$ref": "#/responses/error" + } + } + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a repo-level variable", + "operationId": "deleteRepoVariable", + "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 + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "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" + } + } + }, + "get": { + "operationId": "getRepoVariable", + "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 + }, + { + "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" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/comments": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a specific review for a pull request", + "operationId": "repoGetPullReviewComments", "parameters": [ { "type": "string", @@ -372,14 +1929,331 @@ "type": "string" }, { + "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/PullReviewCommentList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/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 + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "description": "index of the pull request", + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "type": "integer", + "format": "int64", + "description": "id of the review", + "name": "id", + "in": "path", + "required": true + }, + { "required": true, "in": "path", "description": "group ID of the repo", "name": "group_id", - "type": "integer" + "type": "integer", + "format": "int64" } - ] + ], + "responses": { + "200": { + "$ref": "#/responses/PullReview" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "operationId": "repoSubmitPullReview", + "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": "index of the pull request", + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "format": "int64", + "description": "id of the review", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/SubmitPullReviewOptions" + } + }, + { + "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" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Submit a pending review to an pull request" + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a specific review from a pull request", + "operationId": "repoDeletePullReview", + "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", + "name": "index", + "in": "path", + "required": true + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the review", + "name": "id" + }, + { + "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" + }, + "403": { + "$ref": "#/responses/forbidden" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/variables": { + "get": { + "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 + }, + { + "type": "string", + "description": "name of the repository", + "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" + }, + { + "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/VariableList" + }, + "400": { + "$ref": "#/responses/error" + } + } + } + }, + "/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": [ + { + "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": "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" + } + } } }, "/repos/{owner}/group/{group_id}/{repo}/teams/{team}": { @@ -394,18 +2268,18 @@ "operationId": "repoCheckTeam", "parameters": [ { + "required": true, + "type": "string", "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", - "in": "path" + "in": "path", + "required": true }, { "in": "path", @@ -415,12 +2289,12 @@ "name": "team" }, { + "required": true, "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", - "format": "int64", - "required": true + "format": "int64" } ], "responses": { @@ -436,16 +2310,69 @@ } }, "put": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], "summary": "Add a team to a repository", "operationId": "repoAddTeam", "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": "team name", + "name": "team", + "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" + }, + "405": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + }, + "delete": { + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner" + }, { "type": "string", "description": "name of the repo", @@ -483,14 +2410,6 @@ "$ref": "#/responses/validationError" } }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - }, - "delete": { "produces": [ "application/json" ], @@ -498,1352 +2417,19 @@ "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": "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": "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" - } - } + "operationId": "repoDeleteTeam" } }, "/repos/{owner}/group/{group_id}/{repo}/releases/latest": { "get": { + "responses": { + "200": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, "produces": [ "application/json" ], @@ -1854,75 +2440,11 @@ "operationId": "repoGetLatestRelease", "parameters": [ { + "type": "string", "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" + "required": true }, { "in": "path", @@ -1931,780 +2453,6 @@ "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", @@ -2713,375 +2461,10 @@ "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", - "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/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 - }, - { - "description": "name of the repo", - "name": "repo", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "body", - "in": "body", - "schema": { - "$ref": "#/definitions/CreateLabelOption" - } - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "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", - "required": true, - "in": "path", - "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, - "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" - }, - "422": { - "$ref": "#/responses/validationError" - } - } - }, + "/repos/{owner}/group/{group_id}/{repo}/git/trees/{sha}": { "get": { "produces": [ "application/json" @@ -3089,1027 +2472,8 @@ "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/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": { - "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", - "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": "attachment_id", - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "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": { + "summary": "Gets the tree of a repository.", + "operationId": "GetTree", "parameters": [ { "description": "owner of the repo", @@ -4126,1066 +2490,69 @@ "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 }, { + "type": "boolean", + "description": "show all directories and files", + "name": "recursive", + "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", + "in": "query" + }, + { + "type": "integer", + "description": "number of items per page", + "name": "per_page", + "in": "query" + }, + { + "required": true, + "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", - "format": "int64", - "required": true, - "in": "path" + "format": "int64" } ], "responses": { "200": { - "$ref": "#/responses/PullRequest" + "$ref": "#/responses/GitTreeResponse" + }, + "400": { + "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } - }, + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runners/registration-token": { + "get": { "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", + "summary": "Get a repository's actions runner registration token", + "operationId": "repoGetRunnerRegistrationToken", "parameters": [ { - "required": true, "type": "string", "description": "owner of the repo", "name": "owner", - "in": "path" + "in": "path", + "required": true }, { "type": "string", @@ -5205,138 +2572,53 @@ ], "responses": { "200": { - "$ref": "#/responses/BranchProtectionList" + "$ref": "#/responses/RegistrationToken" + } + } + }, + "post": { + "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 + }, + { + "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/RegistrationToken" } }, "produces": [ "application/json" + ], + "tags": [ + "repository" ] - }, - "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": { + "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}/permission": { "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", + "operationId": "repoGetRepoPermissions", "parameters": [ { "in": "path", @@ -5352,65 +2634,45 @@ "in": "path", "required": true }, + { + "in": "path", + "required": true, + "type": "string", + "description": "username of the collaborator whose permissions are to be obtained", + "name": "collaborator" + }, { "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" + "name": "group_id" } ], "responses": { - "423": { - "$ref": "#/responses/repoArchivedError" + "200": { + "$ref": "#/responses/RepoCollaboratorPermission" }, - "201": { - "$ref": "#/responses/Attachment" - }, - "400": { - "$ref": "#/responses/error" + "403": { + "$ref": "#/responses/forbidden" }, "404": { - "$ref": "#/responses/error" - }, - "413": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" + "$ref": "#/responses/notFound" } - } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get repository permissions for a user" } }, "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}": { - "put": { - "tags": [ - "repository" - ], - "summary": "Add or Update a collaborator to a repository", - "operationId": "repoAddCollaborator", + "get": { + "operationId": "repoCheckCollaborator", "parameters": [ { "type": "string", @@ -5419,117 +2681,6 @@ "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", @@ -5545,12 +2696,12 @@ "required": true }, { - "required": true, - "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", - "format": "int64" + "format": "int64", + "required": true, + "in": "path" } ], "responses": { @@ -5569,19 +2720,18 @@ ], "tags": [ "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}": { - "get": { + ], + "summary": "Check if a user is a collaborator of a repository" + }, + "put": { "produces": [ "application/json" ], "tags": [ "repository" ], - "summary": "Get a hook", - "operationId": "repoGetHook", + "summary": "Add or Update a collaborator to a repository", + "operationId": "repoAddCollaborator", "parameters": [ { "type": "string", @@ -5591,62 +2741,25 @@ "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" + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "username of the user to add or update as a collaborator", + "name": "collaborator", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/AddCollaboratorOption" + } }, { "description": "group ID of the repo", @@ -5658,6 +2771,57 @@ } ], "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + }, + "delete": { + "operationId": "repoDeleteCollaborator", + "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 to delete", + "name": "collaborator", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, "204": { "$ref": "#/responses/empty" }, @@ -5671,97 +2835,45 @@ "tags": [ "repository" ], - "summary": "Delete a hook in a repository" - }, - "patch": { + "summary": "Delete a collaborator from a repository" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/assets/{attachment_id}": { + "get": { + "tags": [ + "issue" + ], + "summary": "Get a comment attachment", + "operationId": "issueGetIssueCommentAttachment", "parameters": [ { + "type": "string", + "description": "owner of the repo", "name": "owner", "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" + "required": true }, { - "required": true, "type": "string", "description": "name of the repo", "name": "repo", - "in": "path" + "in": "path", + "required": true }, { - "description": "index of the hook", + "format": "int64", + "description": "id of the comment", "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 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", + "type": "integer", + "format": "int64", + "description": "id of the attachment to get", + "name": "attachment_id", "in": "path" }, { @@ -5772,135 +2884,25 @@ "in": "path", "description": "group ID of the repo" } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/subscribers": { - "get": { + ], "responses": { "200": { - "$ref": "#/responses/UserList" + "$ref": "#/responses/Attachment" }, "404": { - "$ref": "#/responses/notFound" + "$ref": "#/responses/error" } }, "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 - }, - { - "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" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "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 - }, - { - "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": { - "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", + "summary": "Delete a comment attachment", + "operationId": "issueDeleteIssueCommentAttachment", "parameters": [ { "required": true, @@ -5910,84 +2912,28 @@ "in": "path" }, { - "required": true, "type": "string", "description": "name of the repo", "name": "repo", - "in": "path" + "in": "path", + "required": true }, { - "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", - "name": "group_id", "type": "integer", "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/Issue" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "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", + "description": "id of the comment", + "name": "id", "in": "path", "required": true }, { - "type": "string", - "description": "name of the repo", - "name": "repo", + "type": "integer", + "format": "int64", + "description": "id of the attachment to delete", + "name": "attachment_id", "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", @@ -5998,308 +2944,51 @@ } ], "responses": { - "200": { - "$ref": "#/responses/IssueList" - }, "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - }, - "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": "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", - "name": "owner", - "in": "path", - "required": true, - "type": "string" - }, - { - "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/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" + "423": { + "$ref": "#/responses/repoArchivedError" }, - { - "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", + "summary": "Edit a comment attachment", + "operationId": "issueEditIssueCommentAttachment", "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 }, { - "description": "name of the repo", - "name": "repo", - "in": "path", "required": true, - "type": "string" + "type": "integer", + "format": "int64", + "description": "id of the comment", + "name": "id", + "in": "path" }, { - "type": "string", - "description": "name of protected branch", - "name": "name", + "type": "integer", + "format": "int64", + "description": "id of the attachment to edit", + "name": "attachment_id", "in": "path", "required": true }, @@ -6307,7 +2996,7 @@ "name": "body", "in": "body", "schema": { - "$ref": "#/definitions/EditBranchProtectionOption" + "$ref": "#/definitions/EditAttachmentOptions" } }, { @@ -6320,11 +3009,11 @@ } ], "responses": { - "200": { - "$ref": "#/responses/BranchProtection" + "201": { + "$ref": "#/responses/Attachment" }, "404": { - "$ref": "#/responses/notFound" + "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" @@ -6332,1122 +3021,6 @@ "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 - }, - { - "type": "string", - "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", - "in": "query" - }, - { - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/CommentList" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "post": { - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - }, - "201": { - "$ref": "#/responses/Comment" - }, - "403": { - "$ref": "#/responses/forbidden" - } }, "consumes": [ "application/json" @@ -7457,1570 +3030,6 @@ ], "tags": [ "issue" - ], - "summary": "Add a comment to an issue", - "operationId": "issueCreateComment", - "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" - }, - { - "schema": { - "$ref": "#/definitions/CreateIssueCommentOption" - }, - "name": "body", - "in": "body" - }, - { - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}/tests": { - "post": { - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Test a push webhook", - "operationId": "repoTestHook", - "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 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" - } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/comments": { - "get": { - "responses": { - "200": { - "$ref": "#/responses/CommentList" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "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 - }, - { - "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}/push_mirrors": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Get all push mirrors of the repository", - "operationId": "repoListPushMirrors", - "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" - }, - { - "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": { - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/PushMirrorList" - } - } - }, - "post": { - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$ref": "#/responses/PushMirror" - }, - "400": { - "$ref": "#/responses/error" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "add a push mirror to the repository", - "operationId": "repoAddPushMirror", - "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" - }, - { - "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", - "description": "group ID of the repo", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true - } - ], - "responses": { - "200": { - "$ref": "#/definitions/ActionRunnersResponse" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/{user}": { - "put": { - "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" - }, - { - "in": "path", - "required": true, - "type": "integer", - "format": "int64", - "description": "index of the issue", - "name": "index" - }, - { - "description": "username of the user to subscribe the issue to", - "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": { - "304": { - "description": "User can only subscribe itself if he is no admin" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "description": "Already subscribed" - }, - "201": { - "description": "Successfully Subscribed" - } - }, - "consumes": [ - "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}/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 - }, - { - "in": "path", - "required": true, - "type": "string", - "description": "id of the runner", - "name": "runner_id" - }, - { - "type": "integer", - "format": "int64", - "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", - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "200": { - "$ref": "#/responses/WorkflowRun" - }, - "400": { - "$ref": "#/responses/error" - }, - "404": { - "$ref": "#/responses/notFound" - } - } - }, - "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 - }, - { - "type": "integer", - "description": "runid of the workflow run", - "name": "run", - "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" - }, - "204": { - "description": "No Content" - }, - "400": { - "$ref": "#/responses/error" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/delete": { - "delete": { - "summary": "Delete an issue's existing stopwatch.", - "operationId": "issueDeleteStopWatch", - "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 to stop the stopwatch on" - }, - { - "name": "group_id", - "type": "integer", - "format": "int64", - "required": true, - "in": "path", - "description": "group ID of the repo" - } - ], - "responses": { - "204": { - "$ref": "#/responses/empty" - }, - "403": { - "description": "Not repo writer, user does not have rights to toggle stopwatch" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "409": { - "description": "Cannot cancel a non-existent stopwatch" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/signing-key.pub": { - "get": { - "produces": [ - "text/plain" - ], - "tags": [ - "repository" - ], - "summary": "Get signing-key.pub for given repository", - "operationId": "repoSigningKeySSH", - "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": { - "200": { - "description": "ssh public key", - "schema": { - "type": "string" - } - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/push_mirrors-sync": { - "post": { - "responses": { - "200": { - "$ref": "#/responses/empty" - }, - "400": { - "$ref": "#/responses/error" - }, - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Sync all push mirrored repository", - "operationId": "repoPushMirrorSync", - "parameters": [ - { - "type": "string", - "description": "owner of the repo to sync", - "name": "owner", - "in": "path", - "required": true - }, - { - "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" - } - ] - } - }, - "/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", - "description": "group ID of the repo", - "name": "group_id", - "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}/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 - }, - { - "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", - "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" ] } }, @@ -9043,19 +3052,19 @@ "required": true }, { + "required": true, + "type": "string", "description": "name of the repo", "name": "repo", - "in": "path", - "required": true, - "type": "string" + "in": "path" }, { - "required": true, - "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", - "format": "int64" + "format": "int64", + "required": true, + "in": "path" } ], "responses": { @@ -9068,1454 +3077,17 @@ } } }, - "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/check": { + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/reactions": { "get": { - "operationId": "issueCheckSubscription", + "operationId": "issueGetCommentReactions", "parameters": [ { + "required": true, + "type": "string", + "description": "owner of the repo", "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", - "type": "integer", - "format": "int64", - "required": true, - "in": "path" - } - ], - "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "200": { - "$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", @@ -10531,94 +3103,6 @@ "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", @@ -10630,246 +3114,57 @@ ], "responses": { "200": { - "$ref": "#/responses/IssueList" + "$ref": "#/responses/ReactionList" + }, + "403": { + "$ref": "#/responses/forbidden" }, "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": [ + "consumes": [ "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" - } - } + "summary": "Get a list of reactions from a comment of an issue" }, "post": { - "operationId": "repoCreateStatus", + "summary": "Add a reaction to a comment of an issue", + "operationId": "issuePostCommentReaction", "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": "repo", + "in": "path", "required": true, "type": "string", - "description": "sha of the commit", - "name": "sha", - "in": "path" + "description": "name of the repo" }, { - "name": "body", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the comment to edit", + "name": "id" + }, + { + "name": "content", "in": "body", "schema": { - "$ref": "#/definitions/CreateStatusOption" + "$ref": "#/definitions/EditReactionOption" } }, { @@ -10882,39 +3177,45 @@ } ], "responses": { - "201": { - "$ref": "#/responses/CommitStatus" - }, - "400": { - "$ref": "#/responses/error" + "403": { + "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/Reaction" + }, + "201": { + "$ref": "#/responses/Reaction" } }, + "consumes": [ + "application/json" + ], "produces": [ "application/json" ], "tags": [ - "repository" + "issue" + ] + }, + "delete": { + "produces": [ + "application/json" ], - "summary": "Create a commit status" - } - }, - "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/disable": { - "put": { "tags": [ - "repository" + "issue" ], - "summary": "Disable a workflow", - "operationId": "ActionsDisableWorkflow", + "summary": "Remove a reaction from a comment of an issue", + "operationId": "issueDeleteCommentReaction", "parameters": [ { + "type": "string", + "description": "owner of the repo", "name": "owner", "in": "path", - "required": true, - "type": "string", - "description": "owner of the repo" + "required": true }, { "type": "string", @@ -10924,66 +3225,19 @@ "required": true }, { - "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", - "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": "string", - "description": "owner of the repo to fork", - "name": "owner" - }, - { - "type": "string", - "description": "name of the repo to fork", - "name": "repo", + "description": "id of the comment to edit", + "name": "id", "in": "path", "required": true }, { - "in": "body", "schema": { - "$ref": "#/definitions/CreateForkOption" + "$ref": "#/definitions/EditReactionOption" }, - "name": "body" + "name": "content", + "in": "body" }, { "description": "group ID of the repo", @@ -10995,9 +3249,49 @@ } ], "responses": { - "422": { - "$ref": "#/responses/validationError" + "200": { + "$ref": "#/responses/empty" }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/transfer/accept": { + "post": { + "operationId": "acceptRepoTransfer", + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo to transfer" + }, + { + "description": "name of the repo to transfer", + "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": { "202": { "$ref": "#/responses/Repository" }, @@ -11006,9 +3300,6 @@ }, "404": { "$ref": "#/responses/notFound" - }, - "409": { - "description": "The repository with the same name already exists." } }, "produces": [ @@ -11017,26 +3308,211 @@ "tags": [ "repository" ], - "summary": "Fork a repository", - "operationId": "createFork" + "summary": "Accept a repo transfer" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/reactions": { + "post": { + "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" + ], + "summary": "Add a reaction to an issue", + "operationId": "issuePostIssueReaction", + "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" + }, + { + "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" + } + ] + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Remove a reaction from an issue", + "operationId": "issueDeleteIssueReaction", + "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" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/EditReactionOption" + }, + "name": "content" + }, + { + "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/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] }, "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 + }, + { + "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": "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" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], "responses": { "200": { - "$ref": "#/responses/RepositoryList" + "$ref": "#/responses/ReactionList" + }, + "403": { + "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repository's forks", - "operationId": "listForks", + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}/enable": { + "put": { + "operationId": "ActionsEnableWorkflow", "parameters": [ { "type": "string", @@ -11053,35 +3529,52 @@ "name": "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" - }, - { + "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 + "required": true, + "in": "path" } - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/releases/tags/{tag}": { - "get": { + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/conflict" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "description": "No Content" + } + }, + "produces": [ + "application/json" + ], "tags": [ "repository" ], - "summary": "Get a release by tag name", - "operationId": "repoGetReleaseByTag", + "summary": "Enable a workflow" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/revisions/{pageName}": { + "get": { "parameters": [ { "type": "string", @@ -11098,9 +3591,340 @@ "required": true }, { + "required": true, "type": "string", - "description": "tag name of the release to get", - "name": "tag", + "description": "name of the page", + "name": "pageName", + "in": "path" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WikiCommitList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get revisions of a wiki page", + "operationId": "repoGetWikiPageRevisions" + } + }, + "/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 + }, + { + "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 pull request", + "name": "index" + }, + { + "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" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullReviewList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "tags": [ + "repository" + ], + "summary": "Create a review to an pull request", + "operationId": "repoCreatePullReview", + "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 + }, + { + "schema": { + "$ref": "#/definitions/CreatePullReviewOptions" + }, + "name": "body", + "in": "body", + "required": true + }, + { + "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" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tags": { + "get": { + "operationId": "repoListTags", + "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": "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, default maximum page size is 50" + }, + { + "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" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's tags" + }, + "post": { + "responses": { + "405": { + "$ref": "#/responses/empty" + }, + "409": { + "$ref": "#/responses/conflict" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "200": { + "$ref": "#/responses/Tag" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "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 + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateTagOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/subscription": { + "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" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/WatchInfo" + }, + "404": { + "description": "User is not watching this repo or repo do not exist" + } + } + }, + "put": { + "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 }, @@ -11115,29 +3939,34 @@ ], "responses": { "200": { - "$ref": "#/responses/Release" + "$ref": "#/responses/WatchInfo" + }, + "403": { + "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } }, - "produces": [ - "application/json" - ] + "tags": [ + "repository" + ], + "summary": "Watch a repo", + "operationId": "userCurrentPutSubscription" }, "delete": { "tags": [ "repository" ], - "summary": "Delete a release by tag name", - "operationId": "repoDeleteReleaseByTag", + "summary": "Unwatch a repo", + "operationId": "userCurrentDeleteSubscription", "parameters": [ { - "required": true, "type": "string", "description": "owner of the repo", "name": "owner", - "in": "path" + "in": "path", + "required": true }, { "type": "string", @@ -11146,67 +3975,6 @@ "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", @@ -11217,19 +3985,13 @@ } ], "responses": { - "200": { - "description": "success" + "204": { + "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] + } } }, "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/times/{id}": { @@ -11241,11 +4003,11 @@ "operationId": "issueDeleteTime", "parameters": [ { - "required": true, "type": "string", "description": "owner of the repo", "name": "owner", - "in": "path" + "in": "path", + "required": true }, { "type": "string", @@ -11271,26 +4033,26 @@ "required": true }, { - "in": "path", "description": "group ID of the repo", "name": "group_id", "type": "integer", "format": "int64", - "required": true + "required": true, + "in": "path" } ], "responses": { - "403": { - "$ref": "#/responses/forbidden" - }, - "404": { - "$ref": "#/responses/notFound" - }, "204": { "$ref": "#/responses/empty" }, "400": { "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" } }, "consumes": [ @@ -11301,8 +4063,16 @@ ] } }, - "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets/{attachment_id}": { + "/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": [ { "required": true, @@ -11312,27 +4082,100 @@ "in": "path" }, { - "in": "path", "required": true, "type": "string", "description": "name of the repo", - "name": "repo" + "name": "repo", + "in": "path" }, { - "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" + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/IssueTemplates" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issue_config/validate": { + "get": { + "operationId": "repoValidateIssueConfig", + "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": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RepoIssueConfigValidation" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Returns the validation information for a issue config" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tags/{tag}": { + "get": { + "summary": "Get the tag of a repository by tag name", + "operationId": "repoGetTag", + "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 tag", + "name": "tag", + "in": "path", + "required": true }, { "required": true, @@ -11345,7 +4188,7 @@ ], "responses": { "200": { - "$ref": "#/responses/Attachment" + "$ref": "#/responses/Tag" }, "404": { "$ref": "#/responses/notFound" @@ -11356,9 +4199,7 @@ ], "tags": [ "repository" - ], - "summary": "Get a release attachment", - "operationId": "repoGetReleaseAttachment" + ] }, "delete": { "produces": [ @@ -11367,69 +4208,63 @@ "tags": [ "repository" ], - "summary": "Delete a release attachment", - "operationId": "repoDeleteReleaseAttachment", + "summary": "Delete a repository's tag by name", + "operationId": "repoDeleteTag", "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": "string" + }, + { "in": "path", "required": true, "type": "string", - "description": "name of the repo" + "description": "name of tag to delete", + "name": "tag" }, { - "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" + "in": "path", + "description": "group ID of the repo" } ], "responses": { + "204": { + "$ref": "#/responses/empty" + }, "404": { "$ref": "#/responses/notFound" }, - "204": { + "405": { "$ref": "#/responses/empty" + }, + "409": { + "$ref": "#/responses/conflict" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" } } - }, - "patch": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "Edit a release attachment", - "operationId": "repoEditReleaseAttachment", + } + }, + "/repos/{owner}/group/{group_id}/{repo}/push_mirrors/{name}": { + "get": { "parameters": [ { "name": "owner", @@ -11438,69 +4273,6 @@ "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", @@ -11509,16 +4281,11 @@ "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" + "in": "path", + "required": true, + "type": "string", + "description": "remote name of push mirror", + "name": "name" }, { "description": "group ID of the repo", @@ -11530,130 +4297,27 @@ } ], "responses": { + "404": { + "$ref": "#/responses/notFound" + }, "200": { - "$ref": "#/responses/WikiPageList" + "$ref": "#/responses/PushMirror" }, - "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" + "400": { + "$ref": "#/responses/error" }, "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" - } - }, - "produces": [ - "application/json" - ] + "summary": "Get push mirror of the repository by remoteName", + "operationId": "repoGetPushMirrorByRemoteName" }, "delete": { "produces": [ @@ -11662,647 +4326,8 @@ "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}/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", + "summary": "deletes a push mirror from a repository by remoteName", + "operationId": "repoDeletePushMirror", "parameters": [ { "in": "path", @@ -12312,11 +4337,62 @@ "name": "owner" }, { - "required": true, - "type": "string", "description": "name of the repo", "name": "repo", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "remote name of the pushMirror", + "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" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/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" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" }, { "name": "index", @@ -12326,944 +4402,6 @@ "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, @@ -13275,191 +4413,10 @@ ], "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" + "$ref": "#/responses/WatchInfo" }, "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" + "$ref": "#/responses/notFound" } }, "consumes": [ @@ -13467,83 +4424,11 @@ ], "produces": [ "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Edit a comment attachment", - "operationId": "issueEditIssueCommentAttachment" + ] } }, - "/repos/{owner}/group/{group_id}/{repo}/stargazers": { + "/repos/{owner}/group/{group_id}/{repo}/hooks": { "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, @@ -13560,22 +4445,10 @@ "name": "repo" }, { + "in": "query", "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" + "name": "page" }, { "type": "integer", @@ -13584,36 +4457,58 @@ "in": "query" }, { - "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": { "200": { - "$ref": "#/responses/DeployKeyList" + "$ref": "#/responses/HookList" }, "404": { "$ref": "#/responses/notFound" } - } - }, - "post": { + }, + "produces": [ + "application/json" + ], "tags": [ "repository" ], - "summary": "Add a key to a repository", - "operationId": "repoCreateKey", + "summary": "List the hooks in a repository", + "operationId": "repoListHooks" + }, + "post": { + "responses": { + "201": { + "$ref": "#/responses/Hook" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a hook", + "operationId": "repoCreateHook", "parameters": [ { - "in": "path", - "required": true, "type": "string", "description": "owner of the repo", - "name": "owner" + "name": "owner", + "in": "path", + "required": true }, { "type": "string", @@ -13626,171 +4521,9 @@ "name": "body", "in": "body", "schema": { - "$ref": "#/definitions/CreateKeyOption" + "$ref": "#/definitions/CreateHookOption" } }, - { - "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": [ - { - "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 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", @@ -13799,343 +4532,31 @@ "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": { - "200": { - "$ref": "#/responses/FileResponse" - }, - "404": { - "$ref": "#/responses/notFound" - }, - "423": { - "$ref": "#/responses/repoArchivedError" - } - }, - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - } - }, - "/repos/{owner}/group/{group_id}/{repo}/activities/feeds": { - "get": { - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "summary": "List a repository's activity feeds", - "operationId": "repoListActivityFeeds", - "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", - "format": "date", - "description": "the date of the activities to be found", - "name": "date", - "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" - }, - { - "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/ActivityFeedsList" - } - } - } - }, - "/repos/{owner}/group/{group_id}/{repo}/hooks/git/{id}": { - "get": { - "summary": "Get a Git hook", - "operationId": "repoGetGitHook", - "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": "id of the hook to get", - "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/GitHook" - }, - "404": { - "$ref": "#/responses/notFound" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ] - }, - "delete": { - "responses": { - "404": { - "$ref": "#/responses/notFound" - }, - "204": { - "$ref": "#/responses/empty" - } - }, - "produces": [ - "application/json" - ], - "tags": [ - "repository" - ], - "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" - }, - { - "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": { + "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" + } + }, "produces": [ "application/json" ], @@ -14179,39 +4600,26 @@ "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/{index}": { + "/repos/{owner}/group/{group_id}/{repo}/keys/{id}": { "get": { - "operationId": "repoGetPullRequest", + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a repository's key by id", + "operationId": "repoGetKey", "parameters": [ { + "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", - "required": true, - "type": "string" + "required": true }, { "description": "name of the repo", @@ -14221,12 +4629,449 @@ "type": "string" }, { + "type": "integer", + "format": "int64", + "description": "id of the key 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/DeployKey" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a key from a repository", + "operationId": "repoDeleteKey", + "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 key 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" + } + ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/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 + }, + { + "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" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "500": { + "$ref": "#/responses/error" + }, + "200": { + "$ref": "#/responses/ActionWorkflowList" + }, + "400": { + "$ref": "#/responses/error" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}": { + "get": { + "summary": "Get an issue", + "operationId": "issueGetIssue", + "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 to get", - "name": "index", + "description": "index of the issue to get" + }, + { + "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": { + "tags": [ + "issue" + ], + "summary": "Delete an issue", + "operationId": "issueDelete", + "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 delete" + }, + { + "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" + } + } + }, + "patch": { + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "412": { + "$ref": "#/responses/error" + }, + "201": { + "$ref": "#/responses/Issue" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "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": [ + { + "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 edit" + }, + { + "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" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/compare/{basehead}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get commit comparison information", + "operationId": "repoCompareDiff", + "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": "compare two branches or commits", + "name": "basehead" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Compare" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/pages": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get all wiki pages", + "operationId": "repoGetWikiPages", + "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": "integer", + "description": "page number of results to return (1-based)", + "name": "page" + }, + { + "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/WikiPageList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions": { + "get": { + "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 issue", + "name": "index", + "in": "path", + "required": true + }, + { + "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" }, { "name": "group_id", @@ -14239,7 +5084,121 @@ ], "responses": { "200": { - "$ref": "#/responses/PullRequest" + "$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}/actions/runs/{run}/artifacts": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Lists all artifacts for a repository run", + "operationId": "getArtifactsOfRun", + "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": "run", + "in": "path", + "required": true, + "type": "integer", + "description": "runid of the workflow run" + }, + { + "description": "name of the artifact", + "name": "name", + "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/ArtifactsList" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/hooks/git/{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 + }, + { + "required": true, + "type": "string", + "description": "id of the hook to get", + "name": "id", + "in": "path" + }, + { + "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" @@ -14251,9 +5210,291 @@ "tags": [ "repository" ], - "summary": "Get a pull request" + "summary": "Get a Git hook", + "operationId": "repoGetGitHook" + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a Git hook in a repository", + "operationId": "repoDeleteGitHook", + "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": "string", + "description": "id of the hook to get", + "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" + ] }, "patch": { + "operationId": "repoEditGitHook", + "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": "id of the hook to get", + "name": "id", + "in": "path", + "required": true + }, + { + "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" + ], + "summary": "Edit a Git hook in a repository" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/activities/feeds": { + "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", + "format": "date", + "description": "the date of the activities to be found", + "name": "date", + "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/ActivityFeedsList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's activity feeds", + "operationId": "repoListActivityFeeds" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/labels/{id}": { + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Remove a label from an issue", + "operationId": "issueRemoveLabel", + "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" + }, + { + "description": "id of the label to remove", + "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" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branch_protections/priority": { + "post": { + "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/UpdateBranchProtectionPriories" + } + }, + { + "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" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, "consumes": [ "application/json" ], @@ -14263,8 +5504,742 @@ "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", + "summary": "Update the priorities of branch protections for a repository.", + "operationId": "repoUpdateBranchProtectionPriories" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/times": { + "get": { + "operationId": "repoTrackedTimes", + "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": "user", + "in": "query", + "type": "string", + "description": "optional filter by user (available for issue managers)" + }, + { + "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" + }, + { + "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" + }, + { + "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": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/TrackedTimeList" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's tracked times" + } + }, + "/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": [ + { + "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": "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}/signing-key.gpg": { + "get": { + "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 + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "description": "GPG armored public key", + "schema": { + "type": "string" + } + } + }, + "produces": [ + "text/plain" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/teams": { + "get": { + "tags": [ + "repository" + ], + "summary": "List a repository's teams", + "operationId": "repoListTeams", + "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" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TeamList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/jobs/{job_id}": { + "get": { + "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" + }, + { + "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": { + "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}/pulls/pinned": { + "get": { + "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, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/PullRequestList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's pinned pull requests", + "operationId": "repoListPinnedPullRequests" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/refs/{ref}": { + "get": { + "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", + "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": "string", + "description": "part or full name of the ref", + "name": "ref", + "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}/issues/{index}/pin/{position}": { + "patch": { + "tags": [ + "issue" + ], + "summary": "Moves the Pin to the given Position", + "operationId": "moveIssuePin", + "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", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "the new position", + "name": "position", + "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" + } + } + } + }, + "/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 + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "description": "base of the pull request to get", + "name": "base", + "in": "path", + "required": true, + "type": "string" + }, + { + "type": "string", + "description": "head of the pull request to get", + "name": "head", + "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/PullRequest" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/lock": { + "put": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Lock an issue", + "operationId": "issueLockIssue", + "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": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/LockIssueOption" + } + }, + { + "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" + } + }, + "consumes": [ + "application/json" + ] + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Unlock an issue", + "operationId": "issueUnlockIssue", + "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 issue", + "name": "index", + "in": "path" + }, + { + "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" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts": { + "get": { + "summary": "Lists all artifacts for a repository", + "operationId": "getArtifacts", + "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": "name of the artifact", + "name": "name", + "in": "query" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/ArtifactsList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/comments": { + "get": { + "tags": [ + "issue" + ], + "summary": "List all comments on an issue", + "operationId": "issueGetComments", + "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": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "type": "string", + "format": "date-time", + "description": "if provided, only comments updated since the specified time are returned.", + "name": "since", + "in": "query" + }, + { + "name": "before", + "in": "query", + "type": "string", + "format": "date-time", + "description": "if provided, only comments updated before the provided time are returned." + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/CommentList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Add a comment to an issue", + "operationId": "issueCreateComment", "parameters": [ { "description": "owner of the repo", @@ -14281,20 +6256,2590 @@ "description": "name of the repo" }, { + "name": "index", + "in": "path", + "required": true, "type": "integer", "format": "int64", - "description": "index of the pull request to edit", + "description": "index of the issue" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateIssueCommentOption" + } + }, + { + "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" + }, + "201": { + "$ref": "#/responses/Comment" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/pinned": { + "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/IssueList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's pinned issues", + "operationId": "repoListPinnedIssues" + } + }, + "/repos/{owner}/group/{group_id}/{repo}": { + "get": { + "operationId": "repoGet", + "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", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Repository" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a repository" + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a repository", + "operationId": "repoDelete", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo to delete", + "name": "owner" + }, + { + "type": "string", + "description": "name of the repo to delete", + "name": "repo", + "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": { + "parameters": [ + { + "type": "string", + "description": "owner of the repo to edit", + "name": "owner", + "in": "path", + "required": true + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo to edit" + }, + { + "schema": { + "$ref": "#/definitions/EditRepoOption" + }, + "description": "Properties of a repo that you can edit", + "name": "body", + "in": "body" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Repository" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Edit a repository's properties. Only fields that are set will be changed.", + "operationId": "repoEdit" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/times": { + "get": { + "tags": [ + "issue" + ], + "summary": "List an issue's tracked times", + "operationId": "issueTrackedTimes", + "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 + }, + { + "format": "int64", + "description": "index of the issue", "name": "index", "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "user", + "in": "query", + "type": "string", + "description": "optional filter by user (available for issue managers)" + }, + { + "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" + }, + { + "format": "date-time", + "description": "Only show times updated before the given time. This is a timestamp in RFC 3339 format", + "name": "before", + "in": "query", + "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": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/TrackedTimeList" + } + }, + "produces": [ + "application/json" + ] + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Add tracked time to a issue", + "operationId": "issueAddTime", + "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" + }, + { + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "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" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TrackedTime" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ] + }, + "delete": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Reset a tracked time of an issue", + "operationId": "issueResetTime", + "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 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" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's releases", + "operationId": "repoListReleases", + "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": "query", + "type": "boolean", + "description": "filter (exclude / include) drafts, if you dont have repo write access none will show", + "name": "draft" + }, + { + "in": "query", + "type": "boolean", + "description": "filter (exclude / include) pre-releases", + "name": "pre-release" + }, + { + "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/ReleaseList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "summary": "Create a release", + "operationId": "repoCreateRelease", + "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", + "schema": { + "$ref": "#/definitions/CreateReleaseOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "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}/commits": { + "get": { + "summary": "Get a list of all commits from a repository", + "operationId": "repoGetAllCommits", + "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": "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" + }, + { + "in": "query", + "type": "boolean", + "description": "include diff stats for every commit (disable for speedup, default 'true')", + "name": "stat" + }, + { + "type": "boolean", + "description": "include verification for every commit (disable for speedup, default 'true')", + "name": "verification", + "in": "query" + }, + { + "in": "query", + "type": "boolean", + "description": "include a list of affected files for every commit (disable for speedup, default 'true')", + "name": "files" + }, + { + "type": "integer", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "description": "page size of results (ignored if used with 'path')", + "name": "limit", + "in": "query", + "type": "integer" + }, + { + "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}/git/blobs/{sha}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Gets the blob of a repository.", + "operationId": "GetBlob", + "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" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/GitBlobResponse" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/milestones": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get all of a repository's opened milestones", + "operationId": "issueGetMilestonesList", + "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": "Milestone state, Recognized values are open, closed and all. Defaults to \"open\"", + "name": "state", + "in": "query", + "type": "string" + }, + { + "type": "string", + "description": "filter by milestone name", + "name": "name", + "in": "query" + }, + { + "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" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/MilestoneList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "responses": { + "201": { + "$ref": "#/responses/Milestone" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create a milestone", + "operationId": "issueCreateMilestone", + "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/EditPullRequestOption" + "$ref": "#/definitions/CreateMilestoneOption" } }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + } + }, + "/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": [ + { + "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": "the milestone to get, identified by ID and if not available by name", + "name": "id" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Delete a milestone", + "operationId": "issueDeleteMilestone", + "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": "the milestone to delete, identified by ID and if not available by name", + "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" + } + } + }, + "patch": { + "responses": { + "200": { + "$ref": "#/responses/Milestone" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Update a milestone", + "operationId": "issueEditMilestone", + "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": "the milestone to edit, identified by ID and if not available by name", + "name": "id", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditMilestoneOption" + } + }, + { + "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": { + "operationId": "repoGetContentsList", + "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" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "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." + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Modify multiple files in a repository", + "operationId": "repoChangeFiles", + "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", + "required": true, + "schema": { + "$ref": "#/definitions/ChangeFilesOptions" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "201": { + "$ref": "#/responses/FilesResponse" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branch_protections": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/BranchProtectionList" + } + }, + "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" + }, + { + "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" + } + ] + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a branch protections for a repository", + "operationId": "repoCreateBranchProtection", + "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": "body", + "schema": { + "$ref": "#/definitions/CreateBranchProtectionOption" + }, + "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" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/BranchProtection" + }, + "403": { + "$ref": "#/responses/forbidden" + } + } + } + }, + "/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 + }, + { + "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" + }, + { + "description": "include a list of affected files for every commit (disable for speedup, default 'true')", + "name": "files", + "in": "query", + "type": "boolean" + }, + { + "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/CommitList" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/hooks/{id}/tests": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Test a push webhook", + "operationId": "repoTestHook", + "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": "integer", + "format": "int64", + "description": "id of the hook to test", + "name": "id" + }, + { + "description": "The name of the commit/branch/tag, indicates which commit will be loaded to the webhook payload.", + "name": "ref", + "in": "query", + "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" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}": { + "delete": { + "operationId": "issueDeleteComment", + "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" + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "id of comment to delete", + "name": "id", + "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/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "issue" + ], + "summary": "Delete a comment" + }, + "patch": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Edit a comment", + "operationId": "issueEditComment", + "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 to edit", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "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" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Comment" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + }, + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get a comment", + "operationId": "issueGetComment", + "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": "id of the comment", + "name": "id" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Comment" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/comments/{id}": { + "delete": { + "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": "this parameter is ignored", + "name": "index", + "in": "path", + "required": true + }, + { + "description": "id of comment to delete", + "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" + } + }, + "tags": [ + "issue" + ], + "summary": "Delete a comment", + "operationId": "issueDeleteCommentDeprecated", + "deprecated": true + }, + "patch": { + "summary": "Edit a comment", + "operationId": "issueEditCommentDeprecated", + "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": "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": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/Comment" + }, + "204": { + "$ref": "#/responses/empty" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "deprecated": true + } + }, + "/repos/{owner}/group/{group_id}/{repo}/editorconfig/{filepath}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get the EditorConfig definitions of a file in a repository", + "operationId": "repoGetEditorConfig", + "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": "filepath of file to get", + "name": "filepath", + "in": "path", + "required": true + }, + { + "name": "ref", + "in": "query", + "type": "string", + "description": "The name of the commit/branch/tag. Default to the repository’s default branch." + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "description": "success" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/times/{user}": { + "get": { + "summary": "List a user's tracked times in a repo", + "operationId": "userTrackedTimes", + "deprecated": true, + "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 user whose tracked times are to be listed", + "name": "user", + "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" + }, + "200": { + "$ref": "#/responses/TrackedTimeList" + }, + "400": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/transfer/reject": { + "post": { + "tags": [ + "repository" + ], + "summary": "Reject a repo transfer", + "operationId": "rejectRepoTransfer", + "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": { + "200": { + "$ref": "#/responses/Repository" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/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 + }, + { + "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": "#/definitions/ActionRunnersResponse" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/stopwatch/stop": { + "post": { + "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" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Stop an issue's existing stopwatch.", + "operationId": "issueStopStopWatch", + "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" + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue to stop the stopwatch on", + "name": "index", + "in": "path" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/workflows/{workflow_id}": { + "get": { + "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" + }, + { + "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": { + "200": { + "$ref": "#/responses/ActionWorkflow" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "500": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branch_protections/{name}": { + "patch": { + "responses": { + "200": { + "$ref": "#/responses/BranchProtection" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "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 + }, + { + "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" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + }, + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a specific branch protection for the repository", + "operationId": "repoGetBranchProtection", + "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" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/BranchProtection" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "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": [ + { + "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": "name of protected branch", + "name": "name", + "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}/issues/{index}/dependencies": { + "post": { + "tags": [ + "issue" + ], + "summary": "Make the issue in the url depend on the issue in the form.", + "operationId": "issueCreateIssueDependencies", + "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": "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" + ] + }, + "delete": { + "summary": "Remove an issue dependency", + "operationId": "issueRemoveIssueDependencies", + "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" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "index of the issue", + "name": "index" + }, + { + "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" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Issue" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + }, + "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 + }, + { + "type": "string", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "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" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/IssueList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/{id}": { + "delete": { + "responses": { + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "tags": [ + "repository" + ], + "summary": "Delete a release", + "operationId": "repoDeleteRelease", + "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 delete" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + }, + "patch": { + "operationId": "repoEditRelease", + "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 edit", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditReleaseOption" + } + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/Release" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Update a release" + }, + "get": { + "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": "integer", + "format": "int64", + "description": "id of the release to get", + "name": "id", + "in": "path", + "required": true + }, + { + "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" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a release", + "operationId": "repoGetRelease" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/tags/{tag}": { + "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 repo", + "name": "repo" + }, + { + "required": true, + "type": "string", + "description": "tag name of the release to get", + "name": "tag", + "in": "path" + }, + { + "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" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a release by tag name", + "operationId": "repoGetReleaseByTag" + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a release by tag name", + "operationId": "repoDeleteReleaseByTag", + "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": "tag name of the release to delete", + "name": "tag", + "in": "path", + "required": true + }, { "format": "int64", "required": true, @@ -14308,25 +8853,16 @@ "422": { "$ref": "#/responses/validationError" }, - "201": { - "$ref": "#/responses/PullRequest" - }, - "403": { - "$ref": "#/responses/forbidden" + "204": { + "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" - }, - "409": { - "$ref": "#/responses/error" - }, - "412": { - "$ref": "#/responses/error" } } } }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/update": { + "/repos/{owner}/group/{group_id}/{repo}/push_mirrors-sync": { "post": { "produces": [ "application/json" @@ -14334,15 +8870,73 @@ "tags": [ "repository" ], - "summary": "Merge PR's baseBranch into headBranch", - "operationId": "repoUpdatePullRequest", + "summary": "Sync all push mirrored repository", + "operationId": "repoPushMirrorSync", + "parameters": [ + { + "in": "path", + "required": true, + "type": "string", + "description": "owner of the repo to sync", + "name": "owner" + }, + { + "required": true, + "type": "string", + "description": "name of the repo to sync", + "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/empty" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/assignees": { + "get": { + "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", "parameters": [ { - "description": "owner of the repo", "name": "owner", "in": "path", "required": true, - "type": "string" + "type": "string", + "description": "owner of the repo" }, { "required": true, @@ -14351,35 +8945,982 @@ "name": "repo", "in": "path" }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/commits/{ref}/status": { + "get": { + "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", + "operationId": "repoGetCombinedStatusByRef", + "parameters": [ { "in": "path", "required": true, - "type": "integer", - "format": "int64", - "description": "index of the pull request to get", - "name": "index" + "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": "how to update pull request", - "name": "style", - "in": "query", - "enum": [ - "merge", - "rebase" - ] + "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" + }, + { + "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, + "in": "path" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/raw/{filepath}": { + "get": { + "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": "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" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" } ], "responses": { "200": { + "description": "Returns raw file content.", + "schema": { + "type": "file" + } + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/octet-stream" + ], + "tags": [ + "repository" + ], + "summary": "Get a file from a repository", + "operationId": "repoGetRawFile" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/signing-key.pub": { + "get": { + "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" + }, + { + "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}/labels": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get all of a repository's labels", + "operationId": "issueListLabels", + "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" + }, + { + "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" + }, + { + "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/LabelList" + } + } + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create a label", + "operationId": "issueCreateLabel", + "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/CreateLabelOption" + } + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Label" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/blocks": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Block the issue given in the body by the issue in path", + "operationId": "issueCreateIssueBlocking", + "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": "string", + "description": "index of the issue" + }, + { + "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": { + "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 + }, + { + "type": "string", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/IssueMeta" + } + }, + { + "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" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ] + }, + "get": { + "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 + }, + { + "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 + }, + { + "name": "page", + "in": "query", + "type": "integer", + "description": "page number of results to return (1-based)" + }, + { + "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": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/IssueList" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets/{attachment_id}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a release attachment", + "operationId": "repoGetReleaseAttachment", + "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 release", + "name": "id", + "in": "path", + "required": true + }, + { + "format": "int64", + "description": "id of the attachment to get", + "name": "attachment_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": { + "200": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a release attachment", + "operationId": "repoDeleteReleaseAttachment", + "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" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the release", + "name": "id" + }, + { + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the attachment to delete", + "name": "attachment_id", + "in": "path" + }, + { + "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" + } + } + }, + "patch": { + "summary": "Edit a release attachment", + "operationId": "repoEditReleaseAttachment", + "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": "id of the release", + "name": "id", + "in": "path", + "required": true, + "type": "integer" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the attachment to edit", + "name": "attachment_id" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/EditAttachmentOptions" + }, + "name": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "201": { + "$ref": "#/responses/Attachment" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/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" + }, + { + "required": true, + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "workflow status (pending, queued, in_progress, failure, success, skipped)", + "name": "status", + "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" + }, + { + "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}/actions/artifacts/{artifact_id}/zip": { + "get": { + "summary": "Downloads a specific artifact for a workflow run redirects to blob url", + "operationId": "downloadArtifact", + "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 + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "id of the artifact", + "name": "artifact_id" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "302": { + "description": "redirect to the blob download" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/reviewers": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Return all users that can be requested to review in this repo", + "operationId": "repoGetReviewers", + "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": "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}/pulls/{index}/merge": { + "get": { + "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": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { + "description": "pull request has been merged" + }, + "404": { + "description": "pull request has not been merged" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Check if a pull request has been merged", + "operationId": "repoPullRequestIsMerged" + }, + "post": { + "operationId": "repoMergePullRequest", + "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 merge" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/MergePullRequestOption" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "405": { + "$ref": "#/responses/empty" + }, + "409": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Merge a pull request" + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Cancel the scheduled auto merge for the given pull request", + "operationId": "repoCancelScheduledAutoMerge", + "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 merge", + "name": "index" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "204": { "$ref": "#/responses/empty" }, "403": { @@ -14388,17 +9929,22 @@ "404": { "$ref": "#/responses/notFound" }, - "409": { - "$ref": "#/responses/error" - }, - "422": { - "$ref": "#/responses/validationError" + "423": { + "$ref": "#/responses/repoArchivedError" } - } + }, + "produces": [ + "application/json" + ] } }, - "/repos/{owner}/group/{group_id}/{repo}/milestones": { - "get": { + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/labels": { + "delete": { + "tags": [ + "issue" + ], + "summary": "Remove all labels from an issue", + "operationId": "issueClearLabels", "parameters": [ { "type": "string", @@ -14415,17 +9961,1143 @@ "description": "name of the repo" }, { + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path" + }, + { + "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" + } + }, + "produces": [ + "application/json" + ] + }, + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Get an issue's labels", + "operationId": "issueGetLabels", + "parameters": [ + { + "required": true, "type": "string", - "description": "Milestone state, Recognized values are open, closed and all. Defaults to \"open\"", - "name": "state", - "in": "query" + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "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" + }, + { + "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/LabelList" + } + } + }, + "put": { + "responses": { + "200": { + "$ref": "#/responses/LabelList" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Replace an issue's labels", + "operationId": "issueReplaceLabels", + "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": "integer", + "format": "int64" + }, + { + "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" + } + ] + }, + "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": "filter by milestone name", + "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" + } + }, + { + "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" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/releases/{id}/assets": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/AttachmentList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List release's attachments", + "operationId": "repoListReleaseAttachments", + "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 release", + "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" + } + ] + }, + "post": { + "summary": "Create a release attachment", + "operationId": "repoCreateReleaseAttachment", + "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 release", + "name": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "in": "query", + "type": "string", + "description": "name of the attachment", + "name": "name" + }, + { + "type": "file", + "description": "attachment to upload", + "name": "attachment", + "in": "formData" + }, + { + "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/notFound" + }, + "413": { + "$ref": "#/responses/error" + } + }, + "consumes": [ + "multipart/form-data", + "application/octet-stream" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/transfer": { + "post": { + "parameters": [ + { + "description": "owner of the repo to transfer", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "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" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "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}/pulls/{index}/update": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Merge PR's baseBranch into headBranch", + "operationId": "repoUpdatePullRequest", + "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": "index of the pull request to get", + "name": "index", + "in": "path", + "required": true, + "type": "integer", + "format": "int64" + }, + { + "description": "how to update pull request", + "name": "style", + "in": "query", + "enum": [ + "merge", + "rebase" + ], + "type": "string" + }, + { + "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" + }, + "409": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "200": { + "$ref": "#/responses/empty" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments/{id}/assets": { + "get": { + "operationId": "issueListIssueCommentAttachments", + "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" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "id of the comment", + "name": "id" + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "404": { + "$ref": "#/responses/error" + }, + "200": { + "$ref": "#/responses/AttachmentList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List comment's attachments" + }, + "post": { + "responses": { + "404": { + "$ref": "#/responses/error" + }, + "413": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "201": { + "$ref": "#/responses/Attachment" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + } + }, + "consumes": [ + "multipart/form-data" + ], + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "Create a comment attachment", + "operationId": "issueCreateIssueCommentAttachment", + "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": "id of the comment", + "name": "id", + "in": "path" + }, + { + "type": "string", + "description": "name of the attachment", "name": "name", "in": "query" }, + { + "required": true, + "type": "file", + "description": "attachment to upload", + "name": "attachment", + "in": "formData" + }, + { + "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": { + "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": [ + { + "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" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ContentsListResponse" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "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": [ + { + "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": "The name of the commit/branch/tag. Default to the repository’s default branch.", + "name": "ref", + "in": "query" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/GetFilesOptions" + } + }, + { + "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" + } + } + } + }, + "/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" + }, + { + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path", + "required": true + }, + { + "type": "integer", + "format": "int64", + "description": "index of the issue to create or update a deadline on", + "name": "index", + "in": "path", + "required": true + }, + { + "schema": { + "$ref": "#/definitions/EditDeadlineOption" + }, + "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/IssueDeadline" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/assets": { + "get": { + "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": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/AttachmentList" + }, + "404": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "issue" + ], + "summary": "List issue's attachments", + "operationId": "issueListIssueAttachments" + }, + "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" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo" + }, + { + "format": "int64", + "description": "index of the issue", + "name": "index", + "in": "path", + "required": true, + "type": "integer" + }, + { + "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" + }, + "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}/forks": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repository's forks", + "operationId": "listForks", + "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": "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", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RepositoryList" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "post": { + "summary": "Fork a repository", + "operationId": "createFork", + "parameters": [ + { + "description": "owner of the repo to fork", + "name": "owner", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo to fork" + }, + { + "schema": { + "$ref": "#/definitions/CreateForkOption" + }, + "name": "body", + "in": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "description": "The repository with the same name already exists." + }, + "422": { + "$ref": "#/responses/validationError" + }, + "202": { + "$ref": "#/responses/Repository" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/files": { + "get": { + "operationId": "repoGetPullRequestFiles", + "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 to get", + "name": "index", + "in": "path", + "required": true + }, + { + "type": "string", + "description": "skip to given file", + "name": "skip-to", + "in": "query" + }, + { + "name": "whitespace", + "in": "query", + "enum": [ + "ignore-all", + "ignore-change", + "ignore-eol", + "show-all" + ], + "type": "string", + "description": "whitespace behavior" + }, + { + "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" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ChangedFileList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get changed files for a pull request" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/comments": { + "get": { + "tags": [ + "issue" + ], + "summary": "List all comments in a repository", + "operationId": "issueGetRepoComments", + "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", + "format": "date-time", + "description": "if provided, only comments updated since the provided time are returned.", + "name": "since", + "in": "query" + }, + { + "description": "if provided, only comments updated before the provided time are returned.", + "name": "before", + "in": "query", + "type": "string", + "format": "date-time" + }, { "type": "integer", "description": "page number of results to return (1-based)", @@ -14449,7 +11121,7 @@ ], "responses": { "200": { - "$ref": "#/responses/MilestoneList" + "$ref": "#/responses/CommentList" }, "404": { "$ref": "#/responses/notFound" @@ -14457,68 +11129,93 @@ }, "produces": [ "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Get all of a repository's opened milestones", - "operationId": "issueGetMilestonesList" - }, + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/reviews/{id}/dismissals": { "post": { - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "tags": [ - "issue" - ], - "summary": "Create a milestone", - "operationId": "issueCreateMilestone", "parameters": [ { + "type": "string", + "description": "owner of the repo", "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 pull request", + "name": "index", + "in": "path", + "required": true + }, + { + "description": "id of the review", + "name": "id", + "in": "path", "required": true, - "type": "string" + "type": "integer", + "format": "int64" }, { "name": "body", "in": "body", + "required": true, "schema": { - "$ref": "#/definitions/CreateMilestoneOption" + "$ref": "#/definitions/DismissPullReviewOptions" } }, { - "in": "path", - "description": "group ID of the repo", - "name": "group_id", "type": "integer", "format": "int64", - "required": true + "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" }, - "201": { - "$ref": "#/responses/Milestone" + "422": { + "$ref": "#/responses/validationError" } - } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Dismiss a review for a pull request", + "operationId": "repoDismissPullReview" } }, - "/repos/{owner}/group/{group_id}/{repo}/contents-ext/{filepath}": { + "/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", @@ -14535,24 +11232,641 @@ "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", + "type": "string", + "description": "a git ref or commit sha", + "name": "sha", + "in": "path", + "required": true + }, + { + "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" + }, + { + "type": "boolean", + "description": "include a list of affected files for every commit (disable for speedup, default 'true')", + "name": "files", + "in": "query" + }, + { + "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/Commit" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/topics/{topic}": { + "put": { + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/invalidTopicsError" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Add a topic to a repository", + "operationId": "repoAddTopic", + "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": "string", + "description": "name of the topic to add", + "name": "topic", + "in": "path" + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ] + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a topic from a repository", + "operationId": "repoDeleteTopic", + "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 topic to delete", + "name": "topic", + "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/invalidTopicsError" + }, + "204": { + "$ref": "#/responses/empty" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}/jobs": { + "get": { + "summary": "Lists all jobs for a workflow run", + "operationId": "listWorkflowRunJobs", + "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": "runid of the workflow run", + "name": "run", + "in": "path", + "required": true + }, + { + "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" + }, + { + "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": { + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "$ref": "#/responses/WorkflowJobsList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runners/{runner_id}": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get an repo-level runner", + "operationId": "getRepoRunner", + "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": "string", + "description": "id of the runner", + "name": "runner_id", + "in": "path", + "required": true + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "200": { + "$ref": "#/definitions/ActionRunner" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "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 + }, + { + "description": "id of the runner", + "name": "runner_id", + "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": { + "description": "runner has been deleted" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branches/{branch}": { + "get": { + "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" + }, + { + "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" + "description": "branch to get", + "name": "branch", + "in": "path", + "required": true }, { - "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", + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/Branch" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Delete a specific branch from a repository", + "operationId": "repoDeleteBranch", + "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": "branch to delete", + "name": "branch", + "in": "path" + }, + { + "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/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 + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the branch", + "name": "branch" + }, + { + "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": { + "422": { + "$ref": "#/responses/validationError" + }, + "204": { + "$ref": "#/responses/empty" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/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 + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TagProtectionList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List tag protections for a repository" + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a tag protections for a repository", + "operationId": "repoCreateTagProtection", + "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": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateTagProtectionOption" + } + }, + { + "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/TagProtection" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + }, + "consumes": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/subscriptions/{user}": { + "put": { + "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 issue", + "name": "index" + }, + { + "required": true, + "type": "string", + "description": "username of the user to subscribe the issue to", + "name": "user", + "in": "path" + }, { "description": "group ID of the repo", "name": "group_id", @@ -14564,32 +11878,63 @@ ], "responses": { "200": { - "$ref": "#/responses/ContentsExtResponse" + "description": "Already subscribed" + }, + "201": { + "description": "Successfully Subscribed" + }, + "304": { + "description": "User can only subscribe itself if he is no admin" }, "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.", + "consumes": [ + "application/json" + ], "produces": [ "application/json" ], "tags": [ - "repository" + "issue" ], - "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": { + "summary": "Subscribe user to issue", + "operationId": "issueAddSubscription" + }, + "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": [ { + "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", - "required": true, - "type": "string" + "required": true }, { "name": "repo", @@ -14608,29 +11953,64 @@ }, { "type": "string", - "format": "date-time", - "description": "if provided, only comments updated since the specified time are returned.", - "name": "since", - "in": "query" + "description": "username of the user to unsubscribe from an issue", + "name": "user", + "in": "path", + "required": true }, { - "name": "page", - "in": "query", + "name": "group_id", "type": "integer", - "description": "page number of results to return (1-based)" - }, + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}.{diffType}": { + "get": { + "operationId": "repoDownloadPullDiffOrPatch", + "parameters": [ { - "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", + "required": true, "type": "string", - "format": "date-time" + "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 pull request to get" + }, + { + "in": "path", + "required": true, + "enum": [ + "diff", + "patch" + ], + "type": "string", + "description": "whether the output is diff or patch", + "name": "diffType" + }, + { + "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", @@ -14643,32 +12023,28 @@ ], "responses": { "200": { - "$ref": "#/responses/TimelineList" + "$ref": "#/responses/string" }, "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" + "text/plain" ], "tags": [ "repository" ], - "summary": "List the Git hooks in a repository", - "operationId": "repoListGitHooks", + "summary": "Get a pull request diff or patch" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/branches": { + "get": { + "tags": [ + "repository" + ], + "summary": "List a repository's branches", + "operationId": "repoListBranches", "parameters": [ { "type": "string", @@ -14684,6 +12060,249 @@ "name": "repo", "in": "path" }, + { + "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": { + "200": { + "$ref": "#/responses/BranchList" + } + }, + "produces": [ + "application/json" + ] + }, + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a branch", + "operationId": "repoCreateBranch", + "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" + }, + { + "in": "body", + "schema": { + "$ref": "#/definitions/CreateBranchRepoOption" + }, + "name": "body" + }, + { + "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" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/stargazers": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/UserList" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's stargazers", + "operationId": "repoListStargazers", + "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", + "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" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/merge-upstream": { + "post": { + "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/MergeUpstreamRequest" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/MergeUpstreamResponse" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Merge a branch from upstream", + "operationId": "repoMergeUpstream" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/contents-ext/{filepath}": { + "get": { + "summary": "The extended \"contents\" API, to get file metadata and/or content, or list a directory.", + "operationId": "repoGetContentsExt", + "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 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", + "description": "the name of the commit/branch/tag, default to the repository’s default branch.", + "name": "ref", + "in": "query" + }, + { + "name": "includes", + "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." + }, { "type": "integer", "format": "int64", @@ -14695,18 +12314,722 @@ ], "responses": { "200": { - "$ref": "#/responses/GitHookList" + "$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" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/contents/{filepath}": { + "put": { + "responses": { + "423": { + "$ref": "#/responses/repoArchivedError" + }, + "200": { + "$ref": "#/responses/FileResponse" + }, + "201": { + "$ref": "#/responses/FileResponse" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/error" + } + }, + "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": [ + { + "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 update", + "name": "filepath", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/UpdateFileOptions" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + }, + "post": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a file in a repository", + "operationId": "repoCreateFile", + "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 create", + "name": "filepath", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/CreateFileOptions" + } + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "201": { + "$ref": "#/responses/FileResponse" + }, + "403": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/error" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + } + }, + "delete": { + "summary": "Delete a file in a repository", + "operationId": "repoDeleteFile", + "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": "path of the file to delete", + "name": "filepath" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/DeleteFileOptions" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "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" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + }, + "get": { + "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 + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "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" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "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.", + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/artifacts/{artifact_id}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/Artifact" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets a specific artifact for a workflow run", + "operationId": "getArtifact", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "name of the repository", + "name": "repo" + }, + { + "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" + } + ] + }, + "delete": { + "operationId": "deleteArtifact", + "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 + }, + { + "in": "path", + "required": true, + "type": "string", + "description": "id of the artifact", + "name": "artifact_id" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "responses": { + "204": { + "description": "No Content" + }, + "400": { + "$ref": "#/responses/error" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Deletes a specific artifact for a workflow run" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/keys": { + "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 + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "key_id", + "in": "query", + "type": "integer", + "description": "the key_id to search for" + }, + { + "description": "fingerprint of the key", + "name": "fingerprint", + "in": "query", + "type": "string" + }, + { + "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" + }, + { + "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": { + "operationId": "repoCreateKey", + "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": "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" } }, - "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/requested_reviewers": { + "/repos/{owner}/group/{group_id}/{repo}/pulls": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/PullRequestList" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "500": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List a repo's pull requests", + "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" + }, + { + "default": "open", + "description": "State of pull request", + "name": "state", + "in": "query", + "enum": [ + "open", + "closed", + "all" + ], + "type": "string" + }, + { + "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" + }, + { + "collectionFormat": "multi", + "description": "Label IDs", + "name": "labels", + "in": "query", + "type": "array", + "items": { + "format": "int64", + "type": "integer" + } + }, + { + "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)" + }, + { + "type": "integer", + "description": "Page size of results", + "name": "limit", + "in": "query", + "minimum": 0 + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ] + }, "post": { - "summary": "create review requests for a pull request", - "operationId": "repoCreatePullReviewRequests", + "operationId": "repoCreatePullRequest", + "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": "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": { + "201": { + "$ref": "#/responses/PullRequest" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create a pull request" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/tag_protections/{id}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/TagProtection" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a specific tag protection for the repository", + "operationId": "repoGetTagProtection", "parameters": [ { "description": "owner of the repo", @@ -14723,36 +13046,142 @@ "required": true }, { - "type": "integer", - "format": "int64", - "description": "index of the pull request", - "name": "index", + "description": "id of the tag protect to get", + "name": "id", "in": "path", - "required": true + "required": true, + "type": "integer" }, { - "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, + "in": "path" + } + ] + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a specific tag protection for the repository", + "operationId": "repoDeleteTagProtection", + "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": "integer", + "description": "id of protected tag", + "name": "id", + "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" + } + }, + "produces": [ + "application/json" + ] + }, + "patch": { + "tags": [ + "repository" + ], + "summary": "Edit a tag protections for a repository. Only fields that are set will be changed", + "operationId": "repoEditTagProtection", + "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", + "description": "id of protected tag", + "name": "id" + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/EditTagProtectionOption" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TagProtection" + }, + "404": { + "$ref": "#/responses/notFound" + }, "422": { "$ref": "#/responses/validationError" }, - "201": { - "$ref": "#/responses/PullReviewList" + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/commits/{sha}/pull": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/PullRequest" }, "404": { "$ref": "#/responses/notFound" @@ -14763,17 +13192,52 @@ ], "tags": [ "repository" - ] - }, - "delete": { + ], + "summary": "Get the merged pull request of the commit", + "operationId": "repoGetCommitPullRequest", "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": "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" + } + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/diffpatch": { + "post": { + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repo", + "name": "owner", + "in": "path" + }, { "required": true, "type": "string", @@ -14782,19 +13246,130 @@ "in": "path" }, { + "in": "body", "required": true, + "schema": { + "$ref": "#/definitions/ApplyDiffPatchFileOptions" + }, + "name": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "200": { + "$ref": "#/responses/FileResponse" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "423": { + "$ref": "#/responses/repoArchivedError" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Apply diff patch to repository", + "operationId": "repoApplyDiffPatch" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/topics": { + "get": { + "tags": [ + "repository" + ], + "summary": "Get list of topics that a repository has", + "operationId": "repoListTopics", + "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": "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", - "description": "index of the pull request", - "name": "index", + "required": true, "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/TopicNames" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + }, + "put": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Replace list of topics for a repository", + "operationId": "repoUpdateTopics", + "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/PullReviewRequestOptions" + "$ref": "#/definitions/RepoTopicOptions" } }, { @@ -14806,6 +13381,58 @@ "description": "group ID of the repo" } ], + "responses": { + "204": { + "$ref": "#/responses/empty" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/invalidTopicsError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/issues/{index}/pin": { + "post": { + "tags": [ + "issue" + ], + "summary": "Pin an Issue", + "operationId": "pinIssue", + "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 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": { "204": { "$ref": "#/responses/empty" @@ -14815,9 +13442,201 @@ }, "404": { "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "tags": [ + "issue" + ], + "summary": "Unpin an Issue", + "operationId": "unpinIssue", + "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 issue to unpin", + "name": "index", + "in": "path" + }, + { + "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" + } + } + } + }, + "/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" + }, + { + "required": true, + "type": "string", + "description": "name of the repo", + "name": "repo", + "in": "path" + }, + { + "name": "workflow_id", + "in": "path", + "required": true, + "type": "string", + "description": "id of the workflow" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "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}/new_pin_allowed": { + "get": { + "tags": [ + "repository" + ], + "summary": "Returns if new Issue Pins are allowed", + "operationId": "repoNewPinAllowed", + "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": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "responses": { + "200": { + "$ref": "#/responses/RepoNewIssuePinsAllowed" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ] + } + }, + "/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 + }, + { + "type": "string", + "description": "name of the repo to sync", + "name": "repo", + "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/empty" + }, + "403": { + "$ref": "#/responses/forbidden" } }, "produces": [ @@ -14825,18 +13644,247 @@ ], "tags": [ "repository" - ], - "summary": "cancel review requests for a pull request", - "operationId": "repoDeletePullReviewRequests" + ] } }, - "/repos/{owner}/group/{group_id}/{repo}/collaborators/{collaborator}/permission": { + "/repos/{owner}/group/{group_id}/{repo}/actions/secrets/{secretname}": { + "put": { + "operationId": "updateRepoSecret", + "parameters": [ + { + "type": "string", + "description": "owner of the repository", + "name": "owner", + "in": "path", + "required": true + }, + { + "required": true, + "type": "string", + "description": "name of the repository", + "name": "repo", + "in": "path" + }, + { + "type": "string", + "description": "name of the secret", + "name": "secretname", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateOrUpdateSecretOption" + } + }, + { + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true + } + ], + "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" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Create or Update a secret value in a repository" + }, + "delete": { + "summary": "Delete a secret in a repository", + "operationId": "deleteRepoSecret", + "parameters": [ + { + "required": true, + "type": "string", + "description": "owner of the repository", + "name": "owner", + "in": "path" + }, + { + "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 + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "204": { + "description": "delete one secret of the repository" + }, + "400": { + "$ref": "#/responses/error" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}": { "get": { "tags": [ "repository" ], - "summary": "Get repository permissions for a user", - "operationId": "repoGetRepoPermissions", + "summary": "Gets a specific workflow run", + "operationId": "GetWorkflowRun", + "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": "string", + "description": "id of the run", + "name": "run", + "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/WorkflowRun" + }, + "400": { + "$ref": "#/responses/error" + } + }, + "produces": [ + "application/json" + ] + }, + "delete": { + "tags": [ + "repository" + ], + "summary": "Delete a workflow run", + "operationId": "deleteActionRun", + "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" + }, + { + "type": "integer", + "description": "runid of the workflow run", + "name": "run", + "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" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/pulls/{index}/requested_reviewers": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "create review requests for a pull request", + "operationId": "repoCreatePullReviewRequests", "parameters": [ { "type": "string", @@ -14853,11 +13901,81 @@ "name": "repo" }, { - "name": "collaborator", + "name": "index", "in": "path", "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request" + }, + { + "required": true, + "schema": { + "$ref": "#/definitions/PullReviewRequestOptions" + }, + "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/PullReviewList" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + }, + "delete": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "cancel review requests for a pull request", + "operationId": "repoDeletePullReviewRequests", + "parameters": [ + { "type": "string", - "description": "username of the collaborator whose permissions are to be obtained" + "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" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/PullReviewRequestOptions" + } }, { "required": true, @@ -14869,22 +13987,766 @@ } ], "responses": { - "200": { - "$ref": "#/responses/RepoCollaboratorPermission" + "204": { + "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, + "404": { + "$ref": "#/responses/notFound" + }, + "422": { + "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/git/tags/{sha}": { + "get": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Gets the tag object of an annotated tag (not lightweight tags)", + "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 + }, + { + "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/AnnotatedTag" + }, + "400": { + "$ref": "#/responses/error" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/archive/{archive}": { + "get": { + "operationId": "repoGetArchive", + "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": "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", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "200": { + "description": "success" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get an archive of a repository" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/media/{filepath}": { + "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" + }, + { + "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" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ], + "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}/pulls/{index}": { + "get": { + "responses": { + "200": { + "$ref": "#/responses/PullRequest" + }, "404": { "$ref": "#/responses/notFound" } }, "produces": [ "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get a pull request", + "operationId": "repoGetPullRequest", + "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" + }, + { + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the pull request to get", + "name": "index" + }, + { + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo" + } + ] + }, + "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": [ + { + "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 to edit", + "name": "index", + "in": "path", + "required": true + }, + { + "schema": { + "$ref": "#/definitions/EditPullRequestOption" + }, + "name": "body", + "in": "body" + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "responses": { + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/error" + }, + "412": { + "$ref": "#/responses/error" + }, + "422": { + "$ref": "#/responses/validationError" + }, + "201": { + "$ref": "#/responses/PullRequest" + }, + "403": { + "$ref": "#/responses/forbidden" + } + } + } + }, + "/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 + }, + { + "name": "repo", + "in": "path", + "required": true, + "type": "string", + "description": "name of the repo" + }, + { + "format": "int64", + "description": "id of the hook to get", + "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/Hook" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + }, + "delete": { + "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" + }, + { + "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": { + "operationId": "repoEditHook", + "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": "id", + "in": "path", + "required": true, + "type": "integer", + "format": "int64", + "description": "index of the hook" + }, + { + "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 hook in a repository" + } + }, + "/repos/{owner}/group/{group_id}/{repo}/subscribers": { + "get": { + "summary": "List a repo's watchers", + "operationId": "repoListSubscribers", + "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" + }, + { + "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" + }, + { + "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/UserList" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" ] } }, - "/repos/{owner}/group/{group_id}/{repo}/actions/runs/{run}/artifacts": { + "/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": [ + { + "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": "string", + "description": "id of the workflow", + "name": "workflow_id", + "in": "path", + "required": true + }, + { + "name": "body", + "in": "body", + "schema": { + "$ref": "#/definitions/CreateActionWorkflowDispatch" + } + }, + { + "type": "integer", + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id" + } + ], + "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}/notifications": { + "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": [ + { + "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" + }, + { + "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" + }, + "collectionFormat": "multi" + }, + { + "type": "string", + "description": "Status to mark notifications as. Defaults to read.", + "name": "to-status", + "in": "query" + }, + { + "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", + "type": "string" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ], + "responses": { + "205": { + "$ref": "#/responses/NotificationThreadList" + } + } + }, + "get": { + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "notification" + ], + "summary": "List users's notification threads on a specific repo", + "operationId": "notifyGetRepoList", + "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": "boolean", + "description": "If true, show notifications marked as read. Default value is false", + "name": "all" + }, + { + "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", + "type": "array" + }, + { + "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", + "in": "query" + }, + { + "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" + }, + { + "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/NotificationThreadList" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/actions/secrets": { "get": { "parameters": [ { @@ -14902,126 +14764,16 @@ "required": true }, { - "required": true, "type": "integer", - "description": "runid of the workflow run", - "name": "run", - "in": "path" - }, - { - "type": "string", - "description": "name of the artifact", - "name": "name", + "description": "page number of results to return (1-based)", + "name": "page", "in": "query" }, { - "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" - } - }, - "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" - } + "description": "page size of results", + "name": "limit", + "in": "query" }, { "name": "group_id", @@ -15033,20 +14785,268 @@ } ], "responses": { - "204": { - "$ref": "#/responses/empty" + "200": { + "$ref": "#/responses/SecretList" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "List an repo's actions secrets", + "operationId": "repoListActionsSecrets" + } + }, + "/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": [ + { + "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": "a git ref or commit sha", + "name": "sha", + "in": "path" + }, + { + "in": "query", + "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" + }, + { + "format": "int64", + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Note" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" + } + } + } + }, + "/repos/{owner}/group/{group_id}/{repo}/wiki/new": { + "post": { + "summary": "Create a wiki page", + "operationId": "repoCreateWikiPage", + "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/CreateWikiPageOptions" + } + }, + { + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64", + "required": true, + "in": "path" + } + ], + "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" + ] + } + }, + "/repos/{owner}/group/{group_id}/{repo}/push_mirrors": { + "post": { + "responses": { + "200": { + "$ref": "#/responses/PushMirror" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "add a push mirror to the repository", + "operationId": "repoAddPushMirror", + "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": "body", + "schema": { + "$ref": "#/definitions/CreatePushMirrorOption" + }, + "name": "body" + }, + { + "required": true, + "in": "path", + "description": "group ID of the repo", + "name": "group_id", + "type": "integer", + "format": "int64" + } + ] + }, + "get": { + "operationId": "repoListPushMirrors", + "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", + "description": "page number of results to return (1-based)", + "name": "page", + "in": "query" + }, + { + "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/PushMirrorList" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + } + }, + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Get all push mirrors of the repository" } } } -} \ No newline at end of file +}