Update the latest api documents (#641)

Automated update of static/swagger-latest.json and static/openapi3-latest.json from the gitea main branch, opened by the "update api spec files" scheduled workflow.

<!-- cloudflare-preview --> Preview: https://pr-641.docs-gitea-com.pages.dev

Reviewed-on: https://gitea.com/gitea/docs/pulls/641
Reviewed-by: Lunny Xiao <[email protected]>
Co-authored-by: Gitea Bot <[email protected]>
This commit is contained in:
Gitea Bot authored and Lunny Xiao committed 2026-11-09 03:12:46 +00:00
1 parent 878c885050
commit 6779b1d6d8
2 files changed
+64 -249

No files matched your search

+33 -129
View File
@@ -1375,19 +1375,6 @@
},
"description": "StopWatchList"
},
"StringSlice": {
"content": {
"application/json": {
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
}
},
"description": "StringSlice"
},
"Tag": {
"content": {
"application/json": {
@@ -3802,6 +3789,7 @@
"x-go-name": "EnableForcePush"
},
"enable_force_push_allowlist": {
"description": "EnableForcePushAllowlist only takes effect when enable_force_push is true",
"type": "boolean",
"x-go-name": "EnableForcePushAllowlist"
},
@@ -4589,6 +4577,9 @@
"x-go-name": "Path"
}
},
"required": [
"path"
],
"type": "object",
"x-go-package": "gitea.dev/modules/structs"
},
@@ -4673,6 +4664,14 @@
"type": "boolean",
"x-go-name": "IsDraft"
},
"make_latest": {
"allOf": [
{
"$ref": "#/components/schemas/MakeLatest"
}
],
"description": "\"true\" sets the release as the latest, \"false\" keeps the current latest, \"legacy\" returns to the newest stable release by date. If omitted, a newly published release becomes the latest only if it is the newest by date"
},
"name": {
"description": "The display title of the release",
"type": "string",
@@ -5931,6 +5930,14 @@
"type": "boolean",
"x-go-name": "IsDraft"
},
"make_latest": {
"allOf": [
{
"$ref": "#/components/schemas/MakeLatest"
}
],
"description": "\"true\" sets the release as the latest, \"false\" keeps the current latest, \"legacy\" returns to the newest stable release by date. If omitted, a newly published release becomes the latest only if it is the newest by date"
},
"name": {
"description": "The new display title of the release",
"type": "string",
@@ -7759,6 +7766,14 @@
"type": "object",
"x-go-package": "gitea.dev/modules/structs"
},
"MakeLatest": {
"enum": [
"true",
"false",
"legacy"
],
"type": "string"
},
"MarkdownOption": {
"description": "MarkdownOption markdown options",
"properties": {
@@ -11986,6 +12001,7 @@
"schema": {
"enum": [
"alpine",
"arch",
"cargo",
"chef",
"composer",
@@ -12006,6 +12022,7 @@
"rubygems",
"swift",
"terraform",
"terraform-module",
"vagrant"
],
"type": "string"
@@ -12034,121 +12051,6 @@
]
}
},
"/admin/unadopted": {
"get": {
"operationId": "adminUnadoptedList",
"parameters": [
{
"description": "page number of results to return (1-based)",
"in": "query",
"name": "page",
"schema": {
"type": "integer"
}
},
{
"description": "page size of results",
"in": "query",
"name": "limit",
"schema": {
"type": "integer"
}
},
{
"description": "glob pattern of repositories to search for, in the form owner or owner/repo",
"in": "query",
"name": "query",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"$ref": "#/components/responses/StringSlice"
},
"default": {
"$ref": "#/components/responses/error"
}
},
"summary": "List unadopted repositories",
"tags": [
"admin"
]
}
},
"/admin/unadopted/{owner}/{repo}": {
"delete": {
"operationId": "adminDeleteUnadoptedRepository",
"parameters": [
{
"description": "owner of the repo",
"in": "path",
"name": "owner",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "name of the repo",
"in": "path",
"name": "repo",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"$ref": "#/components/responses/empty"
},
"default": {
"$ref": "#/components/responses/error"
}
},
"summary": "Delete unadopted files",
"tags": [
"admin"
]
},
"post": {
"operationId": "adminAdoptRepository",
"parameters": [
{
"description": "owner of the repo",
"in": "path",
"name": "owner",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "name of the repo",
"in": "path",
"name": "repo",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"$ref": "#/components/responses/empty"
},
"default": {
"$ref": "#/components/responses/error"
}
},
"summary": "Adopt unadopted files as a repository",
"tags": [
"admin"
]
}
},
"/admin/users": {
"get": {
"operationId": "adminSearchUsers",
@@ -16270,6 +16172,7 @@
"schema": {
"enum": [
"alpine",
"arch",
"cargo",
"chef",
"composer",
@@ -16290,6 +16193,7 @@
"rubygems",
"swift",
"terraform",
"terraform-module",
"vagrant"
],
"type": "string"
@@ -30726,7 +30630,7 @@
"$ref": "#/components/responses/error"
}
},
"summary": "Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at",
"summary": "Gets the release set as latest, else the most recent non-prerelease, non-draft release of a repository by created_at",
"tags": [
"repository"
]
+31 -120
View File
@@ -630,6 +630,7 @@
{
"enum": [
"alpine",
"arch",
"cargo",
"chef",
"composer",
@@ -650,6 +651,7 @@
"rubygems",
"swift",
"terraform",
"terraform-module",
"vagrant"
],
"type": "string",
@@ -674,116 +676,6 @@
}
}
},
"/admin/unadopted": {
"get": {
"produces": [
"application/json"
],
"tags": [
"admin"
],
"summary": "List unadopted repositories",
"operationId": "adminUnadoptedList",
"parameters": [
{
"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",
"description": "glob pattern of repositories to search for, in the form owner or owner/repo",
"name": "query",
"in": "query"
}
],
"responses": {
"200": {
"$ref": "#/responses/StringSlice"
},
"default": {
"$ref": "#/responses/error"
}
}
}
},
"/admin/unadopted/{owner}/{repo}": {
"post": {
"produces": [
"application/json"
],
"tags": [
"admin"
],
"summary": "Adopt unadopted files as a repository",
"operationId": "adminAdoptRepository",
"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
}
],
"responses": {
"204": {
"$ref": "#/responses/empty"
},
"default": {
"$ref": "#/responses/error"
}
}
},
"delete": {
"produces": [
"application/json"
],
"tags": [
"admin"
],
"summary": "Delete unadopted files",
"operationId": "adminDeleteUnadoptedRepository",
"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
}
],
"responses": {
"204": {
"$ref": "#/responses/empty"
},
"default": {
"$ref": "#/responses/error"
}
}
}
},
"/admin/users": {
"get": {
"produces": [
@@ -4728,6 +4620,7 @@
{
"enum": [
"alpine",
"arch",
"cargo",
"chef",
"composer",
@@ -4748,6 +4641,7 @@
"rubygems",
"swift",
"terraform",
"terraform-module",
"vagrant"
],
"type": "string",
@@ -17877,7 +17771,7 @@
"tags": [
"repository"
],
"summary": "Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at",
"summary": "Gets the release set as latest, else the most recent non-prerelease, non-draft release of a repository by created_at",
"operationId": "repoGetLatestRelease",
"parameters": [
{
@@ -26255,6 +26149,7 @@
"x-go-name": "EnableForcePush"
},
"enable_force_push_allowlist": {
"description": "EnableForcePushAllowlist only takes effect when enable_force_push is true",
"type": "boolean",
"x-go-name": "EnableForcePushAllowlist"
},
@@ -27022,6 +26917,9 @@
"CreatePullReviewComment": {
"description": "CreatePullReviewComment represent a review comment for creation api",
"type": "object",
"required": [
"path"
],
"properties": {
"body": {
"type": "string",
@@ -27141,6 +27039,17 @@
"type": "boolean",
"x-go-name": "IsDraft"
},
"make_latest": {
"description": "\"true\" sets the release as the latest, \"false\" keeps the current latest, \"legacy\" returns to the newest stable release by date. If omitted, a newly published release becomes the latest only if it is the newest by date",
"type": "string",
"enum": [
"true",
"false",
"legacy"
],
"x-go-enum-desc": "true MakeLatestTrue\nfalse MakeLatestFalse\nlegacy MakeLatestLegacy",
"x-go-name": "MakeLatest"
},
"name": {
"description": "The display title of the release",
"type": "string",
@@ -28419,6 +28328,17 @@
"type": "boolean",
"x-go-name": "IsDraft"
},
"make_latest": {
"description": "\"true\" sets the release as the latest, \"false\" keeps the current latest, \"legacy\" returns to the newest stable release by date. If omitted, a newly published release becomes the latest only if it is the newest by date",
"type": "string",
"enum": [
"true",
"false",
"legacy"
],
"x-go-enum-desc": "true MakeLatestTrue\nfalse MakeLatestFalse\nlegacy MakeLatestLegacy",
"x-go-name": "MakeLatest"
},
"name": {
"description": "The new display title of the release",
"type": "string",
@@ -34636,15 +34556,6 @@
}
}
},
"StringSlice": {
"description": "StringSlice",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
"Tag": {
"description": "Tag",
"schema": {