From ce1bb5f0ba0ce5fcae90061f134d2b6164bf44e8 Mon Sep 17 00:00:00 2001 From: Gitea Bot Date: Mon, 3 Aug 2026 00:22:43 +0000 Subject: [PATCH] Update swagger-latest.json (#482) Automated update of static/swagger-latest.json from the gitea main branch, opened by the "update swagger files" scheduled workflow. Reviewed-on: https://gitea.com/gitea/docs/pulls/482 Reviewed-by: Lunny Xiao Co-authored-by: Gitea Bot --- static/swagger-latest.json | 559 ++++++++++++++++++++++--------------- 1 file changed, 337 insertions(+), 222 deletions(-) diff --git a/static/swagger-latest.json b/static/swagger-latest.json index 4ff281b3..6fa93e62 100644 --- a/static/swagger-latest.json +++ b/static/swagger-latest.json @@ -5457,6 +5457,58 @@ } } }, + "/repos/{owner}/{repo}/actions/runs/{run}/approve": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Approve a workflow run that requires approval", + "operationId": "approveWorkflowRun", + "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": "run ID", + "name": "run", + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/WorkflowRun" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/conflict" + } + } + } + }, "/repos/{owner}/{repo}/actions/runs/{run}/artifacts": { "get": { "produces": [ @@ -5633,6 +5685,58 @@ } } }, + "/repos/{owner}/{repo}/actions/runs/{run}/cancel": { + "post": { + "produces": [ + "application/json" + ], + "tags": [ + "repository" + ], + "summary": "Cancel a workflow run and its jobs", + "operationId": "cancelWorkflowRun", + "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": "run ID", + "name": "run", + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "$ref": "#/responses/WorkflowRun" + }, + "400": { + "$ref": "#/responses/error" + }, + "403": { + "$ref": "#/responses/forbidden" + }, + "404": { + "$ref": "#/responses/notFound" + }, + "409": { + "$ref": "#/responses/conflict" + } + } + } + }, "/repos/{owner}/{repo}/actions/runs/{run}/jobs": { "get": { "produces": [ @@ -5774,6 +5878,49 @@ } } }, + "/repos/{owner}/{repo}/actions/runs/{run}/logs": { + "get": { + "produces": [ + "application/zip" + ], + "tags": [ + "repository" + ], + "summary": "Download workflow run logs as archive", + "operationId": "getWorkflowRunLogs", + "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": "run ID", + "name": "run", + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "description": "Logs archive" + }, + "404": { + "$ref": "#/responses/notFound" + } + } + } + }, "/repos/{owner}/{repo}/actions/runs/{run}/rerun": { "post": { "produces": [ @@ -5889,7 +6036,7 @@ "tags": [ "repository" ], - "summary": "List an repo's actions secrets", + "summary": "List a repo's actions secrets", "operationId": "repoListActionsSecrets", "parameters": [ { @@ -16196,6 +16343,12 @@ "name": "pre-release", "in": "query" }, + { + "type": "string", + "description": "filter releases by tag. supports \"*\" as a wildcard (for example: v1*, *beta, *rc*).", + "name": "tag_filter", + "in": "query" + }, { "type": "integer", "description": "page number of results to return (1-based)", @@ -20906,7 +21059,6 @@ "application/json" ], "tags": [ - "repository", "user" ], "summary": "Create a repository", @@ -22513,6 +22665,14 @@ "actor": { "$ref": "#/definitions/User" }, + "artifacts_url": { + "type": "string", + "x-go-name": "ArtifactsURL" + }, + "cancel_url": { + "type": "string", + "x-go-name": "CancelURL" + }, "completed_at": { "type": "string", "format": "date-time", @@ -22522,6 +22682,11 @@ "type": "string", "x-go-name": "Conclusion" }, + "created_at": { + "type": "string", + "format": "date-time", + "x-go-name": "CreatedAt" + }, "display_title": { "type": "string", "x-go-name": "DisplayTitle" @@ -22550,6 +22715,14 @@ "format": "int64", "x-go-name": "ID" }, + "jobs_url": { + "type": "string", + "x-go-name": "JobsURL" + }, + "logs_url": { + "type": "string", + "x-go-name": "LogsURL" + }, "path": { "type": "string", "x-go-name": "Path" @@ -22574,6 +22747,10 @@ "format": "int64", "x-go-name": "RepositoryID" }, + "rerun_url": { + "type": "string", + "x-go-name": "RerunURL" + }, "run_attempt": { "description": "RunAttempt is 1-based for runs created after ActionRunAttempt was introduced.\nA value of 0 is a legacy-only sentinel for runs created before attempts existed\nand indicates no corresponding /attempts/{n} resource is available.", "type": "integer", @@ -22597,6 +22774,11 @@ "trigger_actor": { "$ref": "#/definitions/User" }, + "updated_at": { + "type": "string", + "format": "date-time", + "x-go-name": "UpdatedAt" + }, "url": { "type": "string", "x-go-name": "URL" @@ -22762,7 +22944,7 @@ "type": "object", "properties": { "permission": { - "description": "Permission level to grant the collaborator\nread RepoWritePermissionRead\nwrite RepoWritePermissionWrite\nadmin RepoWritePermissionAdmin", + "description": "Permission level to grant the collaborator", "type": "string", "enum": [ "read", @@ -22917,6 +23099,7 @@ "x-go-name": "DownloadURL" }, "created_at": { + "description": "Created is the time when the attachment was uploaded", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -23052,6 +23235,10 @@ "type": "boolean", "x-go-name": "BlockAdminMergeOverride" }, + "block_on_codeowner_reviews": { + "type": "boolean", + "x-go-name": "BlockOnCodeownerReviews" + }, "block_on_official_review_requests": { "type": "boolean", "x-go-name": "BlockOnOfficialReviewRequests" @@ -23065,8 +23252,8 @@ "x-go-name": "BlockOnRejectedReviews" }, "branch_name": { - "description": "Deprecated: true", "type": "string", + "x-deprecated": true, "x-go-name": "BranchName" }, "bypass_allowlist_teams": { @@ -23389,7 +23576,7 @@ "x-go-name": "SHA" }, "state": { - "description": "State is the overall combined status state\npending CommitStatusPending is for when the CommitStatus is Pending\nsuccess CommitStatusSuccess is for when the CommitStatus is Success\nerror CommitStatusError is for when the CommitStatus is Error\nfailure CommitStatusFailure is for when the CommitStatus is Failure\nwarning CommitStatusWarning is for when the CommitStatus is Warning\nskipped CommitStatusSkipped is for when CommitStatus is Skipped", + "description": "State is the overall combined status state", "type": "string", "enum": [ "pending", @@ -23503,6 +23690,7 @@ "$ref": "#/definitions/User" }, "created": { + "description": "Created is the time when the commit was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -23566,11 +23754,13 @@ "type": "object", "properties": { "author": { + "description": "Author is the author date for the commit", "type": "string", "format": "date-time", "x-go-name": "Author" }, "committer": { + "description": "Committer is the committer date for the commit", "type": "string", "format": "date-time", "x-go-name": "Committer" @@ -23583,6 +23773,7 @@ "title": "CommitMeta contains meta information of a commit in terms of API.", "properties": { "created": { + "description": "Created is the time when the commit was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -23654,7 +23845,7 @@ "x-go-name": "ID" }, "status": { - "description": "State represents the status state (pending, success, error, failure)\npending CommitStatusPending is for when the CommitStatus is Pending\nsuccess CommitStatusSuccess is for when the CommitStatus is Success\nerror CommitStatusError is for when the CommitStatus is Error\nfailure CommitStatusFailure is for when the CommitStatus is Failure\nwarning CommitStatusWarning is for when the CommitStatus is Warning\nskipped CommitStatusSkipped is for when CommitStatus is Skipped", + "description": "State represents the status state (pending, success, error, failure)", "type": "string", "enum": [ "pending", @@ -23695,6 +23886,7 @@ "x-go-name": "Date" }, "email": { + "description": "Email is the person's email address", "type": "string", "format": "email", "x-go-name": "Email" @@ -23926,6 +24118,10 @@ "type": "boolean", "x-go-name": "BlockAdminMergeOverride" }, + "block_on_codeowner_reviews": { + "type": "boolean", + "x-go-name": "BlockOnCodeownerReviews" + }, "block_on_official_review_requests": { "type": "boolean", "x-go-name": "BlockOnOfficialReviewRequests" @@ -23939,8 +24135,8 @@ "x-go-name": "BlockOnRejectedReviews" }, "branch_name": { - "description": "Deprecated: true", "type": "string", + "x-deprecated": true, "x-go-name": "BranchName" }, "bypass_allowlist_teams": { @@ -24097,9 +24293,10 @@ "x-go-name": "BranchName" }, "old_branch_name": { - "description": "Deprecated: true\nName of the old branch to create from", + "description": "Name of the old branch to create from", "type": "string", "uniqueItems": true, + "x-deprecated": true, "x-go-name": "OldBranchName" }, "old_ref_name": { @@ -24222,6 +24419,7 @@ ], "properties": { "active": { + "description": "Whether the webhook should be active upon creation", "type": "boolean", "default": false, "x-go-name": "Active" @@ -24253,6 +24451,7 @@ "x-go-name": "Name" }, "type": { + "description": "The type of the webhook to create", "type": "string", "enum": [ "dingtalk", @@ -24287,6 +24486,7 @@ ], "properties": { "body": { + "description": "Body is the comment text content", "type": "string", "x-go-name": "Body" } @@ -24417,6 +24617,7 @@ "example": false }, "name": { + "description": "Name is the display name for the new label", "type": "string", "x-go-name": "Name" } @@ -24433,11 +24634,13 @@ "x-go-name": "Description" }, "due_on": { + "description": "Deadline is the due date for the milestone", "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "state": { + "description": "State indicates the initial state of the milestone", "type": "string", "enum": [ "open", @@ -24541,14 +24744,14 @@ "x-go-name": "UserName" }, "visibility": { - "description": "possible values are `public` (default), `limited` or `private`\npublic UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "description": "possible values are `public` (default), `limited` or `private`", "type": "string", "enum": [ "public", "limited", "private" ], - "x-go-enum-desc": "public UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "x-go-enum-desc": "public VisibilityStringPublic\nlimited VisibilityStringLimited\nprivate VisibilityStringPrivate", "x-go-name": "Visibility" }, "website": { @@ -24833,7 +25036,7 @@ "x-go-name": "Name" }, "object_format_name": { - "description": "ObjectFormatName of the underlying git repository, empty string for default (sha1)\nsha1 ObjectFormatSHA1\nsha256 ObjectFormatSHA256", + "description": "ObjectFormatName of the underlying git repository, empty string for default (sha1)", "type": "string", "enum": [ "sha1", @@ -24886,7 +25089,7 @@ "x-go-name": "Description" }, "state": { - "description": "State represents the status state to set (pending, success, error, failure)\npending CommitStatusPending is for when the CommitStatus is Pending\nsuccess CommitStatusSuccess is for when the CommitStatus is Success\nerror CommitStatusError is for when the CommitStatus is Error\nfailure CommitStatusFailure is for when the CommitStatus is Failure\nwarning CommitStatusWarning is for when the CommitStatus is Warning\nskipped CommitStatusSkipped is for when CommitStatus is Skipped", + "description": "State represents the status state to set (pending, success, error, failure)", "type": "string", "enum": [ "pending", @@ -24920,6 +25123,7 @@ "x-go-name": "Message" }, "tag_name": { + "description": "The name of the tag to create", "type": "string", "x-go-name": "TagName" }, @@ -24996,18 +25200,20 @@ "x-go-name": "Permission" }, "units": { + "description": "Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.", "type": "array", "items": { "type": "string" }, + "x-deprecated": true, "x-go-name": "Units", "example": [ "repo.actions", + "repo.packages", "repo.code", "repo.issues", "repo.ext_issues", "repo.wiki", - "repo.ext_wiki", "repo.pulls", "repo.releases", "repo.projects", @@ -25020,10 +25226,21 @@ "type": "string" }, "x-go-name": "UnitsMap", - "example": "{\"repo.actions\",\"repo.packages\",\"repo.code\":\"read\",\"repo.issues\":\"write\",\"repo.ext_issues\":\"none\",\"repo.wiki\":\"admin\",\"repo.pulls\":\"owner\",\"repo.releases\":\"none\",\"repo.projects\":\"none\",\"repo.ext_wiki\":\"none\"}" + "example": { + "repo.actions": "read", + "repo.code": "read", + "repo.ext_issues": "none", + "repo.ext_wiki": "none", + "repo.issues": "write", + "repo.packages": "read", + "repo.projects": "none", + "repo.pulls": "owner", + "repo.releases": "none", + "repo.wiki": "admin" + } }, "visibility": { - "description": "Team visibility within the organization. Defaults to \"private\".\npublic TeamVisibilityPublic\nlimited TeamVisibilityLimited\nprivate TeamVisibilityPrivate", + "description": "Team visibility within the organization. Defaults to \"private\".", "type": "string", "enum": [ "public", @@ -25052,7 +25269,6 @@ }, "email": { "type": "string", - "format": "email", "x-go-name": "Email" }, "full_name": { @@ -25098,14 +25314,14 @@ "x-go-name": "Username" }, "visibility": { - "description": "User visibility level: public, limited, or private\npublic UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "description": "User visibility level: public, limited, or private", "type": "string", "enum": [ "public", "limited", "private" ], - "x-go-enum-desc": "public UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "x-go-enum-desc": "public VisibilityStringPublic\nlimited VisibilityStringLimited\nprivate VisibilityStringPrivate", "x-go-name": "Visibility" } }, @@ -25298,6 +25514,7 @@ "type": "object", "properties": { "created_at": { + "description": "Created is the time when the deploy key was added", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -25408,6 +25625,10 @@ "type": "boolean", "x-go-name": "BlockAdminMergeOverride" }, + "block_on_codeowner_reviews": { + "type": "boolean", + "x-go-name": "BlockOnCodeownerReviews" + }, "block_on_official_review_requests": { "type": "boolean", "x-go-name": "BlockOnOfficialReviewRequests" @@ -25634,6 +25855,7 @@ ], "properties": { "body": { + "description": "Body is the updated comment text content", "type": "string", "x-go-name": "Body" } @@ -25798,14 +26020,14 @@ "x-go-name": "RepoAdminChangeTeamAccess" }, "visibility": { - "description": "possible values are `public`, `limited` or `private`\npublic UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "description": "possible values are `public`, `limited` or `private`", "type": "string", "enum": [ "public", "limited", "private" ], - "x-go-enum-desc": "public UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "x-go-enum-desc": "public VisibilityStringPublic\nlimited VisibilityStringLimited\nprivate VisibilityStringPrivate", "x-go-name": "Visibility" }, "website": { @@ -26198,10 +26420,12 @@ "x-go-name": "Permission" }, "units": { + "description": "Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.", "type": "array", "items": { "type": "string" }, + "x-deprecated": true, "x-go-name": "Units", "example": [ "repo.code", @@ -26232,7 +26456,7 @@ } }, "visibility": { - "description": "Team visibility within the organization. When omitted, visibility is\nleft unchanged.\npublic TeamVisibilityPublic\nlimited TeamVisibilityLimited\nprivate TeamVisibilityPrivate", + "description": "Team visibility within the organization. When omitted, visibility is\nleft unchanged.", "type": "string", "enum": [ "public", @@ -26284,6 +26508,7 @@ "x-go-name": "Description" }, "email": { + "description": "The email address of the user", "type": "string", "format": "email", "x-go-name": "Email" @@ -26331,19 +26556,20 @@ "x-go-name": "Restricted" }, "source_id": { + "description": "The authentication source ID to associate with the user", "type": "integer", "format": "int64", "x-go-name": "SourceID" }, "visibility": { - "description": "User visibility level: public, limited, or private\npublic UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "description": "User visibility level: public, limited, or private", "type": "string", "enum": [ "public", "limited", "private" ], - "x-go-enum-desc": "public UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "x-go-enum-desc": "public VisibilityStringPublic\nlimited VisibilityStringLimited\nprivate VisibilityStringPrivate", "x-go-name": "Visibility" }, "website": { @@ -26359,6 +26585,7 @@ "type": "object", "properties": { "email": { + "description": "The email address", "type": "string", "format": "email", "x-go-name": "Email" @@ -26437,6 +26664,7 @@ "$ref": "#/definitions/CommitUser" }, "created": { + "description": "Created is the time when the commit was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -26576,6 +26804,7 @@ "x-go-name": "CanSign" }, "created_at": { + "description": "The date and time when the GPG key was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -26589,6 +26818,7 @@ "x-go-name": "Emails" }, "expires_at": { + "description": "The date and time when the GPG key expires", "type": "string", "format": "date-time", "x-go-name": "Expires" @@ -27077,6 +27307,7 @@ "x-go-name": "Config" }, "created_at": { + "description": "The date and time when the webhook was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -27106,6 +27337,7 @@ "x-go-name": "Type" }, "updated_at": { + "description": "The date and time when the webhook was last updated", "type": "string", "format": "date-time", "x-go-name": "Updated" @@ -27118,6 +27350,7 @@ "type": "object", "properties": { "email": { + "description": "Email is the person's email address", "type": "string", "format": "email", "x-go-name": "Email" @@ -27652,8 +27885,9 @@ "type": "string" }, "Wiki": { - "description": "Is it a wiki page? (use mode=wiki instead)\n\nDeprecated: true", - "type": "boolean" + "description": "Is it a wiki page? (use mode=wiki instead)", + "type": "boolean", + "x-deprecated": true } }, "x-go-package": "gitea.dev/modules/structs" @@ -27679,8 +27913,9 @@ "type": "string" }, "Wiki": { - "description": "Is it a wiki page? (use mode=wiki instead)\n\nDeprecated: true", - "type": "boolean" + "description": "Is it a wiki page? (use mode=wiki instead)", + "type": "boolean", + "x-deprecated": true } }, "x-go-package": "gitea.dev/modules/structs" @@ -27916,7 +28151,7 @@ "x-go-name": "OpenIssues" }, "state": { - "description": "State indicates if the milestone is open or closed\nopen StateOpen pr is opened\nclosed StateClosed pr is closed", + "description": "State indicates if the milestone is open or closed", "type": "string", "enum": [ "open", @@ -27953,142 +28188,6 @@ }, "x-go-package": "gitea.dev/modules/structs" }, - "NodeInfo": { - "description": "NodeInfo contains standardized way of exposing metadata about a server running one of the distributed social networks", - "type": "object", - "properties": { - "metadata": { - "description": "Metadata contains free form key value pairs for software specific values", - "type": "object", - "x-go-name": "Metadata" - }, - "openRegistrations": { - "description": "OpenRegistrations indicates if new user registrations are accepted", - "type": "boolean", - "x-go-name": "OpenRegistrations" - }, - "protocols": { - "description": "Protocols lists the protocols supported by this server", - "type": "array", - "items": { - "type": "string" - }, - "x-go-name": "Protocols" - }, - "services": { - "$ref": "#/definitions/NodeInfoServices" - }, - "software": { - "$ref": "#/definitions/NodeInfoSoftware" - }, - "usage": { - "$ref": "#/definitions/NodeInfoUsage" - }, - "version": { - "description": "Version specifies the schema version", - "type": "string", - "x-go-name": "Version" - } - }, - "x-go-package": "gitea.dev/modules/structs" - }, - "NodeInfoServices": { - "description": "NodeInfoServices contains the third party sites this server can connect to via their application API", - "type": "object", - "properties": { - "inbound": { - "description": "Inbound lists services that can deliver content to this server", - "type": "array", - "items": { - "type": "string" - }, - "x-go-name": "Inbound" - }, - "outbound": { - "description": "Outbound lists services this server can deliver content to", - "type": "array", - "items": { - "type": "string" - }, - "x-go-name": "Outbound" - } - }, - "x-go-package": "gitea.dev/modules/structs" - }, - "NodeInfoSoftware": { - "description": "NodeInfoSoftware contains Metadata about server software in use", - "type": "object", - "properties": { - "homepage": { - "description": "Homepage is the URL to the homepage of this server software", - "type": "string", - "x-go-name": "Homepage" - }, - "name": { - "description": "Name is the canonical name of this server software", - "type": "string", - "x-go-name": "Name" - }, - "repository": { - "description": "Repository is the URL to the source code repository", - "type": "string", - "x-go-name": "Repository" - }, - "version": { - "description": "Version is the version of this server software", - "type": "string", - "x-go-name": "Version" - } - }, - "x-go-package": "gitea.dev/modules/structs" - }, - "NodeInfoUsage": { - "description": "NodeInfoUsage contains usage statistics for this server", - "type": "object", - "properties": { - "localComments": { - "description": "LocalComments is the total amount of comments made by users local to this server", - "type": "integer", - "format": "int64", - "x-go-name": "LocalComments" - }, - "localPosts": { - "description": "LocalPosts is the total amount of posts made by users local to this server", - "type": "integer", - "format": "int64", - "x-go-name": "LocalPosts" - }, - "users": { - "$ref": "#/definitions/NodeInfoUsageUsers" - } - }, - "x-go-package": "gitea.dev/modules/structs" - }, - "NodeInfoUsageUsers": { - "description": "NodeInfoUsageUsers contains statistics about the users of this server", - "type": "object", - "properties": { - "activeHalfyear": { - "description": "ActiveHalfyear is the amount of users that signed in at least once in the last 180 days", - "type": "integer", - "format": "int64", - "x-go-name": "ActiveHalfyear" - }, - "activeMonth": { - "description": "ActiveMonth is the amount of users that signed in at least once in the last 30 days", - "type": "integer", - "format": "int64", - "x-go-name": "ActiveMonth" - }, - "total": { - "description": "Total is the total amount of users on this server", - "type": "integer", - "format": "int64", - "x-go-name": "Total" - } - }, - "x-go-package": "gitea.dev/modules/structs" - }, "Note": { "description": "Note contains information related to a git note", "type": "object", @@ -28137,7 +28236,7 @@ "x-go-name": "LatestCommentURL" }, "state": { - "description": "State indicates the current state of the notification subject\nopen NotifySubjectStateOpen is an open subject\nclosed NotifySubjectStateClosed is a closed subject\nmerged NotifySubjectStateMerged is a merged pull request", + "description": "State indicates the current state of the notification subject", "type": "string", "enum": [ "open", @@ -28153,7 +28252,7 @@ "x-go-name": "Title" }, "type": { - "description": "Type indicates the type of the notification subject\nIssue NotifySubjectIssue a issue is subject of an notification\nPull NotifySubjectPull a pull is subject of an notification\nCommit NotifySubjectCommit a commit is subject of an notification\nRepository NotifySubjectRepository a repository is subject of an notification", + "description": "Type indicates the type of the notification subject", "type": "string", "enum": [ "Issue", @@ -28161,7 +28260,7 @@ "Commit", "Repository" ], - "x-go-enum-desc": "Issue NotifySubjectIssue a issue is subject of an notification\nPull NotifySubjectPull a pull is subject of an notification\nCommit NotifySubjectCommit a commit is subject of an notification\nRepository NotifySubjectRepository a repository is subject of an notification", + "x-go-enum-desc": "Issue NotifySubjectIssue an issue is subject of a notification\nPull NotifySubjectPull a pull is subject of an notification\nCommit NotifySubjectCommit a commit is subject of an notification\nRepository NotifySubjectRepository a repository is subject of an notification", "x-go-name": "Type" }, "url": { @@ -28315,14 +28414,14 @@ "x-go-name": "UserName" }, "visibility": { - "description": "The visibility level of the organization (public, limited, private)\npublic UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "description": "The visibility level of the organization (public, limited, private)", "type": "string", "enum": [ "public", "limited", "private" ], - "x-go-enum-desc": "public UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "x-go-enum-desc": "public VisibilityStringPublic\nlimited VisibilityStringLimited\nprivate VisibilityStringPrivate", "x-go-name": "Visibility" }, "website": { @@ -28401,6 +28500,7 @@ "type": "object", "properties": { "created_at": { + "description": "The date and time when the package was created", "type": "string", "format": "date-time", "x-go-name": "CreatedAt" @@ -28532,6 +28632,7 @@ "x-go-name": "Removed" }, "timestamp": { + "description": "The timestamp when the commit was made", "type": "string", "format": "date-time", "x-go-name": "Timestamp" @@ -28684,6 +28785,7 @@ "type": "object", "properties": { "created_at": { + "description": "Created is the time when the key was added", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -28917,7 +29019,7 @@ "x-go-name": "ReviewComments" }, "state": { - "description": "The current state of the pull request\nopen StateOpen pr is opened\nclosed StateClosed pr is closed", + "description": "The current state of the pull request", "type": "string", "enum": [ "open", @@ -29260,6 +29362,7 @@ "x-go-name": "Reaction" }, "created_at": { + "description": "The date and time when the reaction was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -29432,7 +29535,7 @@ "type": "object", "properties": { "permission": { - "description": "Permission level of the collaborator\nnone AccessLevelNameNone\nread AccessLevelNameRead\nwrite AccessLevelNameWrite\nadmin AccessLevelNameAdmin\nowner AccessLevelNameOwner", + "description": "Permission level of the collaborator", "type": "string", "enum": [ "none", @@ -29731,7 +29834,7 @@ "x-go-name": "Name" }, "object_format_name": { - "description": "ObjectFormatName of the underlying git repository\nsha1 ObjectFormatSHA1\nsha256 ObjectFormatSHA256", + "description": "ObjectFormatName of the underlying git repository", "type": "string", "enum": [ "sha1", @@ -29928,6 +30031,7 @@ "type": "object", "properties": { "created": { + "description": "Created is the time when the stopwatch was started", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -30030,6 +30134,7 @@ "type": "object", "properties": { "created_at": { + "description": "The date and time when the tag protection was created", "type": "string", "format": "date-time", "x-go-name": "Created" @@ -30046,6 +30151,7 @@ "x-go-name": "NamePattern" }, "updated_at": { + "description": "The date and time when the tag protection was last updated", "type": "string", "format": "date-time", "x-go-name": "Updated" @@ -30115,10 +30221,12 @@ "x-go-name": "Permission" }, "units": { + "description": "Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.", "type": "array", "items": { "type": "string" }, + "x-deprecated": true, "x-go-name": "Units", "example": [ "repo.code", @@ -30149,7 +30257,7 @@ } }, "visibility": { - "description": "Team visibility within the organization. \"private\" teams are only\nlistable by members and org owners; \"limited\" teams are listable by\nany organization member; \"public\" teams are listable by any signed-in\nuser.\npublic TeamVisibilityPublic\nlimited TeamVisibilityLimited\nprivate TeamVisibilityPrivate", + "description": "Team visibility within the organization. \"private\" teams are only\nlistable by members and org owners; \"limited\" teams are listable by\nany organization member; \"public\" teams are listable by any signed-in\nuser.", "type": "string", "enum": [ "public", @@ -30294,6 +30402,20 @@ }, "x-go-package": "gitea.dev/modules/structs" }, + "TopicListResponse": { + "description": "TopicListResponse returns a list of TopicResponse", + "type": "object", + "properties": { + "topics": { + "type": "array", + "items": { + "$ref": "#/definitions/TopicResponse" + }, + "x-go-name": "Topics" + } + }, + "x-go-package": "gitea.dev/modules/structs" + }, "TopicName": { "description": "TopicName a list of repo topic names", "type": "object", @@ -30669,14 +30791,14 @@ "x-go-name": "StarredRepos" }, "visibility": { - "description": "User visibility level option: public, limited, private\npublic UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "description": "User visibility level option: public, limited, private", "type": "string", "enum": [ "public", "limited", "private" ], - "x-go-enum-desc": "public UserVisibilityPublic\nlimited UserVisibilityLimited\nprivate UserVisibilityPrivate", + "x-go-enum-desc": "public VisibilityStringPublic\nlimited VisibilityStringLimited\nprivate VisibilityStringPrivate", "x-go-name": "Visibility" }, "website": { @@ -31501,12 +31623,6 @@ "type": "string" } }, - "MergeUpstreamRequest": { - "description": "", - "schema": { - "$ref": "#/definitions/MergeUpstreamRequest" - } - }, "MergeUpstreamResponse": { "description": "", "schema": { @@ -31528,12 +31644,6 @@ } } }, - "NodeInfo": { - "description": "NodeInfo", - "schema": { - "$ref": "#/definitions/NodeInfo" - } - }, "Note": { "description": "Note", "schema": { @@ -31711,12 +31821,6 @@ } } }, - "Reference": { - "description": "Reference", - "schema": { - "$ref": "#/definitions/Reference" - } - }, "ReferenceList": { "description": "ReferenceList", "schema": { @@ -31812,12 +31916,6 @@ "$ref": "#/definitions/SearchResults" } }, - "Secret": { - "description": "Secret", - "schema": { - "$ref": "#/definitions/Secret" - } - }, "SecretList": { "description": "SecretList", "schema": { @@ -31833,12 +31931,6 @@ "$ref": "#/definitions/ServerVersion" } }, - "StopWatch": { - "description": "StopWatch", - "schema": { - "$ref": "#/definitions/StopWatch" - } - }, "StopWatchList": { "description": "StopWatchList", "schema": { @@ -31920,10 +32012,7 @@ "TopicListResponse": { "description": "TopicListResponse", "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/TopicResponse" - } + "$ref": "#/definitions/TopicListResponse" } }, "TopicNames": { @@ -31974,10 +32063,7 @@ "UserSettings": { "description": "UserSettings", "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/UserSettings" - } + "$ref": "#/definitions/UserSettings" } }, "VariableList": { @@ -32085,15 +32171,6 @@ "notFound": { "description": "APINotFound is a not found empty response" }, - "parameterBodies": { - "description": "parameterBodies", - "schema": { - "$ref": "#/definitions/LockIssueOption" - } - }, - "redirect": { - "description": "APIRedirect is a redirect response" - }, "repoArchivedError": { "description": "APIRepoArchivedError is an error that is raised when an archived repo should be modified", "headers": { @@ -32186,5 +32263,43 @@ { "TOTPHeader": [] } + ], + "tags": [ + { + "description": "Site administration", + "name": "admin" + }, + { + "description": "Issues, pull requests, comments, labels and milestones", + "name": "issue" + }, + { + "description": "Miscellaneous endpoints", + "name": "miscellaneous" + }, + { + "description": "User notifications", + "name": "notification" + }, + { + "description": "Organizations and teams", + "name": "organization" + }, + { + "description": "Package registry", + "name": "package" + }, + { + "description": "Repositories and their contents", + "name": "repository" + }, + { + "description": "Server settings", + "name": "settings" + }, + { + "description": "The authenticated user", + "name": "user" + } ] } \ No newline at end of file