{ "consumes": [ "application/json", "text/plain" ], "produces": [ "application/json", "text/html" ], "schemes": [ "https", "http" ], "swagger": "2.0", "info": { "description": "本文档描述了Gitea API。", "title": "Gitea API", "license": { "name": "MIT", "url": "http://opensource.org/licenses/MIT" }, "version": "1.24.6" }, "basePath": "/api/v1", "paths": { "/activitypub/user-id/{user-id}": { "get": { "produces": [ "application/json" ], "tags": [ "activitypub" ], "summary": "返回用户的Person角色", "operationId": "activitypubPerson", "parameters": [ { "type": "integer", "description": "用户的ID", "name": "user-id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/ActivityPub" } } } }, "/activitypub/user-id/{user-id}/inbox": { "post": { "produces": [ "application/json" ], "tags": [ "activitypub" ], "summary": "发送到收件箱", "operationId": "activitypubPersonInbox", "parameters": [ { "type": "integer", "description": "用户的ID", "name": "user-id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" } } } }, "/admin/actions/runners": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "获取所有运行器", "operationId": "getAdminRunners", "responses": { "200": { "$ref": "#/definitions/ActionRunnersResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/admin/actions/runners/registration-token": { "post": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "获取全局动作运行器注册令牌", "operationId": "adminCreateRunnerRegistrationToken", "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } } }, "/admin/actions/runners/{runner_id}": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "获取全局运行器", "operationId": "getAdminRunner", "parameters": [ { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/definitions/ActionRunner" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "删除全局运行器", "operationId": "deleteAdminRunner", "parameters": [ { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "204": { "description": "运行器已被删除" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/admin/cron": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "列出定时任务", "operationId": "adminCronList", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CronList" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/admin/cron/{task}": { "post": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "运行定时任务", "operationId": "adminCronRun", "parameters": [ { "type": "string", "description": "task to run", "name": "task", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/admin/emails": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "列出所有邮箱", "operationId": "adminGetAllEmails", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/EmailList" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/admin/emails/search": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "搜索所有邮箱", "operationId": "adminSearchEmails", "parameters": [ { "type": "string", "description": "keyword", "name": "q", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/EmailList" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/admin/hooks": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "列出系统Web钩子", "operationId": "adminListHooks", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" }, { "enum": [ "system", "default", "all" ], "type": "string", "default": "system", "description": "system, default or both kinds of webhooks", "name": "type", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/HookList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "创建钩子", "operationId": "adminCreateHook", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateHookOption" } } ], "responses": { "201": { "$ref": "#/responses/Hook" } } } }, "/admin/hooks/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "获取钩子", "operationId": "adminGetHook", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the hook to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Hook" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "删除钩子", "operationId": "adminDeleteHook", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the hook to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "更新钩子", "operationId": "adminEditHook", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the hook to update", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditHookOption" } } ], "responses": { "200": { "$ref": "#/responses/Hook" } } } }, "/admin/orgs": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "列出所有组织", "operationId": "adminGetAllOrgs", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/OrganizationList" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/admin/runners/registration-token": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "获取全局动作运行器注册令牌", "operationId": "adminGetRunnerRegistrationToken", "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } } }, "/admin/unadopted": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "列出未采用仓库", "operationId": "adminUnadoptedList", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" }, { "type": "string", "description": "pattern of repositories to search for", "name": "pattern", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/StringSlice" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/admin/unadopted/{owner}/{repo}": { "post": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "将未采用的文件采用为仓库", "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" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "删除未采用的文件", "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" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/admin/users": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "根据过滤条件搜索用户", "operationId": "adminSearchUsers", "parameters": [ { "type": "integer", "format": "int64", "description": "ID of the user's login source to search for", "name": "source_id", "in": "query" }, { "type": "string", "description": "user's login name to search for", "name": "login_name", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "403": { "$ref": "#/responses/forbidden" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "创建用户", "operationId": "adminCreateUser", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateUserOption" } } ], "responses": { "201": { "$ref": "#/responses/User" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/admin/users/{username}": { "delete": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "删除用户", "operationId": "adminDeleteUser", "parameters": [ { "type": "string", "description": "username of user to delete", "name": "username", "in": "path", "required": true }, { "type": "boolean", "description": "purge the user from the system completely", "name": "purge", "in": "query" } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "编辑现有用户", "operationId": "adminEditUser", "parameters": [ { "type": "string", "description": "username of user to edit", "name": "username", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditUserOption" } } ], "responses": { "200": { "$ref": "#/responses/User" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/admin/users/{username}/badges": { "get": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "列出用户的徽章", "operationId": "adminListUserBadges", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/BadgeList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "为用户添加徽章", "operationId": "adminAddUserBadges", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UserBadgeOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "从用户移除徽章", "operationId": "adminDeleteUserBadges", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UserBadgeOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/admin/users/{username}/keys": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "代表用户添加公钥", "operationId": "adminCreatePublicKey", "parameters": [ { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true }, { "name": "key", "in": "body", "schema": { "$ref": "#/definitions/CreateKeyOption" } } ], "responses": { "201": { "$ref": "#/responses/PublicKey" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/admin/users/{username}/keys/{id}": { "delete": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "删除用户的公钥", "operationId": "adminDeleteUserPublicKey", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the key to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/admin/users/{username}/orgs": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "创建组织", "operationId": "adminCreateOrg", "parameters": [ { "type": "string", "description": "username of the user that will own the created organization", "name": "username", "in": "path", "required": true }, { "name": "organization", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateOrgOption" } } ], "responses": { "201": { "$ref": "#/responses/Organization" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/admin/users/{username}/rename": { "post": { "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "重命名用户", "operationId": "adminRenameUser", "parameters": [ { "type": "string", "description": "existing username of user", "name": "username", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/RenameUserOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/admin/users/{username}/repos": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "admin" ], "summary": "代表用户创建仓库", "operationId": "adminCreateRepo", "parameters": [ { "type": "string", "description": "username of the user. This user will own the created repository", "name": "username", "in": "path", "required": true }, { "name": "repository", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateRepoOption" } } ], "responses": { "201": { "$ref": "#/responses/Repository" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } } }, "/gitignore/templates": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回所有gitignore模板的列表", "operationId": "listGitignoresTemplates", "responses": { "200": { "$ref": "#/responses/GitignoreTemplateList" } } } }, "/gitignore/templates/{name}": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回gitignore模板的信息", "operationId": "getGitignoreTemplateInfo", "parameters": [ { "type": "string", "description": "name of the template", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/GitignoreTemplateInfo" }, "404": { "$ref": "#/responses/notFound" } } } }, "/label/templates": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回所有标签模板的列表", "operationId": "listLabelTemplates", "responses": { "200": { "$ref": "#/responses/LabelTemplateList" } } } }, "/label/templates/{name}": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回模板中的所有标签", "operationId": "getLabelTemplateInfo", "parameters": [ { "type": "string", "description": "name of the template", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/LabelTemplateInfo" }, "404": { "$ref": "#/responses/notFound" } } } }, "/licenses": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回所有许可证模板的列表", "operationId": "listLicenseTemplates", "responses": { "200": { "$ref": "#/responses/LicenseTemplateList" } } } }, "/licenses/{name}": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回许可证模板的信息", "operationId": "getLicenseTemplateInfo", "parameters": [ { "type": "string", "description": "name of the license", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/LicenseTemplateInfo" }, "404": { "$ref": "#/responses/notFound" } } } }, "/markdown": { "post": { "consumes": [ "application/json" ], "produces": [ "text/html" ], "tags": [ "miscellaneous" ], "summary": "将markdown文档渲染为HTML", "operationId": "renderMarkdown", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/MarkdownOption" } } ], "responses": { "200": { "$ref": "#/responses/MarkdownRender" }, "422": { "$ref": "#/responses/validationError" } } } }, "/markdown/raw": { "post": { "consumes": [ "text/plain" ], "produces": [ "text/html" ], "tags": [ "miscellaneous" ], "summary": "将原始markdown渲染为HTML", "operationId": "renderMarkdownRaw", "parameters": [ { "description": "Request body to render", "name": "body", "in": "body", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/responses/MarkdownRender" }, "422": { "$ref": "#/responses/validationError" } } } }, "/markup": { "post": { "consumes": [ "application/json" ], "produces": [ "text/html" ], "tags": [ "miscellaneous" ], "summary": "将标记文档渲染为HTML", "operationId": "renderMarkup", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/MarkupOption" } } ], "responses": { "200": { "$ref": "#/responses/MarkupRender" }, "422": { "$ref": "#/responses/validationError" } } } }, "/nodeinfo": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回Gitea应用程序的节点信息", "operationId": "getNodeInfo", "responses": { "200": { "$ref": "#/responses/NodeInfo" } } } }, "/notifications": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "notification" ], "summary": "列出用户的通知线程", "operationId": "notifyGetList", "parameters": [ { "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" }, { "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" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/NotificationThreadList" } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "notification" ], "summary": "将通知线程标记为已读、固定或未读", "operationId": "notifyReadList", "parameters": [ { "type": "string", "format": "date-time", "description": "Describes the last point that notifications were checked. Anything updated since this time will not be updated.", "name": "last_read_at", "in": "query" }, { "type": "string", "description": "If true, mark all notifications on this repo. Default value is false", "name": "all", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread.", "name": "status-types", "in": "query" }, { "type": "string", "description": "Status to mark notifications as, Defaults to read.", "name": "to-status", "in": "query" } ], "responses": { "205": { "$ref": "#/responses/NotificationThreadList" } } } }, "/notifications/new": { "get": { "tags": [ "notification" ], "summary": "检查是否存在未读通知", "operationId": "notifyNewAvailable", "responses": { "200": { "$ref": "#/responses/NotificationCount" } } } }, "/notifications/threads/{id}": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "notification" ], "summary": "通过ID获取通知线程", "operationId": "notifyGetThread", "parameters": [ { "type": "string", "description": "id of notification thread", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/NotificationThread" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "notification" ], "summary": "通过ID将通知线程标记为已读", "operationId": "notifyReadThread", "parameters": [ { "type": "string", "description": "id of notification thread", "name": "id", "in": "path", "required": true }, { "type": "string", "default": "read", "description": "Status to mark notifications as", "name": "to-status", "in": "query" } ], "responses": { "205": { "$ref": "#/responses/NotificationThread" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/org/{org}/repos": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "在组织中创建仓库", "operationId": "createOrgRepoDeprecated", "deprecated": true, "parameters": [ { "type": "string", "description": "name of organization", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateRepoOption" } } ], "responses": { "201": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织列表", "operationId": "orgGetAll", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/OrganizationList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "创建组织", "operationId": "orgCreate", "parameters": [ { "name": "organization", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateOrgOption" } } ], "responses": { "201": { "$ref": "#/responses/Organization" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs/{org}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织", "operationId": "orgGet", "parameters": [ { "type": "string", "description": "name of the organization to get", "name": "org", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Organization" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "删除组织", "operationId": "orgDelete", "parameters": [ { "type": "string", "description": "organization that is to be deleted", "name": "org", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "编辑组织", "operationId": "orgEdit", "parameters": [ { "type": "string", "description": "name of the organization to edit", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/EditOrgOption" } } ], "responses": { "200": { "$ref": "#/responses/Organization" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/actions/runners": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织级别的运行器", "operationId": "getOrgRunners", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/definitions/ActionRunnersResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/actions/runners/registration-token": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织的动作运行器注册令牌", "operationId": "orgGetRunnerRegistrationToken", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } }, "post": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织的动作运行器注册令牌", "operationId": "orgCreateRunnerRegistrationToken", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } } }, "/orgs/{org}/actions/runners/{runner_id}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织级别的运行器", "operationId": "getOrgRunner", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/definitions/ActionRunner" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "删除组织级别的运行器", "operationId": "deleteOrgRunner", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "204": { "description": "运行器已被删除" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/actions/secrets": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的动作密钥", "operationId": "orgListActionsSecrets", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/SecretList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/actions/secrets/{secretname}": { "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "在组织中创建或更新密钥值", "operationId": "updateOrgSecret", "parameters": [ { "type": "string", "description": "name of organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the secret", "name": "secretname", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateOrUpdateSecretOption" } } ], "responses": { "201": { "description": "response when creating a secret" }, "204": { "description": "response when updating a secret" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "删除组织中的密钥", "operationId": "deleteOrgSecret", "parameters": [ { "type": "string", "description": "name of organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the secret", "name": "secretname", "in": "path", "required": true } ], "responses": { "204": { "description": "delete one secret of the organization" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/actions/variables": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织级别的变量列表", "operationId": "getOrgVariablesList", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/VariableList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/actions/variables/{variablename}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取组织级别的变量", "operationId": "getOrgVariable", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/ActionVariable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "更新组织级别的变量", "operationId": "updateOrgVariable", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UpdateVariableOption" } } ], "responses": { "201": { "description": "response when updating an org-level variable" }, "204": { "description": "response when updating an org-level variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "创建组织级别的变量", "operationId": "createOrgVariable", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "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" } } ], "responses": { "201": { "description": "response when creating an org-level variable" }, "204": { "description": "response when creating an org-level variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "删除组织级别的变量", "operationId": "deleteOrgVariable", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "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" } } } }, "/orgs/{org}/activities/feeds": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的活动动态", "operationId": "orgListActivityFeeds", "parameters": [ { "type": "string", "description": "name of the org", "name": "org", "in": "path", "required": true }, { "type": "string", "format": "date", "description": "the date of the activities to be found", "name": "date", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ActivityFeedsList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/avatar": { "post": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "更新头像", "operationId": "orgUpdateAvatar", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UpdateUserAvatarOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "删除头像", "operationId": "orgDeleteAvatar", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/blocks": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出被组织屏蔽的用户", "operationId": "organizationListBlocks", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" } } } }, "/orgs/{org}/blocks/{username}": { "get": { "tags": [ "organization" ], "summary": "检查用户是否被组织屏蔽", "operationId": "organizationCheckUserBlock", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "user to check", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "tags": [ "organization" ], "summary": "屏蔽用户", "operationId": "organizationBlockUser", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "user to block", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "optional note for the block", "name": "note", "in": "query" } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "tags": [ "organization" ], "summary": "取消屏蔽用户", "operationId": "organizationUnblockUser", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "user to unblock", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs/{org}/hooks": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的Web钩子", "operationId": "orgListHooks", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/HookList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "创建钩子", "operationId": "orgCreateHook", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateHookOption" } } ], "responses": { "201": { "$ref": "#/responses/Hook" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/hooks/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取钩子", "operationId": "orgGetHook", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the hook to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Hook" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "删除钩子", "operationId": "orgDeleteHook", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the hook to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "更新钩子", "operationId": "orgEditHook", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the hook to update", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditHookOption" } } ], "responses": { "200": { "$ref": "#/responses/Hook" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/labels": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的标签", "operationId": "orgListLabels", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/LabelList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "为组织创建标签", "operationId": "orgCreateLabel", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateLabelOption" } } ], "responses": { "201": { "$ref": "#/responses/Label" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs/{org}/labels/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取单个标签", "operationId": "orgGetLabel", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the label to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Label" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "organization" ], "summary": "删除标签", "operationId": "orgDeleteLabel", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the label to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "更新标签", "operationId": "orgEditLabel", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the label to edit", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditLabelOption" } } ], "responses": { "200": { "$ref": "#/responses/Label" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs/{org}/members": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织成员", "operationId": "orgListMembers", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/members/{username}": { "get": { "tags": [ "organization" ], "summary": "检查用户是否是组织的成员", "operationId": "orgIsMember", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "description": "user is a member" }, "303": { "description": "redirection to /orgs/{org}/public_members/{username}" }, "404": { "description": "user is not a member" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "从组织移除成员", "operationId": "orgDeleteMember", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "description": "member removed" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/public_members": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的公开成员", "operationId": "orgListPublicMembers", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/public_members/{username}": { "get": { "tags": [ "organization" ], "summary": "检查用户是否是组织的公开成员", "operationId": "orgIsPublicMember", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "description": "user is a public member" }, "404": { "description": "user is not a public member" } } }, "put": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "公开用户的成员资格", "operationId": "orgPublicizeMember", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "description": "membership publicized" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "隐藏用户的成员资格", "operationId": "orgConcealMember", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/rename": { "post": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "重命名组织", "operationId": "renameOrg", "parameters": [ { "type": "string", "description": "existing org name", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/RenameOrgOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs/{org}/repos": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的仓库", "operationId": "orgListRepos", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "在组织中创建仓库", "operationId": "createOrgRepo", "parameters": [ { "type": "string", "description": "name of organization", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateRepoOption" } } ], "responses": { "201": { "$ref": "#/responses/Repository" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/orgs/{org}/teams": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出组织的团队", "operationId": "orgListTeams", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TeamList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "创建团队", "operationId": "orgCreateTeam", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateTeamOption" } } ], "responses": { "201": { "$ref": "#/responses/Team" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/orgs/{org}/teams/search": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "在组织内搜索团队", "operationId": "teamSearch", "parameters": [ { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "keywords to search", "name": "q", "in": "query" }, { "type": "boolean", "description": "include search within team description (defaults to true)", "name": "include_desc", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "description": "SearchResults of a successful search", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/Team" } }, "ok": { "type": "boolean" } } } }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}": { "get": { "produces": [ "application/json" ], "tags": [ "package" ], "summary": "获取所有者的所有包", "operationId": "listPackages", "parameters": [ { "type": "string", "description": "owner of the packages", "name": "owner", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" }, { "enum": [ "alpine", "cargo", "chef", "composer", "conan", "conda", "container", "cran", "debian", "generic", "go", "helm", "maven", "npm", "nuget", "pub", "pypi", "rpm", "rubygems", "swift", "vagrant" ], "type": "string", "description": "package type filter", "name": "type", "in": "query" }, { "type": "string", "description": "name filter", "name": "q", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/PackageList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}/{type}/{name}": { "get": { "produces": [ "application/json" ], "tags": [ "package" ], "summary": "获取包的所有版本", "operationId": "listPackageVersions", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/PackageList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}/{type}/{name}/-/latest": { "get": { "produces": [ "application/json" ], "tags": [ "package" ], "summary": "获取包的最新版本", "operationId": "getLatestPackageVersion", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Package" }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}/{type}/{name}/-/link/{repo_name}": { "post": { "tags": [ "package" ], "summary": "将包链接到仓库", "operationId": "linkPackage", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true }, { "type": "string", "description": "name of the repository to link.", "name": "repo_name", "in": "path", "required": true } ], "responses": { "201": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}/{type}/{name}/-/unlink": { "post": { "tags": [ "package" ], "summary": "将包从仓库取消链接", "operationId": "unlinkPackage", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true } ], "responses": { "201": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}/{type}/{name}/{version}": { "get": { "produces": [ "application/json" ], "tags": [ "package" ], "summary": "获取包", "operationId": "getPackage", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true }, { "type": "string", "description": "version of the package", "name": "version", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Package" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "package" ], "summary": "删除包", "operationId": "deletePackage", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true }, { "type": "string", "description": "version of the package", "name": "version", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/packages/{owner}/{type}/{name}/{version}/files": { "get": { "produces": [ "application/json" ], "tags": [ "package" ], "summary": "获取包的所有文件", "operationId": "listPackageFiles", "parameters": [ { "type": "string", "description": "owner of the package", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "type of the package", "name": "type", "in": "path", "required": true }, { "type": "string", "description": "name of the package", "name": "name", "in": "path", "required": true }, { "type": "string", "description": "version of the package", "name": "version", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/PackageFileList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/issues/search": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "在用户有访问权限的仓库中搜索问题", "operationId": "issueSearchIssues", "parameters": [ { "enum": [ "open", "closed", "all" ], "type": "string", "default": "open", "description": "State of the issue", "name": "state", "in": "query" }, { "type": "string", "description": "Comma-separated list of label names. Fetch only issues that have any of these labels. Non existent labels are discarded.", "name": "labels", "in": "query" }, { "type": "string", "description": "Comma-separated list of milestone names. Fetch only issues that have any of these milestones. Non existent milestones are discarded.", "name": "milestones", "in": "query" }, { "type": "string", "description": "Search string", "name": "q", "in": "query" }, { "type": "integer", "format": "int64", "description": "Repository ID to prioritize in the results", "name": "priority_repo_id", "in": "query" }, { "enum": [ "issues", "pulls" ], "type": "string", "description": "Filter by issue type", "name": "type", "in": "query" }, { "type": "string", "format": "date-time", "description": "Only show issues updated after the given time (RFC 3339 format)", "name": "since", "in": "query" }, { "type": "string", "format": "date-time", "description": "Only show issues updated before the given time (RFC 3339 format)", "name": "before", "in": "query" }, { "type": "boolean", "default": false, "description": "Filter issues or pulls assigned to the authenticated user", "name": "assigned", "in": "query" }, { "type": "boolean", "default": false, "description": "Filter issues or pulls created by the authenticated user", "name": "created", "in": "query" }, { "type": "boolean", "default": false, "description": "Filter issues or pulls mentioning the authenticated user", "name": "mentioned", "in": "query" }, { "type": "boolean", "default": false, "description": "Filter pull requests where the authenticated user's review was requested", "name": "review_requested", "in": "query" }, { "type": "boolean", "default": false, "description": "Filter pull requests reviewed by the authenticated user", "name": "reviewed", "in": "query" }, { "type": "string", "description": "Filter by repository owner", "name": "owner", "in": "query" }, { "type": "string", "description": "Filter by team (requires organization owner parameter)", "name": "team", "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": "Number of items per page", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/IssueList" }, "400": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/migrate": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "迁移远程git仓库", "operationId": "repoMigrate", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/MigrateRepoOptions" } } ], "responses": { "201": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "409": { "description": "The repository with the same name already exists." }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/search": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "搜索仓库", "operationId": "repoSearch", "parameters": [ { "type": "string", "description": "keyword", "name": "q", "in": "query" }, { "type": "boolean", "description": "Limit search to repositories with keyword as topic", "name": "topic", "in": "query" }, { "type": "boolean", "description": "include search of keyword within repository description", "name": "includeDesc", "in": "query" }, { "type": "integer", "format": "int64", "description": "search only for repos that the user with the given id owns or contributes to", "name": "uid", "in": "query" }, { "type": "integer", "format": "int64", "description": "repo owner to prioritize in the results", "name": "priority_owner_id", "in": "query" }, { "type": "integer", "format": "int64", "description": "search only for repos that belong to the given team id", "name": "team_id", "in": "query" }, { "type": "integer", "format": "int64", "description": "search only for repos that the user with the given id has starred", "name": "starredBy", "in": "query" }, { "type": "boolean", "description": "include private repositories this user has access to (defaults to true)", "name": "private", "in": "query" }, { "type": "boolean", "description": "show only pubic, private or all repositories (defaults to all)", "name": "is_private", "in": "query" }, { "type": "boolean", "description": "include template repositories this user has access to (defaults to true)", "name": "template", "in": "query" }, { "type": "boolean", "description": "show only archived, non-archived or all repositories (defaults to all)", "name": "archived", "in": "query" }, { "type": "string", "description": "type of repository to search for. Supported values are \"fork\", \"source\", \"mirror\" and \"collaborative\"", "name": "mode", "in": "query" }, { "type": "boolean", "description": "if `uid` is given, search only for repos that the user owns", "name": "exclusive", "in": "query" }, { "type": "string", "description": "sort repos by attribute. Supported values are \"alpha\", \"created\", \"updated\", \"size\", \"git_size\", \"lfs_size\", \"stars\", \"forks\" and \"id\". Default is \"alpha\"", "name": "sort", "in": "query" }, { "type": "string", "description": "sort order, either \"asc\" (ascending) or \"desc\" (descending). Default is \"asc\", ignored if \"sort\" is not specified.", "name": "order", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/SearchResults" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库", "operationId": "repoGet", "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": { "200": { "$ref": "#/responses/Repository" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库", "operationId": "repoDelete", "parameters": [ { "type": "string", "description": "owner of the repo to delete", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to delete", "name": "repo", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑仓库的属性。只有设置的字段会被更改。", "operationId": "repoEdit", "parameters": [ { "type": "string", "description": "owner of the repo to edit", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to edit", "name": "repo", "in": "path", "required": true }, { "description": "Properties of a repo that you can edit", "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditRepoOption" } } ], "responses": { "200": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/actions/artifacts": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的所有制品", "operationId": "getArtifacts", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repository", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "name of the artifact", "name": "name", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ArtifactsList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/artifacts/{artifact_id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取工作流运行的特定制品", "operationId": "getArtifact", "parameters": [ { "type": "string", "description": "name of the owner", "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 artifact", "name": "artifact_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Artifact" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除工作流运行的特定制品", "operationId": "deleteArtifact", "parameters": [ { "type": "string", "description": "name of the owner", "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 artifact", "name": "artifact_id", "in": "path", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "下载工作流运行的特定制品重定向到blob URL", "operationId": "downloadArtifact", "parameters": [ { "type": "string", "description": "name of the owner", "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 artifact", "name": "artifact_id", "in": "path", "required": true } ], "responses": { "302": { "description": "redirect to the blob download" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/jobs/{job_id}/logs": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "下载工作流运行的任务日志", "operationId": "downloadActionsRunJobLogs", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repository", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "id of the job", "name": "job_id", "in": "path", "required": true } ], "responses": { "200": { "description": "output blob content" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/runners": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库级别的运行器", "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 } ], "responses": { "200": { "$ref": "#/definitions/ActionRunnersResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/runners/registration-token": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的动作运行器注册令牌", "operationId": "repoGetRunnerRegistrationToken", "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": { "200": { "$ref": "#/responses/RegistrationToken" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的动作运行器注册令牌", "operationId": "repoCreateRunnerRegistrationToken", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } } }, "/repos/{owner}/{repo}/actions/runners/{runner_id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库级别的运行器", "operationId": "getRepoRunner", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/definitions/ActionRunner" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库级别的运行器", "operationId": "deleteRepoRunner", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "204": { "description": "运行器已被删除" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/runs/{run}/artifacts": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库运行的所有制品", "operationId": "getArtifactsOfRun", "parameters": [ { "type": "string", "description": "name of the owner", "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 }, { "type": "string", "description": "name of the artifact", "name": "name", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ArtifactsList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/secrets": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的动作密钥", "operationId": "repoListActionsSecrets", "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 }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/SecretList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/secrets/{secretname}": { "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "在仓库中创建或更新密钥值", "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 }, { "type": "string", "description": "name of the secret", "name": "secretname", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateOrUpdateSecretOption" } } ], "responses": { "201": { "description": "response when creating a secret" }, "204": { "description": "response when updating a secret" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库中的密钥", "operationId": "deleteRepoSecret", "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 }, { "type": "string", "description": "name of the secret", "name": "secretname", "in": "path", "required": true } ], "responses": { "204": { "description": "delete one secret of the repository" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/tasks": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的 Action 任务", "operationId": "ListActionTasks", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小，默认最大页面大小为50", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TasksList" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/conflict" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/actions/variables": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库级别的变量列表", "operationId": "getRepoVariablesList", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repository", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/VariableList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/actions/variables/{variablename}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库级别的变量", "operationId": "getRepoVariable", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "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", "required": true } ], "responses": { "200": { "$ref": "#/responses/ActionVariable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新仓库级别的变量", "operationId": "updateRepoVariable", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "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", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UpdateVariableOption" } } ], "responses": { "201": { "description": "response when updating a repo-level variable" }, "204": { "description": "response when updating a repo-level variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建仓库级别的变量", "operationId": "createRepoVariable", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "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", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateVariableOption" } } ], "responses": { "201": { "description": "response when creating a repo-level variable" }, "204": { "description": "response when creating a repo-level variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库级别的变量", "operationId": "deleteRepoVariable", "parameters": [ { "type": "string", "description": "name of the owner", "name": "owner", "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", "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" } } } }, "/repos/{owner}/{repo}/actions/workflows": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的工作流", "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 } ], "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}/{repo}/actions/workflows/{workflow_id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取工作流", "operationId": "ActionsGetWorkflow", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the workflow", "name": "workflow_id", "in": "path", "required": true } ], "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}/{repo}/actions/workflows/{workflow_id}/disable": { "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "禁用工作流", "operationId": "ActionsDisableWorkflow", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the workflow", "name": "workflow_id", "in": "path", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建工作流调度事件", "operationId": "ActionsDispatchWorkflow", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the workflow", "name": "workflow_id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateActionWorkflowDispatch" } } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable": { "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "启用工作流", "operationId": "ActionsEnableWorkflow", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the workflow", "name": "workflow_id", "in": "path", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/conflict" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/activities/feeds": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的活动动态", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ActivityFeedsList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/archive/{archive}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的存档", "operationId": "repoGetArchive", "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 git reference for download with attached archive format (e.g. master.zip)", "name": "archive", "in": "path", "required": true } ], "responses": { "200": { "description": "success" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/assignees": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "返回所有具有写入权限并可被分配到问题的用户", "operationId": "repoGetAssignees", "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": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/avatar": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新头像", "operationId": "repoUpdateAvatar", "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/UpdateRepoAvatarOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除头像", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/branch_protections": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的分支保护规则", "operationId": "repoListBranchProtection", "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": { "200": { "$ref": "#/responses/BranchProtectionList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为仓库创建分支保护规则", "operationId": "repoCreateBranchProtection", "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/CreateBranchProtectionOption" } } ], "responses": { "201": { "$ref": "#/responses/BranchProtection" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/branch_protections/priority": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新仓库的分支保护规则优先级.", "operationId": "repoUpdateBranchProtectionPriories", "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/UpdateBranchProtectionPriories" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/branch_protections/{name}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的特定分支保护规则", "operationId": "repoGetBranchProtection", "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 protected branch", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/BranchProtection" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库的特定分支保护规则", "operationId": "repoDeleteBranchProtection", "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 protected branch", "name": "name", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑仓库的分支保护规则.只有设置的字段会被更改", "operationId": "repoEditBranchProtection", "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 protected branch", "name": "name", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditBranchProtectionOption" } } ], "responses": { "200": { "$ref": "#/responses/BranchProtection" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/branches": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的分支", "operationId": "repoListBranches", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/BranchList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建分支", "operationId": "repoCreateBranch", "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/CreateBranchRepoOption" } } ], "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" } } } }, "/repos/{owner}/{repo}/branches/{branch}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从仓库中获取特定分支，包括其有效的分支保护规则", "operationId": "repoGetBranch", "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": "branch to get", "name": "branch", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Branch" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从仓库中删除特定分支", "operationId": "repoDeleteBranch", "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": "branch to delete", "name": "branch", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新分支", "operationId": "repoUpdateBranch", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "name of the branch", "name": "branch", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UpdateBranchRepoOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/collaborators": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的协作者", "operationId": "repoListCollaborators", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/collaborators/{collaborator}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "检查用户是否是仓库的协作者", "operationId": "repoCheckCollaborator", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "username of the collaborator", "name": "collaborator", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "添加或更新仓库的协作者", "operationId": "repoAddCollaborator", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "username of the collaborator to add", "name": "collaborator", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/AddCollaboratorOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从仓库中删除协作者", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/collaborators/{collaborator}/permission": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取用户在仓库中的权限", "operationId": "repoGetRepoPermissions", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "username of the collaborator", "name": "collaborator", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/RepoCollaboratorPermission" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/commits": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的所有提交列表", "operationId": "repoGetAllCommits", "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 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": "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" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小（如果使用'path'则忽略）", "name": "limit", "in": "query" }, { "type": "string", "description": "commits that match the given specifier will not be listed.", "name": "not", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CommitList" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/EmptyRepository" } } } }, "/repos/{owner}/{repo}/commits/{ref}/status": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过分支/标签/提交引用获取提交的组合状态", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CombinedStatus" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/commits/{ref}/statuses": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过分支/标签/提交引用获取提交的状态", "operationId": "repoListStatusesByRef", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "name of branch/tag/commit", "name": "ref", "in": "path", "required": true }, { "enum": [ "oldest", "recentupdate", "leastupdate", "leastindex", "highestindex" ], "type": "string", "description": "type of sort", "name": "sort", "in": "query" }, { "enum": [ "pending", "success", "error", "failure", "warning" ], "type": "string", "description": "type of state", "name": "state", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CommitStatusList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/commits/{sha}/pull": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取该提交合并的拉取请求", "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 } ], "responses": { "200": { "$ref": "#/responses/PullRequest" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/compare/{basehead}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取提交比较信息", "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 }, { "type": "string", "description": "compare two branches or commits", "name": "basehead", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Compare" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/contents": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取根目录中所有条目的元数据", "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" } ], "responses": { "200": { "$ref": "#/responses/ContentsListResponse" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "修改仓库中的多个文件", "operationId": "repoChangeFiles", "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", "required": true, "schema": { "$ref": "#/definitions/ChangeFilesOptions" } } ], "responses": { "201": { "$ref": "#/responses/FilesResponse" }, "403": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/contents/{filepath}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库中条目的元数据和内容（如果是文件），如果是目录则获取条目列表", "operationId": "repoGetContents", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "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" } ], "responses": { "200": { "$ref": "#/responses/ContentsResponse" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新仓库中的文件", "operationId": "repoUpdateFile", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "path of the file to update", "name": "filepath", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/UpdateFileOptions" } } ], "responses": { "200": { "$ref": "#/responses/FileResponse" }, "403": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "在仓库中创建文件", "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" } } ], "responses": { "201": { "$ref": "#/responses/FileResponse" }, "403": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库中的文件", "operationId": "repoDeleteFile", "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 delete", "name": "filepath", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/DeleteFileOptions" } } ], "responses": { "200": { "$ref": "#/responses/FileDeleteResponse" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/diffpatch": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "向仓库应用差异补丁", "operationId": "repoApplyDiffPatch", "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", "required": true, "schema": { "$ref": "#/definitions/UpdateFileOptions" } } ], "responses": { "200": { "$ref": "#/responses/FileResponse" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/editorconfig/{filepath}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库中文件的 EditorConfig 定义", "operationId": "repoGetEditorConfig", "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": "filepath of file to get", "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" } ], "responses": { "200": { "description": "success" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/file-contents": { "get": { "description": "See the POST method. This GET method supports to use JSON encoded request body in query parameter.", "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取请求文件的元数据和内容", "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" }, { "type": "string", "description": "The JSON encoded body (see the POST request): {\"files\": [\"filename1\", \"filename2\"]}", "name": "body", "in": "query", "required": true } ], "responses": { "200": { "$ref": "#/responses/ContentsListResponse" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "description": "使用基于默认页面大小和最大响应大小的自动分页，并返回允许的最大文件数量。无法检索的文件为null。过大的文件将返回`encoding == null`、`content == null`和`size > 0`，可以使用`download_url`单独请求。", "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取请求文件的元数据和内容", "operationId": "repoGetFileContentsPost", "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" }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/GetFilesOptions" } } ], "responses": { "200": { "$ref": "#/responses/ContentsListResponse" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/forks": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的分叉", "operationId": "listForks", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "派生仓库", "operationId": "createFork", "parameters": [ { "type": "string", "description": "owner of the repo to fork", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to fork", "name": "repo", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateForkOption" } } ], "responses": { "202": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "description": "The repository with the same name already exists." }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/git/blobs/{sha}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的二进制对象.", "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 }, { "type": "string", "description": "sha of the commit", "name": "sha", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/GitBlobResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/git/commits/{sha}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从仓库中获取单个提交", "operationId": "repoGetSingleCommit", "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": "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" } ], "responses": { "200": { "$ref": "#/responses/Commit" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/git/commits/{sha}.{diffType}": { "get": { "produces": [ "text/plain" ], "tags": [ "repository" ], "summary": "获取提交的差异或补丁", "operationId": "repoDownloadCommitDiffOrPatch", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "SHA of the commit to get", "name": "sha", "in": "path", "required": true }, { "enum": [ "diff", "patch" ], "type": "string", "description": "whether the output is diff or patch", "name": "diffType", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/string" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/git/notes/{sha}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库中单个提交对应的注释", "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 }, { "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" } ], "responses": { "200": { "$ref": "#/responses/Note" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/git/refs": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取指定的引用或过滤后的仓库引用", "operationId": "repoListAllGitRefs", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/ReferenceList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/git/refs/{ref}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取指定的引用或过滤后的仓库引用", "operationId": "repoListGitRefs", "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": "part or full name of the ref", "name": "ref", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/ReferenceList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/git/tags/{sha}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取注释标签的标签对象（非轻量标签）", "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 } ], "responses": { "200": { "$ref": "#/responses/AnnotatedTag" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/git/trees/{sha}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的树结构.", "operationId": "GetTree", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "sha of the commit", "name": "sha", "in": "path", "required": true }, { "type": "boolean", "description": "show all directories and files", "name": "recursive", "in": "query" }, { "type": "integer", "description": "页码；如果此页后仍有更多项目，响应中的'truncated'字段将为true，如果是最后一页则为false", "name": "page", "in": "query" }, { "type": "integer", "description": "number of items per page", "name": "per_page", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/GitTreeResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/hooks": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库中的钩子", "operationId": "repoListHooks", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/HookList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建钩子", "operationId": "repoCreateHook", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateHookOption" } } ], "responses": { "201": { "$ref": "#/responses/Hook" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/hooks/git": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库中的 Git 钩子", "operationId": "repoListGitHooks", "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": { "200": { "$ref": "#/responses/GitHookList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/hooks/git/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取 Git 钩子", "operationId": "repoGetGitHook", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the hook to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/GitHook" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库中的 Git 钩子", "operationId": "repoDeleteGitHook", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the hook to get", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑仓库中的 Git 钩子", "operationId": "repoEditGitHook", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "id of the hook to get", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditGitHookOption" } } ], "responses": { "200": { "$ref": "#/responses/GitHook" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/hooks/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取钩子", "operationId": "repoGetHook", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the hook to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Hook" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库中的钩子", "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 }, { "type": "integer", "format": "int64", "description": "id of the hook to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑仓库中的钩子", "operationId": "repoEditHook", "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 hook", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditHookOption" } } ], "responses": { "200": { "$ref": "#/responses/Hook" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/hooks/{id}/tests": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "测试推送 Webhook", "operationId": "repoTestHook", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the hook to 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" } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issue_config": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "返回仓库的问题配置", "operationId": "repoGetIssueConfig", "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": { "200": { "$ref": "#/responses/RepoIssueConfig" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issue_config/validate": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "返回问题配置的验证信息", "operationId": "repoValidateIssueConfig", "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": { "200": { "$ref": "#/responses/RepoIssueConfigValidation" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issue_templates": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库可用的问题模板", "operationId": "repoGetIssueTemplates", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/IssueTemplates" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出仓库的问题", "operationId": "issueListIssues", "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 }, { "enum": [ "closed", "open", "all" ], "type": "string", "description": "whether issue is open or closed", "name": "state", "in": "query" }, { "type": "string", "description": "comma separated list of labels. Fetch only issues that have any of this labels. Non existent labels are discarded", "name": "labels", "in": "query" }, { "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" }, { "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" }, { "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" }, { "type": "string", "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", "description": "Only show items which were created by the given user", "name": "created_by", "in": "query" }, { "type": "string", "description": "Only show items for which the given user is assigned", "name": "assigned_by", "in": "query" }, { "type": "string", "description": "Only show items in which the given user was mentioned", "name": "mentioned_by", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/IssueList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "创建问题.如果使用截止日期，则只考虑日期，忽略时间.", "operationId": "issueCreateIssue", "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/CreateIssueOption" } } ], "responses": { "201": { "$ref": "#/responses/Issue" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "412": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/comments": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出仓库中的所有评论", "operationId": "issueGetRepoComments", "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-time", "description": "if provided, only comments updated since the provided 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" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CommentList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/comments/{id}": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取评论", "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 }, { "type": "integer", "format": "int64", "description": "id of the comment", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Comment" }, "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "issue" ], "summary": "删除评论", "operationId": "issueDeleteComment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of comment to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "编辑评论", "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 }, { "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" } } ], "responses": { "200": { "$ref": "#/responses/Comment" }, "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/comments/{id}/assets": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出评论的附件", "operationId": "issueListIssueCommentAttachments", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/AttachmentList" }, "404": { "$ref": "#/responses/error" } } }, "post": { "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "创建评论附件", "operationId": "issueCreateIssueCommentAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "name of the attachment", "name": "name", "in": "query" }, { "type": "file", "description": "attachment to upload", "name": "attachment", "in": "formData", "required": true } ], "responses": { "201": { "$ref": "#/responses/Attachment" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取评论附件", "operationId": "issueGetIssueCommentAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment", "name": "id", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the attachment to get", "name": "attachment_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Attachment" }, "404": { "$ref": "#/responses/error" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "删除评论附件", "operationId": "issueDeleteIssueCommentAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment", "name": "id", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the attachment to delete", "name": "attachment_id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "编辑评论附件", "operationId": "issueEditIssueCommentAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment", "name": "id", "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" } } ], "responses": { "201": { "$ref": "#/responses/Attachment" }, "404": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/comments/{id}/reactions": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取问题评论的反应列表", "operationId": "issueGetCommentReactions", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment to edit", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/ReactionList" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "为问题评论添加反应", "operationId": "issuePostCommentReaction", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment to edit", "name": "id", "in": "path", "required": true }, { "name": "content", "in": "body", "schema": { "$ref": "#/definitions/EditReactionOption" } } ], "responses": { "200": { "$ref": "#/responses/Reaction" }, "201": { "$ref": "#/responses/Reaction" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "从问题评论中移除反应", "operationId": "issueDeleteCommentReaction", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the comment to edit", "name": "id", "in": "path", "required": true }, { "name": "content", "in": "body", "schema": { "$ref": "#/definitions/EditReactionOption" } } ], "responses": { "200": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/pinned": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的置顶问题", "operationId": "repoListPinnedIssues", "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": { "200": { "$ref": "#/responses/IssueList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取问题", "operationId": "issueGetIssue", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue to get", "name": "index", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Issue" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "issue" ], "summary": "删除问题", "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 }, { "type": "integer", "format": "int64", "description": "index of issue to delete", "name": "index", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "编辑问题.如果使用截止日期，则只考虑日期，忽略时间.", "operationId": "issueEditIssue", "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 to edit", "name": "index", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditIssueOption" } } ], "responses": { "201": { "$ref": "#/responses/Issue" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "412": { "$ref": "#/responses/error" } } } }, "/repos/{owner}/{repo}/issues/{index}/assets": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出问题的附件", "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 } ], "responses": { "200": { "$ref": "#/responses/AttachmentList" }, "404": { "$ref": "#/responses/error" } } }, "post": { "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "创建问题附件", "operationId": "issueCreateIssueAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "string", "description": "name of the attachment", "name": "name", "in": "query" }, { "type": "file", "description": "attachment to upload", "name": "attachment", "in": "formData", "required": true } ], "responses": { "201": { "$ref": "#/responses/Attachment" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取问题附件", "operationId": "issueGetIssueAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the attachment to get", "name": "attachment_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Attachment" }, "404": { "$ref": "#/responses/error" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "删除问题附件", "operationId": "issueDeleteIssueAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the attachment to delete", "name": "attachment_id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "编辑问题附件", "operationId": "issueEditIssueAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "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" } } ], "responses": { "201": { "$ref": "#/responses/Attachment" }, "404": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/{index}/blocks": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出被此问题阻止的问题", "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 }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/IssueList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "使用路径中的问题阻止请求体中的问题", "operationId": "issueCreateIssueBlocking", "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" } } ], "responses": { "201": { "$ref": "#/responses/Issue" }, "404": { "description": "the issue does not exist" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "取消路径中的问题对请求体中问题的阻止", "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" } } ], "responses": { "200": { "$ref": "#/responses/Issue" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/comments": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出问题上的所有评论", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "string", "format": "date-time", "description": "if provided, only comments updated since the specified time are returned.", "name": "since", "in": "query" }, { "type": "string", "format": "date-time", "description": "if provided, only comments updated before the provided time are returned.", "name": "before", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CommentList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "为问题添加评论", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateIssueCommentOption" } } ], "responses": { "201": { "$ref": "#/responses/Comment" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/{index}/comments/{id}": { "delete": { "tags": [ "issue" ], "summary": "删除评论", "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 }, { "type": "integer", "description": "this parameter is ignored", "name": "index", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of comment to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "编辑评论", "operationId": "issueEditCommentDeprecated", "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 }, { "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" } } ], "responses": { "200": { "$ref": "#/responses/Comment" }, "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/deadline": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "设置问题截止日期.如果设置为 null，则删除截止日期.如果使用截止日期，则只考虑日期，忽略时间.", "operationId": "issueEditIssueDeadline", "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 to create or update a deadline on", "name": "index", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditDeadlineOption" } } ], "responses": { "201": { "$ref": "#/responses/IssueDeadline" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/dependencies": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出问题的依赖项，即所有阻止此问题的问题.", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/IssueList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "使 URL 中的问题依赖于表单中的问题", "operationId": "issueCreateIssueDependencies", "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" } } ], "responses": { "201": { "$ref": "#/responses/Issue" }, "404": { "description": "the issue does not exist" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "移除问题依赖", "operationId": "issueRemoveIssueDependencies", "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" } } ], "responses": { "200": { "$ref": "#/responses/Issue" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/issues/{index}/labels": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取问题的标签", "operationId": "issueGetLabels", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/LabelList" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "替换问题的标签", "operationId": "issueReplaceLabels", "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/IssueLabelsOption" } } ], "responses": { "200": { "$ref": "#/responses/LabelList" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "向问题添加标签", "operationId": "issueAddLabel", "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/IssueLabelsOption" } } ], "responses": { "200": { "$ref": "#/responses/LabelList" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "移除问题的所有标签", "operationId": "issueClearLabels", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/labels/{id}": { "delete": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "从问题移除标签", "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 }, { "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/issues/{index}/lock": { "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "锁定问题", "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" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "解锁问题", "operationId": "issueUnlockIssue", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/pin": { "post": { "tags": [ "issue" ], "summary": "置顶问题", "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 }, { "type": "integer", "format": "int64", "description": "index of issue to pin", "name": "index", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "issue" ], "summary": "取消置顶问题", "operationId": "unpinIssue", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of issue to unpin", "name": "index", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/pin/{position}": { "patch": { "tags": [ "issue" ], "summary": "将置顶移动到指定位置", "operationId": "moveIssuePin", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of issue", "name": "index", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "the new position", "name": "position", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/reactions": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取问题的反应列表", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ReactionList" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "为问题添加反应", "operationId": "issuePostIssueReaction", "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": "content", "in": "body", "schema": { "$ref": "#/definitions/EditReactionOption" } } ], "responses": { "200": { "$ref": "#/responses/Reaction" }, "201": { "$ref": "#/responses/Reaction" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "从问题中移除反应", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "name": "content", "in": "body", "schema": { "$ref": "#/definitions/EditReactionOption" } } ], "responses": { "200": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/stopwatch/delete": { "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "删除问题的现有秒表.", "operationId": "issueDeleteStopWatch", "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 to stop the stopwatch on", "name": "index", "in": "path", "required": true } ], "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" } } } }, "/repos/{owner}/{repo}/issues/{index}/stopwatch/start": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "在问题上启动秒表.", "operationId": "issueStartStopWatch", "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 to create the stopwatch on", "name": "index", "in": "path", "required": true } ], "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" } } } }, "/repos/{owner}/{repo}/issues/{index}/stopwatch/stop": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "停止问题的现有秒表.", "operationId": "issueStopStopWatch", "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 to stop the stopwatch on", "name": "index", "in": "path", "required": true } ], "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}/{repo}/issues/{index}/subscriptions": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取订阅问题的用户.", "operationId": "issueSubscriptions", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/subscriptions/check": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "检查用户是否订阅了问题", "operationId": "issueCheckSubscription", "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 } ], "responses": { "200": { "$ref": "#/responses/WatchInfo" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/subscriptions/{user}": { "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "订阅用户到问题", "operationId": "issueAddSubscription", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "string", "description": "user to subscribe", "name": "user", "in": "path", "required": true } ], "responses": { "200": { "description": "Already subscribed" }, "201": { "description": "Successfully Subscribed" }, "304": { "description": "User can only subscribe itself if he is no admin" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "取消用户对问题的订阅", "operationId": "issueDeleteSubscription", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "string", "description": "user witch unsubscribe", "name": "user", "in": "path", "required": true } ], "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" } } } }, "/repos/{owner}/{repo}/issues/{index}/timeline": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出问题上的所有评论和事件", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "string", "format": "date-time", "description": "if provided, only comments updated since the specified time are returned.", "name": "since", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "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" } ], "responses": { "200": { "$ref": "#/responses/TimelineList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/times": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "列出问题的跟踪时间", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "string", "description": "optional filter by user (available for issue managers)", "name": "user", "in": "query" }, { "type": "string", "format": "date-time", "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format", "name": "since", "in": "query" }, { "type": "string", "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": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TrackedTimeList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "为问题添加跟踪时间", "operationId": "issueAddTime", "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/AddTimeOption" } } ], "responses": { "200": { "$ref": "#/responses/TrackedTime" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "重置问题的跟踪时间", "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 }, { "type": "integer", "format": "int64", "description": "index of the issue to add tracked time to", "name": "index", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/issues/{index}/times/{id}": { "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "删除特定的跟踪时间", "operationId": "issueDeleteTime", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the issue", "name": "index", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of time to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/keys": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的密钥", "operationId": "repoListKeys", "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": "the key_id to search for", "name": "key_id", "in": "query" }, { "type": "string", "description": "fingerprint of the key", "name": "fingerprint", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/DeployKeyList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "向仓库添加密钥", "operationId": "repoCreateKey", "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/CreateKeyOption" } } ], "responses": { "201": { "$ref": "#/responses/DeployKey" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/keys/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "根据 ID 获取仓库的密钥", "operationId": "repoGetKey", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the key to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/DeployKey" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "repository" ], "summary": "从仓库删除密钥", "operationId": "repoDeleteKey", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the key to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/labels": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取仓库的所有标签", "operationId": "issueListLabels", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/LabelList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "创建标签", "operationId": "issueCreateLabel", "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/CreateLabelOption" } } ], "responses": { "201": { "$ref": "#/responses/Label" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/labels/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取单个标签", "operationId": "issueGetLabel", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the label to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Label" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "issue" ], "summary": "删除标签", "operationId": "issueDeleteLabel", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the label to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "更新标签", "operationId": "issueEditLabel", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the label to edit", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditLabelOption" } } ], "responses": { "200": { "$ref": "#/responses/Label" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/languages": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取语言和编写的代码字节数", "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 } ], "responses": { "200": { "$ref": "#/responses/LanguageStatistics" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/licenses": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库许可证", "operationId": "repoGetLicenses", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/LicensesList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/media/{filepath}": { "get": { "produces": [ "application/octet-stream" ], "tags": [ "repository" ], "summary": "从仓库获取文件或其 LFS 对象", "operationId": "repoGetRawFileOrLFS", "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 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 the repository’s default branch", "name": "ref", "in": "query" } ], "responses": { "200": { "description": "Returns raw file content.", "schema": { "type": "file" } }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/merge-upstream": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "合并上游分支", "operationId": "repoMergeUpstream", "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/MergeUpstreamRequest" } } ], "responses": { "200": { "$ref": "#/responses/MergeUpstreamResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/milestones": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取仓库的所有开放里程碑", "operationId": "issueGetMilestonesList", "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": "Milestone state, Recognized values are open, closed and all. Defaults to \"open\"", "name": "state", "in": "query" }, { "type": "string", "description": "filter by milestone name", "name": "name", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/MilestoneList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "创建里程碑", "operationId": "issueCreateMilestone", "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/CreateMilestoneOption" } } ], "responses": { "201": { "$ref": "#/responses/Milestone" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/milestones/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "获取里程碑", "operationId": "issueGetMilestone", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "the milestone to get, identified by ID and if not available by name", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Milestone" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "issue" ], "summary": "删除里程碑", "operationId": "issueDeleteMilestone", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "the milestone to delete, identified by ID and if not available by name", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "issue" ], "summary": "更新里程碑", "operationId": "issueEditMilestone", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "the milestone to edit, identified by ID and if not available by name", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditMilestoneOption" } } ], "responses": { "200": { "$ref": "#/responses/Milestone" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/mirror-sync": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "同步镜像仓库", "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 } ], "responses": { "200": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/new_pin_allowed": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "返回是否允许新的问题置顶", "operationId": "repoNewPinAllowed", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/RepoNewIssuePinsAllowed" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/notifications": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "notification" ], "summary": "列出特定仓库上的用户通知线程", "operationId": "notifyGetRepoList", "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": "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" }, { "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" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/NotificationThreadList" } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "notification" ], "summary": "在特定仓库上将通知线程标记为已读、置顶或未读", "operationId": "notifyReadRepoList", "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": "If true, mark all notifications on this repo. Default value is false", "name": "all", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread.", "name": "status-types", "in": "query" }, { "type": "string", "description": "Status to mark notifications as. Defaults to read.", "name": "to-status", "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", "in": "query" } ], "responses": { "205": { "$ref": "#/responses/NotificationThreadList" } } } }, "/repos/{owner}/{repo}/pulls": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的拉取请求", "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" } ], "responses": { "200": { "$ref": "#/responses/PullRequestList" }, "404": { "$ref": "#/responses/notFound" }, "500": { "$ref": "#/responses/error" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建拉取请求", "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" } } ], "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" } } } }, "/repos/{owner}/{repo}/pulls/pinned": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的置顶拉取请求", "operationId": "repoListPinnedPullRequests", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/PullRequestList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{base}/{head}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过基础分支和头分支获取拉取请求", "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 }, { "type": "string", "description": "base of the pull request to get", "name": "base", "in": "path", "required": true }, { "type": "string", "description": "head of the pull request to get", "name": "head", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/PullRequest" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{index}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取拉取请求", "operationId": "repoGetPullRequest", "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 } ], "responses": { "200": { "$ref": "#/responses/PullRequest" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新拉取请求.如果使用截止日期，则只考虑日期，忽略时间.", "operationId": "repoEditPullRequest", "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 edit", "name": "index", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditPullRequestOption" } } ], "responses": { "201": { "$ref": "#/responses/PullRequest" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/error" }, "412": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/pulls/{index}.{diffType}": { "get": { "produces": [ "text/plain" ], "tags": [ "repository" ], "summary": "获取拉取请求的差异或补丁", "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 }, { "type": "integer", "format": "int64", "description": "index of the pull request to get", "name": "index", "in": "path", "required": true }, { "enum": [ "diff", "patch" ], "type": "string", "description": "whether the output is diff or patch", "name": "diffType", "in": "path", "required": true }, { "type": "boolean", "description": "whether to include binary file changes. if true, the diff is applicable with `git apply`", "name": "binary", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/string" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{index}/commits": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取拉取请求的提交", "operationId": "repoGetPullRequestCommits", "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": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "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" } ], "responses": { "200": { "$ref": "#/responses/CommitList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{index}/files": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取拉取请求的更改文件", "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" }, { "enum": [ "ignore-all", "ignore-change", "ignore-eol", "show-all" ], "type": "string", "description": "whitespace behavior", "name": "whitespace", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ChangedFileList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{index}/merge": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "检查拉取请求是否已合并", "operationId": "repoPullRequestIsMerged", "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 } ], "responses": { "204": { "description": "pull request has been merged" }, "404": { "description": "pull request has not been merged" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "合并拉取请求", "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 }, { "type": "integer", "format": "int64", "description": "index of the pull request to merge", "name": "index", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/MergePullRequestOption" } } ], "responses": { "200": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "405": { "$ref": "#/responses/empty" }, "409": { "$ref": "#/responses/error" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "取消给定拉取请求的计划自动合并", "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 }, { "type": "integer", "format": "int64", "description": "index of the pull request to merge", "name": "index", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/pulls/{index}/requested_reviewers": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为拉取请求创建审查请求", "operationId": "repoCreatePullReviewRequests", "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": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/PullReviewRequestOptions" } } ], "responses": { "201": { "$ref": "#/responses/PullReviewList" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "取消拉取请求的审查请求", "operationId": "repoDeletePullReviewRequests", "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": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/PullReviewRequestOptions" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/pulls/{index}/reviews": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出拉取请求的所有审查", "operationId": "repoListPullReviews", "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 }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/PullReviewList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为拉取请求创建审查", "operationId": "repoCreatePullReview", "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": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreatePullReviewOptions" } } ], "responses": { "200": { "$ref": "#/responses/PullReview" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/pulls/{index}/reviews/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取拉取请求的特定审查", "operationId": "repoGetPullReview", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "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 } ], "responses": { "200": { "$ref": "#/responses/PullReview" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "向拉取请求提交待处理的审查", "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 }, { "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 }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/SubmitPullReviewOptions" } } ], "responses": { "200": { "$ref": "#/responses/PullReview" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从拉取请求中删除特定审查", "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 }, { "type": "integer", "format": "int64", "description": "id of the review", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/comments": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取拉取请求的特定审查", "operationId": "repoGetPullReviewComments", "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 }, { "type": "integer", "format": "int64", "description": "id of the review", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/PullReviewCommentList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/dismissals": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "驳回拉取请求的审查", "operationId": "repoDismissPullReview", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "index of the pull request", "name": "index", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the review", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/DismissPullReviewOptions" } } ], "responses": { "200": { "$ref": "#/responses/PullReview" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/undismissals": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "取消驳回拉取请求的审查", "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 }, { "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 } ], "responses": { "200": { "$ref": "#/responses/PullReview" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/pulls/{index}/update": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "将 PR 的基础分支合并到头分支", "operationId": "repoUpdatePullRequest", "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 }, { "enum": [ "merge", "rebase" ], "type": "string", "description": "how to update pull request", "name": "style", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/push_mirrors": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的所有推送镜像", "operationId": "repoListPushMirrors", "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": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/PushMirrorList" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为仓库添加推送镜像", "operationId": "repoAddPushMirror", "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/CreatePushMirrorOption" } } ], "responses": { "200": { "$ref": "#/responses/PushMirror" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/push_mirrors-sync": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "同步所有推送镜像仓库", "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 } ], "responses": { "200": { "$ref": "#/responses/empty" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/push_mirrors/{name}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过远程名称获取仓库的推送镜像", "operationId": "repoGetPushMirrorByRemoteName", "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": "remote name of push mirror", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/PushMirror" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过远程名称删除仓库的推送镜像", "operationId": "repoDeletePushMirror", "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": "remote name of the pushMirror", "name": "name", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/raw/{filepath}": { "get": { "produces": [ "application/octet-stream" ], "tags": [ "repository" ], "summary": "从仓库获取文件", "operationId": "repoGetRawFile", "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 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 the repository’s default branch", "name": "ref", "in": "query" } ], "responses": { "200": { "description": "Returns raw file content.", "schema": { "type": "file" } }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/releases": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的发布版本", "operationId": "repoListReleases", "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": "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", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ReleaseList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建发布版本", "operationId": "repoCreateRelease", "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/CreateReleaseOption" } } ], "responses": { "201": { "$ref": "#/responses/Release" }, "404": { "$ref": "#/responses/notFound" }, "409": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/releases/latest": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库中最新的非预发布、非草稿发布版本，按创建时间排序", "operationId": "repoGetLatestRelease", "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": { "200": { "$ref": "#/responses/Release" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/releases/tags/{tag}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过标签名称获取发布版本", "operationId": "repoGetReleaseByTag", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "tag name of the release to get", "name": "tag", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Release" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "repository" ], "summary": "通过标签名称删除发布版本", "operationId": "repoDeleteReleaseByTag", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "tag name of the release to delete", "name": "tag", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/releases/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取发布版本", "operationId": "repoGetRelease", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Release" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "repository" ], "summary": "删除发布版本", "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 }, { "type": "integer", "format": "int64", "description": "id of the release to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "更新发布版本", "operationId": "repoEditRelease", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release to edit", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditReleaseOption" } } ], "responses": { "200": { "$ref": "#/responses/Release" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/releases/{id}/assets": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出发布版本的附件", "operationId": "repoListReleaseAttachments", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/AttachmentList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "multipart/form-data", "application/octet-stream" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建发布版本附件", "operationId": "repoCreateReleaseAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "name of the attachment", "name": "name", "in": "query" }, { "type": "file", "description": "attachment to upload", "name": "attachment", "in": "formData" } ], "responses": { "201": { "$ref": "#/responses/Attachment" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取发布版本附件", "operationId": "repoGetReleaseAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release", "name": "id", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the attachment to get", "name": "attachment_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Attachment" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除发布版本附件", "operationId": "repoDeleteReleaseAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release", "name": "id", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the attachment to delete", "name": "attachment_id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑发布版本附件", "operationId": "repoEditReleaseAttachment", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "id of the release", "name": "id", "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" } } ], "responses": { "201": { "$ref": "#/responses/Attachment" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/reviewers": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "返回可以在此仓库中请求审查的所有用户", "operationId": "repoGetReviewers", "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": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/signing-key.gpg": { "get": { "produces": [ "text/plain" ], "tags": [ "repository" ], "summary": "获取给定仓库的签名密钥 signing-key.gpg", "operationId": "repoSigningKey", "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": { "200": { "description": "GPG armored public key", "schema": { "type": "string" } } } } }, "/repos/{owner}/{repo}/stargazers": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的星标用户", "operationId": "repoListStargazers", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/statuses/{sha}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取提交的状态", "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 }, { "type": "string", "description": "sha of the commit", "name": "sha", "in": "path", "required": true }, { "enum": [ "oldest", "recentupdate", "leastupdate", "leastindex", "highestindex" ], "type": "string", "description": "type of sort", "name": "sort", "in": "query" }, { "enum": [ "pending", "success", "error", "failure", "warning" ], "type": "string", "description": "type of state", "name": "state", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/CommitStatusList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "创建提交状态", "operationId": "repoCreateStatus", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "sha of the commit", "name": "sha", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateStatusOption" } } ], "responses": { "201": { "$ref": "#/responses/CommitStatus" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/subscribers": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的关注者", "operationId": "repoListSubscribers", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/subscription": { "get": { "tags": [ "repository" ], "summary": "检查当前用户是否正在关注仓库", "operationId": "userCurrentCheckSubscription", "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": { "200": { "$ref": "#/responses/WatchInfo" }, "404": { "description": "User is not watching this repo or repo do not exist" } } }, "put": { "tags": [ "repository" ], "summary": "关注仓库", "operationId": "userCurrentPutSubscription", "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": { "200": { "$ref": "#/responses/WatchInfo" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "repository" ], "summary": "取消关注仓库", "operationId": "userCurrentDeleteSubscription", "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" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/tag_protections": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的标签保护规则", "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 } ], "responses": { "200": { "$ref": "#/responses/TagProtectionList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为仓库创建标签保护规则", "operationId": "repoCreateTagProtection", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateTagProtectionOption" } } ], "responses": { "201": { "$ref": "#/responses/TagProtection" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/tag_protections/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库的特定标签保护规则", "operationId": "repoGetTagProtection", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "id of the tag protect to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/TagProtection" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "删除仓库的特定标签保护规则", "operationId": "repoDeleteTagProtection", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑仓库的标签保护规则.只有设置的字段会被更改", "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" } } ], "responses": { "200": { "$ref": "#/responses/TagProtection" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/tags": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的标签", "operationId": "repoListTags", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小，默认最大页面大小为50", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TagList" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "在仓库中创建新的 Git 标签", "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" } } ], "responses": { "200": { "$ref": "#/responses/Tag" }, "404": { "$ref": "#/responses/notFound" }, "405": { "$ref": "#/responses/empty" }, "409": { "$ref": "#/responses/conflict" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/tags/{tag}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过标签名称获取仓库的标签", "operationId": "repoGetTag", "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", "name": "tag", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Tag" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过名称删除仓库的标签", "operationId": "repoDeleteTag", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "405": { "$ref": "#/responses/empty" }, "409": { "$ref": "#/responses/conflict" }, "422": { "$ref": "#/responses/validationError" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/teams": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的团队", "operationId": "repoListTeams", "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": { "200": { "$ref": "#/responses/TeamList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/teams/{team}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "检查团队是否已分配到仓库", "operationId": "repoCheckTeam", "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": "team name", "name": "team", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Team" }, "404": { "$ref": "#/responses/notFound" }, "405": { "$ref": "#/responses/error" } } }, "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为仓库添加团队", "operationId": "repoAddTeam", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "team name", "name": "team", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "405": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从仓库中删除团队", "operationId": "repoDeleteTeam", "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": "team name", "name": "team", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "405": { "$ref": "#/responses/error" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/times": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出仓库的跟踪时间", "operationId": "repoTrackedTimes", "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": "optional filter by user (available for issue managers)", "name": "user", "in": "query" }, { "type": "string", "format": "date-time", "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format", "name": "since", "in": "query" }, { "type": "string", "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": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TrackedTimeList" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/times/{user}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "列出用户在仓库中的跟踪时间", "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 }, { "type": "string", "description": "username of user", "name": "user", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/TrackedTimeList" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/topics": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取仓库拥有的主题列表", "operationId": "repoListTopics", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TopicNames" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "替换仓库的主题列表", "operationId": "repoUpdateTopics", "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/RepoTopicOptions" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/invalidTopicsError" } } } }, "/repos/{owner}/{repo}/topics/{topic}": { "put": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "为仓库添加主题", "operationId": "repoAddTopic", "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 add", "name": "topic", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/invalidTopicsError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "从仓库中删除主题", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/invalidTopicsError" } } } }, "/repos/{owner}/{repo}/transfer": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "转移仓库所有权", "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" } } ], "responses": { "202": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/repos/{owner}/{repo}/transfer/accept": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "接受仓库转移", "operationId": "acceptRepoTransfer", "parameters": [ { "type": "string", "description": "owner of the repo to transfer", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to transfer", "name": "repo", "in": "path", "required": true } ], "responses": { "202": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/transfer/reject": { "post": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "拒绝仓库转移", "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 } ], "responses": { "200": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/wiki/new": { "post": { "consumes": [ "application/json" ], "tags": [ "repository" ], "summary": "创建 Wiki 页面", "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" } } ], "responses": { "201": { "$ref": "#/responses/WikiPage" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/wiki/page/{pageName}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取 Wiki 页面", "operationId": "repoGetWikiPage", "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 } ], "responses": { "200": { "$ref": "#/responses/WikiPage" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "repository" ], "summary": "删除 Wiki 页面", "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 } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } }, "patch": { "consumes": [ "application/json" ], "tags": [ "repository" ], "summary": "编辑 Wiki 页面", "operationId": "repoEditWikiPage", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "name of the page", "name": "pageName", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateWikiPageOptions" } } ], "responses": { "200": { "$ref": "#/responses/WikiPage" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "423": { "$ref": "#/responses/repoArchivedError" } } } }, "/repos/{owner}/{repo}/wiki/pages": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取所有 Wiki 页面", "operationId": "repoGetWikiPages", "parameters": [ { "type": "string", "description": "owner of the repo", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/WikiPageList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{owner}/{repo}/wiki/revisions/{pageName}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "获取 Wiki 页面的修订版本", "operationId": "repoGetWikiPageRevisions", "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", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/WikiCommitList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/repos/{template_owner}/{template_repo}/generate": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "使用模板创建仓库", "operationId": "generateRepo", "parameters": [ { "type": "string", "description": "name of the template repository owner", "name": "template_owner", "in": "path", "required": true }, { "type": "string", "description": "name of the template repository", "name": "template_repo", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/GenerateRepoOption" } } ], "responses": { "201": { "$ref": "#/responses/Repository" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "409": { "description": "The repository with the same name already exists." }, "422": { "$ref": "#/responses/validationError" } } } }, "/repositories/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过 ID 获取仓库", "operationId": "repoGetByID", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the repo to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Repository" }, "404": { "$ref": "#/responses/notFound" } } } }, "/settings/api": { "get": { "produces": [ "application/json" ], "tags": [ "settings" ], "summary": "获取实例的 API 全局设置", "operationId": "getGeneralAPISettings", "responses": { "200": { "$ref": "#/responses/GeneralAPISettings" } } } }, "/settings/attachment": { "get": { "produces": [ "application/json" ], "tags": [ "settings" ], "summary": "获取实例的附件全局设置", "operationId": "getGeneralAttachmentSettings", "responses": { "200": { "$ref": "#/responses/GeneralAttachmentSettings" } } } }, "/settings/repository": { "get": { "produces": [ "application/json" ], "tags": [ "settings" ], "summary": "获取实例的仓库全局设置", "operationId": "getGeneralRepositorySettings", "responses": { "200": { "$ref": "#/responses/GeneralRepoSettings" } } } }, "/settings/ui": { "get": { "produces": [ "application/json" ], "tags": [ "settings" ], "summary": "获取实例的 UI 全局设置", "operationId": "getGeneralUISettings", "responses": { "200": { "$ref": "#/responses/GeneralUISettings" } } } }, "/signing-key.gpg": { "get": { "produces": [ "text/plain" ], "tags": [ "miscellaneous" ], "summary": "获取默认的签名密钥 signing-key.gpg", "operationId": "getSigningKey", "responses": { "200": { "description": "GPG armored public key", "schema": { "type": "string" } } } } }, "/teams/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取团队", "operationId": "orgGetTeam", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Team" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "organization" ], "summary": "删除团队", "operationId": "orgDeleteTeam", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "description": "team deleted" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "编辑团队", "operationId": "orgEditTeam", "parameters": [ { "type": "integer", "description": "id of the team to edit", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditTeamOption" } } ], "responses": { "200": { "$ref": "#/responses/Team" }, "404": { "$ref": "#/responses/notFound" } } } }, "/teams/{id}/activities/feeds": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出团队的活动动态", "operationId": "orgListTeamActivityFeeds", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "format": "date", "description": "the date of the activities to be found", "name": "date", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ActivityFeedsList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/teams/{id}/members": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出团队成员", "operationId": "orgListTeamMembers", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/teams/{id}/members/{username}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出团队的特定成员", "operationId": "orgListTeamMember", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "username of the member to list", "name": "username", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/User" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "添加团队成员", "operationId": "orgAddTeamMember", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "username of the user to add", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "移除团队成员", "operationId": "orgRemoveTeamMember", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "username of the user to remove", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/teams/{id}/repos": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出团队的仓库", "operationId": "orgListTeamRepos", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/teams/{id}/repos/{org}/{repo}": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出团队的特定仓库", "operationId": "orgListTeamRepo", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "organization that owns the repo to list", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to list", "name": "repo", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Repository" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "为团队添加仓库", "operationId": "orgAddTeamRepository", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "organization that owns the repo to add", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to add", "name": "repo", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "description": "This does not delete the repository, it only removes the repository from the team.", "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "从团队中移除仓库", "operationId": "orgRemoveTeamRepository", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the team", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "organization that owns the repo to remove", "name": "org", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to remove", "name": "repo", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/topics/search": { "get": { "produces": [ "application/json" ], "tags": [ "repository" ], "summary": "通过关键字搜索主题", "operationId": "topicSearch", "parameters": [ { "type": "string", "description": "keywords to search", "name": "q", "in": "query", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TopicListResponse" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取已认证的用户", "operationId": "userGetCurrent", "responses": { "200": { "$ref": "#/responses/User" } } } }, "/user/actions/runners": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户级别的运行器", "operationId": "getUserRunners", "responses": { "200": { "$ref": "#/definitions/ActionRunnersResponse" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/actions/runners/registration-token": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户的 Action 运行器注册令牌", "operationId": "userGetRunnerRegistrationToken", "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } }, "post": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户的 Action 运行器注册令牌", "operationId": "userCreateRunnerRegistrationToken", "responses": { "200": { "$ref": "#/responses/RegistrationToken" } } } }, "/user/actions/runners/{runner_id}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户级别的运行器", "operationId": "getUserRunner", "parameters": [ { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/definitions/ActionRunner" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除用户级别的运行器", "operationId": "deleteUserRunner", "parameters": [ { "type": "string", "description": "运行器的ID", "name": "runner_id", "in": "path", "required": true } ], "responses": { "204": { "description": "运行器已被删除" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/actions/secrets/{secretname}": { "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "在用户范围内创建或更新密钥值", "operationId": "updateUserSecret", "parameters": [ { "type": "string", "description": "name of the secret", "name": "secretname", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateOrUpdateSecretOption" } } ], "responses": { "201": { "description": "response when creating a secret" }, "204": { "description": "response when updating a secret" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除用户范围内的密钥", "operationId": "deleteUserSecret", "parameters": [ { "type": "string", "description": "name of the secret", "name": "secretname", "in": "path", "required": true } ], "responses": { "204": { "description": "delete one secret of the user" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/actions/variables": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取由当前操作者创建的用户级别变量列表", "operationId": "getUserVariablesList", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/VariableList" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/actions/variables/{variablename}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取由当前操作者创建的用户级别变量", "operationId": "getUserVariable", "parameters": [ { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/ActionVariable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "更新由当前操作者创建的用户级别变量", "operationId": "updateUserVariable", "parameters": [ { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UpdateVariableOption" } } ], "responses": { "201": { "description": "response when updating a variable" }, "204": { "description": "response when updating a variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "创建用户级别的变量", "operationId": "createUserVariable", "parameters": [ { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateVariableOption" } } ], "responses": { "201": { "description": "response when creating a variable" }, "204": { "description": "response when creating a variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除由当前操作者创建的用户级别变量", "operationId": "deleteUserVariable", "parameters": [ { "type": "string", "description": "name of the variable", "name": "variablename", "in": "path", "required": true } ], "responses": { "201": { "description": "response when deleting a variable" }, "204": { "description": "response when deleting a variable" }, "400": { "$ref": "#/responses/error" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/applications/oauth2": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户的 OAuth2 应用程序", "operationId": "userGetOauth2Application", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/OAuth2ApplicationList" } } }, "post": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "创建新的 OAuth2 应用程序", "operationId": "userCreateOAuth2Application", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateOAuth2ApplicationOptions" } } ], "responses": { "201": { "$ref": "#/responses/OAuth2Application" }, "400": { "$ref": "#/responses/error" } } } }, "/user/applications/oauth2/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取 OAuth2 应用程序", "operationId": "userGetOAuth2Application", "parameters": [ { "type": "integer", "format": "int64", "description": "Application ID to be found", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/OAuth2Application" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除 OAuth2 应用程序", "operationId": "userDeleteOAuth2Application", "parameters": [ { "type": "integer", "format": "int64", "description": "token to be deleted", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "patch": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "更新 OAuth2 应用程序，包括重新生成客户端密钥", "operationId": "userUpdateOAuth2Application", "parameters": [ { "type": "integer", "format": "int64", "description": "application to be updated", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateOAuth2ApplicationOptions" } } ], "responses": { "200": { "$ref": "#/responses/OAuth2Application" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/avatar": { "post": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "更新头像", "operationId": "userUpdateAvatar", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UpdateUserAvatarOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除头像", "operationId": "userDeleteAvatar", "responses": { "204": { "$ref": "#/responses/empty" } } } }, "/user/blocks": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出被认证用户屏蔽的用户", "operationId": "userListBlocks", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" } } } }, "/user/blocks/{username}": { "get": { "tags": [ "user" ], "summary": "检查用户是否被认证用户屏蔽", "operationId": "userCheckUserBlock", "parameters": [ { "type": "string", "description": "user to check", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "tags": [ "user" ], "summary": "屏蔽用户", "operationId": "userBlockUser", "parameters": [ { "type": "string", "description": "user to block", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "optional note for the block", "name": "note", "in": "query" } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "tags": [ "user" ], "summary": "取消屏蔽用户", "operationId": "userUnblockUser", "parameters": [ { "type": "string", "description": "user to unblock", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/user/emails": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出已认证用户的邮箱地址", "operationId": "userListEmails", "responses": { "200": { "$ref": "#/responses/EmailList" } } }, "post": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "添加邮箱地址", "operationId": "userAddEmail", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateEmailOption" } } ], "responses": { "201": { "$ref": "#/responses/EmailList" }, "422": { "$ref": "#/responses/validationError" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除邮箱地址", "operationId": "userDeleteEmail", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/DeleteEmailOption" } } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/followers": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户的关注者", "operationId": "userCurrentListFollowers", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" } } } }, "/user/following": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户正在关注的用户", "operationId": "userCurrentListFollowing", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" } } } }, "/user/following/{username}": { "get": { "tags": [ "user" ], "summary": "检查用户是否被认证用户关注", "operationId": "userCurrentCheckFollowing", "parameters": [ { "type": "string", "description": "username of followed user", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "tags": [ "user" ], "summary": "关注用户", "operationId": "userCurrentPutFollow", "parameters": [ { "type": "string", "description": "username of user to follow", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "user" ], "summary": "取消关注用户", "operationId": "userCurrentDeleteFollow", "parameters": [ { "type": "string", "description": "username of user to unfollow", "name": "username", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/gpg_key_token": { "get": { "produces": [ "text/plain" ], "tags": [ "user" ], "summary": "获取要验证的令牌", "operationId": "getVerificationToken", "responses": { "200": { "$ref": "#/responses/string" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/gpg_key_verify": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "验证 GPG 密钥", "operationId": "userVerifyGPGKey", "responses": { "201": { "$ref": "#/responses/GPGKey" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/user/gpg_keys": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出已认证用户的GPG密钥", "operationId": "userCurrentListGPGKeys", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/GPGKeyList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "创建 GPG 密钥", "operationId": "userCurrentPostGPGKey", "parameters": [ { "name": "Form", "in": "body", "schema": { "$ref": "#/definitions/CreateGPGKeyOption" } } ], "responses": { "201": { "$ref": "#/responses/GPGKey" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/validationError" } } } }, "/user/gpg_keys/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取GPG密钥", "operationId": "userCurrentGetGPGKey", "parameters": [ { "type": "integer", "format": "int64", "description": "id of key to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/GPGKey" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "移除 GPG 密钥", "operationId": "userCurrentDeleteGPGKey", "parameters": [ { "type": "integer", "format": "int64", "description": "id of key to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/hooks": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户的 Webhook", "operationId": "userListHooks", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/HookList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "创建钩子", "operationId": "userCreateHook", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/CreateHookOption" } } ], "responses": { "201": { "$ref": "#/responses/Hook" } } } }, "/user/hooks/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取钩子", "operationId": "userGetHook", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the hook to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/Hook" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除钩子", "operationId": "userDeleteHook", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the hook to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "更新钩子", "operationId": "userEditHook", "parameters": [ { "type": "integer", "format": "int64", "description": "id of the hook to update", "name": "id", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/EditHookOption" } } ], "responses": { "200": { "$ref": "#/responses/Hook" } } } }, "/user/keys": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户的公钥", "operationId": "userCurrentListKeys", "parameters": [ { "type": "string", "description": "fingerprint of the key", "name": "fingerprint", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/PublicKeyList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "创建公钥", "operationId": "userCurrentPostKey", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateKeyOption" } } ], "responses": { "201": { "$ref": "#/responses/PublicKey" }, "422": { "$ref": "#/responses/validationError" } } } }, "/user/keys/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取公钥", "operationId": "userCurrentGetKey", "parameters": [ { "type": "integer", "format": "int64", "description": "id of key to get", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/PublicKey" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除公钥", "operationId": "userCurrentDeleteKey", "parameters": [ { "type": "integer", "format": "int64", "description": "id of key to delete", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/orgs": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出当前用户的组织", "operationId": "orgListCurrentUserOrgs", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/OrganizationList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/repos": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户拥有的仓库", "operationId": "userCurrentListRepos", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "repository", "user" ], "summary": "创建仓库", "operationId": "createCurrentUserRepo", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateRepoOption" } } ], "responses": { "201": { "$ref": "#/responses/Repository" }, "400": { "$ref": "#/responses/error" }, "409": { "description": "The repository with the same name already exists." }, "422": { "$ref": "#/responses/validationError" } } } }, "/user/settings": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户设置", "operationId": "getUserSettings", "responses": { "200": { "$ref": "#/responses/UserSettings" } } }, "patch": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "更新用户设置", "operationId": "updateUserSettings", "parameters": [ { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/UserSettingsOptions" } } ], "responses": { "200": { "$ref": "#/responses/UserSettings" } } } }, "/user/starred": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "认证用户已加星标的仓库", "operationId": "userCurrentListStarred", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/user/starred/{owner}/{repo}": { "get": { "tags": [ "user" ], "summary": "认证用户是否已为仓库加星标", "operationId": "userCurrentCheckStarring", "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" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "put": { "tags": [ "user" ], "summary": "为给定仓库加星标", "operationId": "userCurrentPutStar", "parameters": [ { "type": "string", "description": "owner of the repo to star", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to star", "name": "repo", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } }, "delete": { "tags": [ "user" ], "summary": "取消给定仓库的星标", "operationId": "userCurrentDeleteStar", "parameters": [ { "type": "string", "description": "owner of the repo to unstar", "name": "owner", "in": "path", "required": true }, { "type": "string", "description": "name of the repo to unstar", "name": "repo", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/user/stopwatches": { "get": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取所有现有秒表的列表", "operationId": "userGetStopWatches", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/StopWatchList" } } } }, "/user/subscriptions": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户关注的仓库", "operationId": "userCurrentListSubscriptions", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" } } } }, "/user/teams": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出用户所属的所有团队", "operationId": "userListTeams", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TeamList" } } } }, "/user/times": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出当前用户的跟踪时间", "operationId": "userCurrentTrackedTimes", "parameters": [ { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" }, { "type": "string", "format": "date-time", "description": "Only show times updated after the given time. This is a timestamp in RFC 3339 format", "name": "since", "in": "query" }, { "type": "string", "format": "date-time", "description": "Only show times updated before the given time. This is a timestamp in RFC 3339 format", "name": "before", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/TrackedTimeList" } } } }, "/users/search": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "搜索用户", "operationId": "userSearch", "parameters": [ { "type": "string", "description": "keyword", "name": "q", "in": "query" }, { "type": "integer", "format": "int64", "description": "ID of the user to search for", "name": "uid", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "description": "SearchResults of a successful search", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/User" } }, "ok": { "type": "boolean" } } } } } } }, "/users/{username}": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户", "operationId": "userGet", "parameters": [ { "type": "string", "description": "username of user to get", "name": "username", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/User" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/activities/feeds": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出用户的活动动态", "operationId": "userListActivityFeeds", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "boolean", "description": "if true, only show actions performed by the requested user", "name": "only-performed-by", "in": "query" }, { "type": "string", "format": "date", "description": "the date of the activities to be found", "name": "date", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/ActivityFeedsList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/followers": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出给定用户的关注者", "operationId": "userListFollowers", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/following": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出给定用户正在关注的用户", "operationId": "userListFollowing", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/UserList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/following/{target}": { "get": { "tags": [ "user" ], "summary": "检查一个用户是否正在关注另一个用户", "operationId": "userCheckFollowing", "parameters": [ { "type": "string", "description": "username of following user", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "username of followed user", "name": "target", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/gpg_keys": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出给定用户的 GPG 密钥", "operationId": "userListGPGKeys", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/GPGKeyList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/heatmap": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "获取用户的热力图", "operationId": "userGetHeatmapData", "parameters": [ { "type": "string", "description": "username of user to get", "name": "username", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/UserHeatmapData" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/keys": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出给定用户的公钥", "operationId": "userListKeys", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "fingerprint of the key", "name": "fingerprint", "in": "query" }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/PublicKeyList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/orgs": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "列出用户的组织", "operationId": "orgListUserOrgs", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/OrganizationList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/orgs/{org}/permissions": { "get": { "produces": [ "application/json" ], "tags": [ "organization" ], "summary": "获取用户在组织中的权限", "operationId": "orgGetUserPermissions", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "name of the organization", "name": "org", "in": "path", "required": true } ], "responses": { "200": { "$ref": "#/responses/OrganizationPermissions" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/repos": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出给定用户拥有的仓库", "operationId": "userListRepos", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/starred": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "给定用户已加星标的仓库", "operationId": "userListStarred", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/subscriptions": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出用户关注的仓库", "operationId": "userListSubscriptions", "parameters": [ { "type": "string", "description": "username of the user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/RepositoryList" }, "404": { "$ref": "#/responses/notFound" } } } }, "/users/{username}/tokens": { "get": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "列出认证用户的访问令牌", "operationId": "userGetTokens", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "integer", "description": "返回结果的页码（从1开始）", "name": "page", "in": "query" }, { "type": "integer", "description": "返回结果的页面大小", "name": "limit", "in": "query" } ], "responses": { "200": { "$ref": "#/responses/AccessTokenList" }, "403": { "$ref": "#/responses/forbidden" } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "user" ], "summary": "创建访问令牌", "operationId": "userCreateToken", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "name": "body", "in": "body", "schema": { "$ref": "#/definitions/CreateAccessTokenOption" } } ], "responses": { "201": { "$ref": "#/responses/AccessToken" }, "400": { "$ref": "#/responses/error" }, "403": { "$ref": "#/responses/forbidden" } } } }, "/users/{username}/tokens/{token}": { "delete": { "produces": [ "application/json" ], "tags": [ "user" ], "summary": "删除访问令牌", "operationId": "userDeleteAccessToken", "parameters": [ { "type": "string", "description": "username of user", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "token to be deleted, identified by ID and if not available by name", "name": "token", "in": "path", "required": true } ], "responses": { "204": { "$ref": "#/responses/empty" }, "403": { "$ref": "#/responses/forbidden" }, "404": { "$ref": "#/responses/notFound" }, "422": { "$ref": "#/responses/error" } } } }, "/version": { "get": { "produces": [ "application/json" ], "tags": [ "miscellaneous" ], "summary": "返回 Gitea 应用程序的版本", "operationId": "getVersion", "responses": { "200": { "$ref": "#/responses/ServerVersion" } } } } }, "definitions": { "APIError": { "description": "APIError is an api error with a message", "type": "object", "properties": { "message": { "type": "string", "x-go-name": "Message" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "AccessToken": { "type": "object", "title": "AccessToken represents an API access token.", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "last_used_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "name": { "type": "string", "x-go-name": "Name" }, "scopes": { "type": "array", "items": { "type": "string" }, "x-go-name": "Scopes" }, "sha1": { "type": "string", "x-go-name": "Token" }, "token_last_eight": { "type": "string", "x-go-name": "TokenLastEight" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionArtifact": { "description": "ActionArtifact represents a ActionArtifact", "type": "object", "properties": { "archive_download_url": { "type": "string", "x-go-name": "ArchiveDownloadURL" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "CreatedAt" }, "expired": { "type": "boolean", "x-go-name": "Expired" }, "expires_at": { "type": "string", "format": "date-time", "x-go-name": "ExpiresAt" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "size_in_bytes": { "type": "integer", "format": "int64", "x-go-name": "SizeInBytes" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "UpdatedAt" }, "url": { "type": "string", "x-go-name": "URL" }, "workflow_run": { "$ref": "#/definitions/ActionWorkflowRun" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionArtifactsResponse": { "description": "ActionArtifactsResponse returns ActionArtifacts", "type": "object", "properties": { "artifacts": { "type": "array", "items": { "$ref": "#/definitions/ActionArtifact" }, "x-go-name": "Entries" }, "total_count": { "type": "integer", "format": "int64", "x-go-name": "TotalCount" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionRunner": { "description": "ActionRunner represents a Runner", "type": "object", "properties": { "busy": { "type": "boolean", "x-go-name": "Busy" }, "ephemeral": { "type": "boolean", "x-go-name": "Ephemeral" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "labels": { "type": "array", "items": { "$ref": "#/definitions/ActionRunnerLabel" }, "x-go-name": "Labels" }, "name": { "type": "string", "x-go-name": "Name" }, "status": { "type": "string", "x-go-name": "Status" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionRunnerLabel": { "description": "ActionRunnerLabel represents a Runner Label", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "type": { "type": "string", "x-go-name": "Type" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionRunnersResponse": { "description": "ActionRunnersResponse returns Runners", "type": "object", "properties": { "runners": { "type": "array", "items": { "$ref": "#/definitions/ActionRunner" }, "x-go-name": "Entries" }, "total_count": { "type": "integer", "format": "int64", "x-go-name": "TotalCount" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionTask": { "description": "ActionTask represents a ActionTask", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "CreatedAt" }, "display_title": { "type": "string", "x-go-name": "DisplayTitle" }, "event": { "type": "string", "x-go-name": "Event" }, "head_branch": { "type": "string", "x-go-name": "HeadBranch" }, "head_sha": { "type": "string", "x-go-name": "HeadSHA" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "run_number": { "type": "integer", "format": "int64", "x-go-name": "RunNumber" }, "run_started_at": { "type": "string", "format": "date-time", "x-go-name": "RunStartedAt" }, "status": { "type": "string", "x-go-name": "Status" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "UpdatedAt" }, "url": { "type": "string", "x-go-name": "URL" }, "workflow_id": { "type": "string", "x-go-name": "WorkflowID" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionTaskResponse": { "description": "ActionTaskResponse returns a ActionTask", "type": "object", "properties": { "total_count": { "type": "integer", "format": "int64", "x-go-name": "TotalCount" }, "workflow_runs": { "type": "array", "items": { "$ref": "#/definitions/ActionTask" }, "x-go-name": "Entries" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionVariable": { "description": "ActionVariable return value of the query API", "type": "object", "properties": { "data": { "description": "the value of the variable", "type": "string", "x-go-name": "Data" }, "description": { "description": "the description of the variable", "type": "string", "x-go-name": "Description" }, "name": { "description": "the name of the variable", "type": "string", "x-go-name": "Name" }, "owner_id": { "description": "the owner to which the variable belongs", "type": "integer", "format": "int64", "x-go-name": "OwnerID" }, "repo_id": { "description": "the repository to which the variable belongs", "type": "integer", "format": "int64", "x-go-name": "RepoID" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionWorkflow": { "description": "ActionWorkflow represents a ActionWorkflow", "type": "object", "properties": { "badge_url": { "type": "string", "x-go-name": "BadgeURL" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "CreatedAt" }, "deleted_at": { "type": "string", "format": "date-time", "x-go-name": "DeletedAt" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "string", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "path": { "type": "string", "x-go-name": "Path" }, "state": { "type": "string", "x-go-name": "State" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "UpdatedAt" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionWorkflowResponse": { "description": "ActionWorkflowResponse returns a ActionWorkflow", "type": "object", "properties": { "total_count": { "type": "integer", "format": "int64", "x-go-name": "TotalCount" }, "workflows": { "type": "array", "items": { "$ref": "#/definitions/ActionWorkflow" }, "x-go-name": "Workflows" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActionWorkflowRun": { "description": "ActionWorkflowRun represents a WorkflowRun", "type": "object", "properties": { "head_sha": { "type": "string", "x-go-name": "HeadSha" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "repository_id": { "type": "integer", "format": "int64", "x-go-name": "RepositoryID" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Activity": { "type": "object", "properties": { "act_user": { "$ref": "#/definitions/User" }, "act_user_id": { "type": "integer", "format": "int64", "x-go-name": "ActUserID" }, "comment": { "$ref": "#/definitions/Comment" }, "comment_id": { "type": "integer", "format": "int64", "x-go-name": "CommentID" }, "content": { "type": "string", "x-go-name": "Content" }, "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "is_private": { "type": "boolean", "x-go-name": "IsPrivate" }, "op_type": { "description": "the type of action", "type": "string", "enum": [ "create_repo", "rename_repo", "star_repo", "watch_repo", "commit_repo", "create_issue", "create_pull_request", "transfer_repo", "push_tag", "comment_issue", "merge_pull_request", "close_issue", "reopen_issue", "close_pull_request", "reopen_pull_request", "delete_tag", "delete_branch", "mirror_sync_push", "mirror_sync_create", "mirror_sync_delete", "approve_pull_request", "reject_pull_request", "comment_pull", "publish_release", "pull_review_dismissed", "pull_request_ready_for_review", "auto_merge_pull_request" ], "x-go-name": "OpType" }, "ref_name": { "type": "string", "x-go-name": "RefName" }, "repo": { "$ref": "#/definitions/Repository" }, "repo_id": { "type": "integer", "format": "int64", "x-go-name": "RepoID" }, "user_id": { "type": "integer", "format": "int64", "x-go-name": "UserID" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ActivityPub": { "description": "ActivityPub type", "type": "object", "properties": { "@context": { "type": "string", "x-go-name": "Context" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "AddCollaboratorOption": { "description": "AddCollaboratorOption options when adding a user as a collaborator of a repository", "type": "object", "properties": { "permission": { "type": "string", "enum": [ "read", "write", "admin" ], "x-go-name": "Permission" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "AddTimeOption": { "description": "AddTimeOption options for adding time to an issue", "type": "object", "required": [ "time" ], "properties": { "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "time": { "description": "time in seconds", "type": "integer", "format": "int64", "x-go-name": "Time" }, "user_name": { "description": "User who spent the time (optional)", "type": "string", "x-go-name": "User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "AnnotatedTag": { "description": "AnnotatedTag represents an annotated tag", "type": "object", "properties": { "message": { "type": "string", "x-go-name": "Message" }, "object": { "$ref": "#/definitions/AnnotatedTagObject" }, "sha": { "type": "string", "x-go-name": "SHA" }, "tag": { "type": "string", "x-go-name": "Tag" }, "tagger": { "$ref": "#/definitions/CommitUser" }, "url": { "type": "string", "x-go-name": "URL" }, "verification": { "$ref": "#/definitions/PayloadCommitVerification" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "AnnotatedTagObject": { "description": "AnnotatedTagObject contains meta information of the tag object", "type": "object", "properties": { "sha": { "type": "string", "x-go-name": "SHA" }, "type": { "type": "string", "x-go-name": "Type" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Attachment": { "description": "Attachment a generic attachment", "type": "object", "properties": { "browser_download_url": { "type": "string", "x-go-name": "DownloadURL" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "download_count": { "type": "integer", "format": "int64", "x-go-name": "DownloadCount" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "size": { "type": "integer", "format": "int64", "x-go-name": "Size" }, "uuid": { "type": "string", "x-go-name": "UUID" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Badge": { "description": "Badge represents a user badge", "type": "object", "properties": { "description": { "type": "string", "x-go-name": "Description" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "image_url": { "type": "string", "x-go-name": "ImageURL" }, "slug": { "type": "string", "x-go-name": "Slug" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Branch": { "description": "Branch represents a repository branch", "type": "object", "properties": { "commit": { "$ref": "#/definitions/PayloadCommit" }, "effective_branch_protection_name": { "type": "string", "x-go-name": "EffectiveBranchProtectionName" }, "enable_status_check": { "type": "boolean", "x-go-name": "EnableStatusCheck" }, "name": { "type": "string", "x-go-name": "Name" }, "protected": { "type": "boolean", "x-go-name": "Protected" }, "required_approvals": { "type": "integer", "format": "int64", "x-go-name": "RequiredApprovals" }, "status_check_contexts": { "type": "array", "items": { "type": "string" }, "x-go-name": "StatusCheckContexts" }, "user_can_merge": { "type": "boolean", "x-go-name": "UserCanMerge" }, "user_can_push": { "type": "boolean", "x-go-name": "UserCanPush" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "BranchProtection": { "description": "BranchProtection represents a branch protection for a repository", "type": "object", "properties": { "approvals_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "ApprovalsWhitelistTeams" }, "approvals_whitelist_username": { "type": "array", "items": { "type": "string" }, "x-go-name": "ApprovalsWhitelistUsernames" }, "block_admin_merge_override": { "type": "boolean", "x-go-name": "BlockAdminMergeOverride" }, "block_on_official_review_requests": { "type": "boolean", "x-go-name": "BlockOnOfficialReviewRequests" }, "block_on_outdated_branch": { "type": "boolean", "x-go-name": "BlockOnOutdatedBranch" }, "block_on_rejected_reviews": { "type": "boolean", "x-go-name": "BlockOnRejectedReviews" }, "branch_name": { "description": "Deprecated: true", "type": "string", "x-go-name": "BranchName" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "dismiss_stale_approvals": { "type": "boolean", "x-go-name": "DismissStaleApprovals" }, "enable_approvals_whitelist": { "type": "boolean", "x-go-name": "EnableApprovalsWhitelist" }, "enable_force_push": { "type": "boolean", "x-go-name": "EnableForcePush" }, "enable_force_push_allowlist": { "type": "boolean", "x-go-name": "EnableForcePushAllowlist" }, "enable_merge_whitelist": { "type": "boolean", "x-go-name": "EnableMergeWhitelist" }, "enable_push": { "type": "boolean", "x-go-name": "EnablePush" }, "enable_push_whitelist": { "type": "boolean", "x-go-name": "EnablePushWhitelist" }, "enable_status_check": { "type": "boolean", "x-go-name": "EnableStatusCheck" }, "force_push_allowlist_deploy_keys": { "type": "boolean", "x-go-name": "ForcePushAllowlistDeployKeys" }, "force_push_allowlist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "ForcePushAllowlistTeams" }, "force_push_allowlist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "ForcePushAllowlistUsernames" }, "ignore_stale_approvals": { "type": "boolean", "x-go-name": "IgnoreStaleApprovals" }, "merge_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "MergeWhitelistTeams" }, "merge_whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "MergeWhitelistUsernames" }, "priority": { "type": "integer", "format": "int64", "x-go-name": "Priority" }, "protected_file_patterns": { "type": "string", "x-go-name": "ProtectedFilePatterns" }, "push_whitelist_deploy_keys": { "type": "boolean", "x-go-name": "PushWhitelistDeployKeys" }, "push_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "PushWhitelistTeams" }, "push_whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "PushWhitelistUsernames" }, "require_signed_commits": { "type": "boolean", "x-go-name": "RequireSignedCommits" }, "required_approvals": { "type": "integer", "format": "int64", "x-go-name": "RequiredApprovals" }, "rule_name": { "type": "string", "x-go-name": "RuleName" }, "status_check_contexts": { "type": "array", "items": { "type": "string" }, "x-go-name": "StatusCheckContexts" }, "unprotected_file_patterns": { "type": "string", "x-go-name": "UnprotectedFilePatterns" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ChangeFileOperation": { "description": "ChangeFileOperation for creating, updating or deleting a file", "type": "object", "required": [ "operation", "path" ], "properties": { "content": { "description": "new or updated file content, must be base64 encoded", "type": "string", "x-go-name": "ContentBase64" }, "from_path": { "description": "old path of the file to move", "type": "string", "x-go-name": "FromPath" }, "operation": { "description": "indicates what to do with the file", "type": "string", "enum": [ "create", "update", "delete" ], "x-go-name": "Operation" }, "path": { "description": "path to the existing or new file", "type": "string", "x-go-name": "Path" }, "sha": { "description": "sha is the SHA for the file that already exists, required for update or delete", "type": "string", "x-go-name": "SHA" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ChangeFilesOptions": { "description": "ChangeFilesOptions options for creating, updating or deleting multiple files\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)", "type": "object", "required": [ "files" ], "properties": { "author": { "$ref": "#/definitions/Identity" }, "branch": { "description": "branch (optional) to base this file from. if not given, the default branch is used", "type": "string", "x-go-name": "BranchName" }, "committer": { "$ref": "#/definitions/Identity" }, "dates": { "$ref": "#/definitions/CommitDateOptions" }, "files": { "description": "list of file operations", "type": "array", "items": { "$ref": "#/definitions/ChangeFileOperation" }, "x-go-name": "Files" }, "message": { "description": "message (optional) for the commit of this file. if not supplied, a default message will be used", "type": "string", "x-go-name": "Message" }, "new_branch": { "description": "new_branch (optional) will make a new branch from `branch` before creating the file", "type": "string", "x-go-name": "NewBranchName" }, "signoff": { "description": "Add a Signed-off-by trailer by the committer at the end of the commit log message.", "type": "boolean", "x-go-name": "Signoff" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ChangedFile": { "description": "ChangedFile store information about files affected by the pull request", "type": "object", "properties": { "additions": { "type": "integer", "format": "int64", "x-go-name": "Additions" }, "changes": { "type": "integer", "format": "int64", "x-go-name": "Changes" }, "contents_url": { "type": "string", "x-go-name": "ContentsURL" }, "deletions": { "type": "integer", "format": "int64", "x-go-name": "Deletions" }, "filename": { "type": "string", "x-go-name": "Filename" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "previous_filename": { "type": "string", "x-go-name": "PreviousFilename" }, "raw_url": { "type": "string", "x-go-name": "RawURL" }, "status": { "type": "string", "x-go-name": "Status" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CombinedStatus": { "description": "CombinedStatus holds the combined state of several statuses for a single commit", "type": "object", "properties": { "commit_url": { "type": "string", "x-go-name": "CommitURL" }, "repository": { "$ref": "#/definitions/Repository" }, "sha": { "type": "string", "x-go-name": "SHA" }, "state": { "$ref": "#/definitions/CommitStatusState" }, "statuses": { "type": "array", "items": { "$ref": "#/definitions/CommitStatus" }, "x-go-name": "Statuses" }, "total_count": { "type": "integer", "format": "int64", "x-go-name": "TotalCount" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Comment": { "description": "Comment represents a comment on a commit or issue", "type": "object", "properties": { "assets": { "type": "array", "items": { "$ref": "#/definitions/Attachment" }, "x-go-name": "Attachments" }, "body": { "type": "string", "x-go-name": "Body" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "issue_url": { "type": "string", "x-go-name": "IssueURL" }, "original_author": { "type": "string", "x-go-name": "OriginalAuthor" }, "original_author_id": { "type": "integer", "format": "int64", "x-go-name": "OriginalAuthorID" }, "pull_request_url": { "type": "string", "x-go-name": "PRURL" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Commit": { "type": "object", "title": "Commit contains information generated from a Git commit.", "properties": { "author": { "$ref": "#/definitions/User" }, "commit": { "$ref": "#/definitions/RepoCommit" }, "committer": { "$ref": "#/definitions/User" }, "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "files": { "type": "array", "items": { "$ref": "#/definitions/CommitAffectedFiles" }, "x-go-name": "Files" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "parents": { "type": "array", "items": { "$ref": "#/definitions/CommitMeta" }, "x-go-name": "Parents" }, "sha": { "type": "string", "x-go-name": "SHA" }, "stats": { "$ref": "#/definitions/CommitStats" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitAffectedFiles": { "description": "CommitAffectedFiles store information about files affected by the commit", "type": "object", "properties": { "filename": { "type": "string", "x-go-name": "Filename" }, "status": { "type": "string", "x-go-name": "Status" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitDateOptions": { "description": "CommitDateOptions store dates for GIT_AUTHOR_DATE and GIT_COMMITTER_DATE", "type": "object", "properties": { "author": { "type": "string", "format": "date-time", "x-go-name": "Author" }, "committer": { "type": "string", "format": "date-time", "x-go-name": "Committer" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitMeta": { "type": "object", "title": "CommitMeta contains meta information of a commit in terms of API.", "properties": { "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "sha": { "type": "string", "x-go-name": "SHA" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitStats": { "description": "CommitStats is statistics for a RepoCommit", "type": "object", "properties": { "additions": { "type": "integer", "format": "int64", "x-go-name": "Additions" }, "deletions": { "type": "integer", "format": "int64", "x-go-name": "Deletions" }, "total": { "type": "integer", "format": "int64", "x-go-name": "Total" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitStatus": { "description": "CommitStatus holds a single status of a single Commit", "type": "object", "properties": { "context": { "type": "string", "x-go-name": "Context" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "creator": { "$ref": "#/definitions/User" }, "description": { "type": "string", "x-go-name": "Description" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "status": { "$ref": "#/definitions/CommitStatusState" }, "target_url": { "type": "string", "x-go-name": "TargetURL" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitStatusState": { "description": "CommitStatusState holds the state of a CommitStatus\nIt can be \"pending\", \"success\", \"error\" and \"failure\"", "type": "string", "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CommitUser": { "type": "object", "title": "CommitUser contains information of a user in the context of a commit.", "properties": { "date": { "type": "string", "x-go-name": "Date" }, "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Compare": { "type": "object", "title": "Compare represents a comparison between two commits.", "properties": { "commits": { "type": "array", "items": { "$ref": "#/definitions/Commit" }, "x-go-name": "Commits" }, "total_commits": { "type": "integer", "format": "int64", "x-go-name": "TotalCommits" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ContentsResponse": { "description": "ContentsResponse contains information about a repo's entry's (dir, file, symlink, submodule) metadata and content", "type": "object", "properties": { "_links": { "$ref": "#/definitions/FileLinksResponse" }, "content": { "description": "`content` is populated when `type` is `file`, otherwise null", "type": "string", "x-go-name": "Content" }, "download_url": { "type": "string", "x-go-name": "DownloadURL" }, "encoding": { "description": "`encoding` is populated when `type` is `file`, otherwise null", "type": "string", "x-go-name": "Encoding" }, "git_url": { "type": "string", "x-go-name": "GitURL" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "last_author_date": { "type": "string", "format": "date-time", "x-go-name": "LastAuthorDate" }, "last_commit_sha": { "type": "string", "x-go-name": "LastCommitSHA" }, "last_committer_date": { "type": "string", "format": "date-time", "x-go-name": "LastCommitterDate" }, "name": { "type": "string", "x-go-name": "Name" }, "path": { "type": "string", "x-go-name": "Path" }, "sha": { "type": "string", "x-go-name": "SHA" }, "size": { "type": "integer", "format": "int64", "x-go-name": "Size" }, "submodule_git_url": { "description": "`submodule_git_url` is populated when `type` is `submodule`, otherwise null", "type": "string", "x-go-name": "SubmoduleGitURL" }, "target": { "description": "`target` is populated when `type` is `symlink`, otherwise null", "type": "string", "x-go-name": "Target" }, "type": { "description": "`type` will be `file`, `dir`, `symlink`, or `submodule`", "type": "string", "x-go-name": "Type" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateAccessTokenOption": { "description": "CreateAccessTokenOption options when create access token", "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "x-go-name": "Name" }, "scopes": { "type": "array", "items": { "type": "string" }, "x-go-name": "Scopes", "example": [ "all", "read:activitypub", "read:issue", "write:misc", "read:notification", "read:organization", "read:package", "read:repository", "read:user" ] } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateActionWorkflowDispatch": { "description": "CreateActionWorkflowDispatch represents the payload for triggering a workflow dispatch event", "type": "object", "required": [ "ref" ], "properties": { "inputs": { "type": "object", "additionalProperties": { "type": "string" }, "x-go-name": "Inputs" }, "ref": { "type": "string", "x-go-name": "Ref", "example": "refs/heads/main" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateBranchProtectionOption": { "description": "CreateBranchProtectionOption options for creating a branch protection", "type": "object", "properties": { "approvals_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "ApprovalsWhitelistTeams" }, "approvals_whitelist_username": { "type": "array", "items": { "type": "string" }, "x-go-name": "ApprovalsWhitelistUsernames" }, "block_admin_merge_override": { "type": "boolean", "x-go-name": "BlockAdminMergeOverride" }, "block_on_official_review_requests": { "type": "boolean", "x-go-name": "BlockOnOfficialReviewRequests" }, "block_on_outdated_branch": { "type": "boolean", "x-go-name": "BlockOnOutdatedBranch" }, "block_on_rejected_reviews": { "type": "boolean", "x-go-name": "BlockOnRejectedReviews" }, "branch_name": { "description": "Deprecated: true", "type": "string", "x-go-name": "BranchName" }, "dismiss_stale_approvals": { "type": "boolean", "x-go-name": "DismissStaleApprovals" }, "enable_approvals_whitelist": { "type": "boolean", "x-go-name": "EnableApprovalsWhitelist" }, "enable_force_push": { "type": "boolean", "x-go-name": "EnableForcePush" }, "enable_force_push_allowlist": { "type": "boolean", "x-go-name": "EnableForcePushAllowlist" }, "enable_merge_whitelist": { "type": "boolean", "x-go-name": "EnableMergeWhitelist" }, "enable_push": { "type": "boolean", "x-go-name": "EnablePush" }, "enable_push_whitelist": { "type": "boolean", "x-go-name": "EnablePushWhitelist" }, "enable_status_check": { "type": "boolean", "x-go-name": "EnableStatusCheck" }, "force_push_allowlist_deploy_keys": { "type": "boolean", "x-go-name": "ForcePushAllowlistDeployKeys" }, "force_push_allowlist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "ForcePushAllowlistTeams" }, "force_push_allowlist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "ForcePushAllowlistUsernames" }, "ignore_stale_approvals": { "type": "boolean", "x-go-name": "IgnoreStaleApprovals" }, "merge_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "MergeWhitelistTeams" }, "merge_whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "MergeWhitelistUsernames" }, "priority": { "type": "integer", "format": "int64", "x-go-name": "Priority" }, "protected_file_patterns": { "type": "string", "x-go-name": "ProtectedFilePatterns" }, "push_whitelist_deploy_keys": { "type": "boolean", "x-go-name": "PushWhitelistDeployKeys" }, "push_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "PushWhitelistTeams" }, "push_whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "PushWhitelistUsernames" }, "require_signed_commits": { "type": "boolean", "x-go-name": "RequireSignedCommits" }, "required_approvals": { "type": "integer", "format": "int64", "x-go-name": "RequiredApprovals" }, "rule_name": { "type": "string", "x-go-name": "RuleName" }, "status_check_contexts": { "type": "array", "items": { "type": "string" }, "x-go-name": "StatusCheckContexts" }, "unprotected_file_patterns": { "type": "string", "x-go-name": "UnprotectedFilePatterns" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateBranchRepoOption": { "description": "CreateBranchRepoOption options when creating a branch in a repository", "type": "object", "required": [ "new_branch_name" ], "properties": { "new_branch_name": { "description": "Name of the branch to create", "type": "string", "uniqueItems": true, "x-go-name": "BranchName" }, "old_branch_name": { "description": "Deprecated: true\nName of the old branch to create from", "type": "string", "uniqueItems": true, "x-go-name": "OldBranchName" }, "old_ref_name": { "description": "Name of the old branch/tag/commit to create from", "type": "string", "uniqueItems": true, "x-go-name": "OldRefName" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateEmailOption": { "description": "CreateEmailOption options when creating email addresses", "type": "object", "properties": { "emails": { "description": "email addresses to add", "type": "array", "items": { "type": "string" }, "x-go-name": "Emails" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateFileOptions": { "description": "CreateFileOptions options for creating files\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)", "type": "object", "required": [ "content" ], "properties": { "author": { "$ref": "#/definitions/Identity" }, "branch": { "description": "branch (optional) to base this file from. if not given, the default branch is used", "type": "string", "x-go-name": "BranchName" }, "committer": { "$ref": "#/definitions/Identity" }, "content": { "description": "content must be base64 encoded", "type": "string", "x-go-name": "ContentBase64" }, "dates": { "$ref": "#/definitions/CommitDateOptions" }, "message": { "description": "message (optional) for the commit of this file. if not supplied, a default message will be used", "type": "string", "x-go-name": "Message" }, "new_branch": { "description": "new_branch (optional) will make a new branch from `branch` before creating the file", "type": "string", "x-go-name": "NewBranchName" }, "signoff": { "description": "Add a Signed-off-by trailer by the committer at the end of the commit log message.", "type": "boolean", "x-go-name": "Signoff" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateForkOption": { "description": "CreateForkOption options for creating a fork", "type": "object", "properties": { "name": { "description": "name of the forked repository", "type": "string", "x-go-name": "Name" }, "organization": { "description": "organization name, if forking into an organization", "type": "string", "x-go-name": "Organization" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateGPGKeyOption": { "description": "CreateGPGKeyOption options create user GPG key", "type": "object", "required": [ "armored_public_key" ], "properties": { "armored_public_key": { "description": "An armored GPG key to add", "type": "string", "uniqueItems": true, "x-go-name": "ArmoredKey" }, "armored_signature": { "type": "string", "x-go-name": "Signature" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateHookOption": { "description": "CreateHookOption options when create a hook", "type": "object", "required": [ "type", "config" ], "properties": { "active": { "type": "boolean", "default": false, "x-go-name": "Active" }, "authorization_header": { "type": "string", "x-go-name": "AuthorizationHeader" }, "branch_filter": { "type": "string", "x-go-name": "BranchFilter" }, "config": { "$ref": "#/definitions/CreateHookOptionConfig" }, "events": { "type": "array", "items": { "type": "string" }, "x-go-name": "Events" }, "type": { "type": "string", "enum": [ "dingtalk", "discord", "gitea", "gogs", "msteams", "slack", "telegram", "feishu", "wechatwork", "packagist" ], "x-go-name": "Type" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateHookOptionConfig": { "description": "CreateHookOptionConfig has all config options in it\nrequired are \"content_type\" and \"url\" Required", "type": "object", "additionalProperties": { "type": "string" }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateIssueCommentOption": { "description": "CreateIssueCommentOption options for creating a comment on an issue", "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string", "x-go-name": "Body" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateIssueOption": { "description": "CreateIssueOption options to create one issue", "type": "object", "required": [ "title" ], "properties": { "assignee": { "description": "deprecated", "type": "string", "x-go-name": "Assignee" }, "assignees": { "type": "array", "items": { "type": "string" }, "x-go-name": "Assignees" }, "body": { "type": "string", "x-go-name": "Body" }, "closed": { "type": "boolean", "x-go-name": "Closed" }, "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "labels": { "description": "list of label ids", "type": "array", "items": { "type": "integer", "format": "int64" }, "x-go-name": "Labels" }, "milestone": { "description": "milestone id", "type": "integer", "format": "int64", "x-go-name": "Milestone" }, "ref": { "type": "string", "x-go-name": "Ref" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateKeyOption": { "description": "CreateKeyOption options when creating a key", "type": "object", "required": [ "title", "key" ], "properties": { "key": { "description": "An armored SSH key to add", "type": "string", "uniqueItems": true, "x-go-name": "Key" }, "read_only": { "description": "Describe if the key has only read access or read/write", "type": "boolean", "x-go-name": "ReadOnly" }, "title": { "description": "Title of the key to add", "type": "string", "uniqueItems": true, "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateLabelOption": { "description": "CreateLabelOption options for creating a label", "type": "object", "required": [ "name", "color" ], "properties": { "color": { "type": "string", "x-go-name": "Color", "example": "#00aabb" }, "description": { "type": "string", "x-go-name": "Description" }, "exclusive": { "type": "boolean", "x-go-name": "Exclusive", "example": false }, "is_archived": { "type": "boolean", "x-go-name": "IsArchived", "example": false }, "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateMilestoneOption": { "description": "CreateMilestoneOption options for creating a milestone", "type": "object", "properties": { "description": { "type": "string", "x-go-name": "Description" }, "due_on": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "state": { "type": "string", "enum": [ "open", "closed" ], "x-go-name": "State" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateOAuth2ApplicationOptions": { "description": "CreateOAuth2ApplicationOptions holds options to create an oauth2 application", "type": "object", "properties": { "confidential_client": { "type": "boolean", "x-go-name": "ConfidentialClient" }, "name": { "type": "string", "x-go-name": "Name" }, "redirect_uris": { "type": "array", "items": { "type": "string" }, "x-go-name": "RedirectURIs" }, "skip_secondary_authorization": { "type": "boolean", "x-go-name": "SkipSecondaryAuthorization" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateOrUpdateSecretOption": { "description": "CreateOrUpdateSecretOption options when creating or updating secret", "type": "object", "required": [ "data" ], "properties": { "data": { "description": "Data of the secret to update", "type": "string", "x-go-name": "Data" }, "description": { "description": "Description of the secret to update", "type": "string", "x-go-name": "Description" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateOrgOption": { "description": "CreateOrgOption options for creating an organization", "type": "object", "required": [ "username" ], "properties": { "description": { "type": "string", "x-go-name": "Description" }, "email": { "type": "string", "x-go-name": "Email" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "location": { "type": "string", "x-go-name": "Location" }, "repo_admin_change_team_access": { "type": "boolean", "x-go-name": "RepoAdminChangeTeamAccess" }, "username": { "type": "string", "x-go-name": "UserName" }, "visibility": { "description": "possible values are `public` (default), `limited` or `private`", "type": "string", "enum": [ "public", "limited", "private" ], "x-go-name": "Visibility" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreatePullRequestOption": { "description": "CreatePullRequestOption options when creating a pull request", "type": "object", "properties": { "assignee": { "type": "string", "x-go-name": "Assignee" }, "assignees": { "type": "array", "items": { "type": "string" }, "x-go-name": "Assignees" }, "base": { "type": "string", "x-go-name": "Base" }, "body": { "type": "string", "x-go-name": "Body" }, "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "head": { "type": "string", "x-go-name": "Head" }, "labels": { "type": "array", "items": { "type": "integer", "format": "int64" }, "x-go-name": "Labels" }, "milestone": { "type": "integer", "format": "int64", "x-go-name": "Milestone" }, "reviewers": { "type": "array", "items": { "type": "string" }, "x-go-name": "Reviewers" }, "team_reviewers": { "type": "array", "items": { "type": "string" }, "x-go-name": "TeamReviewers" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreatePullReviewComment": { "description": "CreatePullReviewComment represent a review comment for creation api", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Body" }, "new_position": { "description": "if comment to new file line or 0", "type": "integer", "format": "int64", "x-go-name": "NewLineNum" }, "old_position": { "description": "if comment to old file line or 0", "type": "integer", "format": "int64", "x-go-name": "OldLineNum" }, "path": { "description": "the tree path", "type": "string", "x-go-name": "Path" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreatePullReviewOptions": { "description": "CreatePullReviewOptions are options to create a pull review", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Body" }, "comments": { "type": "array", "items": { "$ref": "#/definitions/CreatePullReviewComment" }, "x-go-name": "Comments" }, "commit_id": { "type": "string", "x-go-name": "CommitID" }, "event": { "$ref": "#/definitions/ReviewStateType" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreatePushMirrorOption": { "type": "object", "title": "CreatePushMirrorOption represents need information to create a push mirror of a repository.", "properties": { "interval": { "type": "string", "x-go-name": "Interval" }, "remote_address": { "type": "string", "x-go-name": "RemoteAddress" }, "remote_password": { "type": "string", "x-go-name": "RemotePassword" }, "remote_username": { "type": "string", "x-go-name": "RemoteUsername" }, "sync_on_commit": { "type": "boolean", "x-go-name": "SyncOnCommit" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateReleaseOption": { "description": "CreateReleaseOption options when creating a release", "type": "object", "required": [ "tag_name" ], "properties": { "body": { "type": "string", "x-go-name": "Note" }, "draft": { "type": "boolean", "x-go-name": "IsDraft" }, "name": { "type": "string", "x-go-name": "Title" }, "prerelease": { "type": "boolean", "x-go-name": "IsPrerelease" }, "tag_name": { "type": "string", "x-go-name": "TagName" }, "target_commitish": { "type": "string", "x-go-name": "Target" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateRepoOption": { "description": "CreateRepoOption options when creating repository", "type": "object", "required": [ "name" ], "properties": { "auto_init": { "description": "Whether the repository should be auto-initialized?", "type": "boolean", "x-go-name": "AutoInit" }, "default_branch": { "description": "DefaultBranch of the repository (used when initializes and in template)", "type": "string", "x-go-name": "DefaultBranch" }, "description": { "description": "Description of the repository to create", "type": "string", "x-go-name": "Description" }, "gitignores": { "description": "Gitignores to use", "type": "string", "x-go-name": "Gitignores" }, "issue_labels": { "description": "Label-Set to use", "type": "string", "x-go-name": "IssueLabels" }, "license": { "description": "License to use", "type": "string", "x-go-name": "License" }, "name": { "description": "Name of the repository to create", "type": "string", "uniqueItems": true, "x-go-name": "Name" }, "object_format_name": { "description": "ObjectFormatName of the underlying git repository", "type": "string", "enum": [ "sha1", "sha256" ], "x-go-name": "ObjectFormatName" }, "private": { "description": "Whether the repository is private", "type": "boolean", "x-go-name": "Private" }, "readme": { "description": "Readme of the repository to create", "type": "string", "x-go-name": "Readme" }, "template": { "description": "Whether the repository is template", "type": "boolean", "x-go-name": "Template" }, "trust_model": { "description": "TrustModel of the repository", "type": "string", "enum": [ "default", "collaborator", "committer", "collaboratorcommitter" ], "x-go-name": "TrustModel" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateStatusOption": { "description": "CreateStatusOption holds the information needed to create a new CommitStatus for a Commit", "type": "object", "properties": { "context": { "type": "string", "x-go-name": "Context" }, "description": { "type": "string", "x-go-name": "Description" }, "state": { "$ref": "#/definitions/CommitStatusState" }, "target_url": { "type": "string", "x-go-name": "TargetURL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateTagOption": { "description": "CreateTagOption options when creating a tag", "type": "object", "required": [ "tag_name" ], "properties": { "message": { "type": "string", "x-go-name": "Message" }, "tag_name": { "type": "string", "x-go-name": "TagName" }, "target": { "type": "string", "x-go-name": "Target" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateTagProtectionOption": { "description": "CreateTagProtectionOption options for creating a tag protection", "type": "object", "properties": { "name_pattern": { "type": "string", "x-go-name": "NamePattern" }, "whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "WhitelistTeams" }, "whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "WhitelistUsernames" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateTeamOption": { "description": "CreateTeamOption options for creating a team", "type": "object", "required": [ "name" ], "properties": { "can_create_org_repo": { "type": "boolean", "x-go-name": "CanCreateOrgRepo" }, "description": { "type": "string", "x-go-name": "Description" }, "includes_all_repositories": { "type": "boolean", "x-go-name": "IncludesAllRepositories" }, "name": { "type": "string", "x-go-name": "Name" }, "permission": { "type": "string", "enum": [ "read", "write", "admin" ], "x-go-name": "Permission" }, "units": { "type": "array", "items": { "type": "string" }, "x-go-name": "Units", "example": [ "repo.actions", "repo.code", "repo.issues", "repo.ext_issues", "repo.wiki", "repo.ext_wiki", "repo.pulls", "repo.releases", "repo.projects", "repo.ext_wiki" ] }, "units_map": { "type": "object", "additionalProperties": { "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\"}" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateUserOption": { "description": "CreateUserOption create user options", "type": "object", "required": [ "username", "email" ], "properties": { "created_at": { "description": "For explicitly setting the user creation timestamp. Useful when users are\nmigrated from other systems. When omitted, the user's creation timestamp\nwill be set to \"now\".", "type": "string", "format": "date-time", "x-go-name": "Created" }, "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "login_name": { "type": "string", "x-go-name": "LoginName" }, "must_change_password": { "type": "boolean", "x-go-name": "MustChangePassword" }, "password": { "type": "string", "x-go-name": "Password" }, "restricted": { "type": "boolean", "x-go-name": "Restricted" }, "send_notify": { "type": "boolean", "x-go-name": "SendNotify" }, "source_id": { "type": "integer", "format": "int64", "x-go-name": "SourceID" }, "username": { "type": "string", "x-go-name": "Username" }, "visibility": { "type": "string", "x-go-name": "Visibility" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateVariableOption": { "description": "CreateVariableOption the option when creating variable", "type": "object", "required": [ "value" ], "properties": { "description": { "description": "Description of the variable to create", "type": "string", "x-go-name": "Description" }, "value": { "description": "Value of the variable to create", "type": "string", "x-go-name": "Value" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "CreateWikiPageOptions": { "description": "CreateWikiPageOptions form for creating wiki", "type": "object", "properties": { "content_base64": { "description": "content must be base64 encoded", "type": "string", "x-go-name": "ContentBase64" }, "message": { "description": "optional commit message summarizing the change", "type": "string", "x-go-name": "Message" }, "title": { "description": "page title. leave empty to keep unchanged", "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Cron": { "description": "Cron represents a Cron task", "type": "object", "properties": { "exec_times": { "type": "integer", "format": "int64", "x-go-name": "ExecTimes" }, "name": { "type": "string", "x-go-name": "Name" }, "next": { "type": "string", "format": "date-time", "x-go-name": "Next" }, "prev": { "type": "string", "format": "date-time", "x-go-name": "Prev" }, "schedule": { "type": "string", "x-go-name": "Schedule" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "DeleteEmailOption": { "description": "DeleteEmailOption options when deleting email addresses", "type": "object", "properties": { "emails": { "description": "email addresses to delete", "type": "array", "items": { "type": "string" }, "x-go-name": "Emails" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "DeleteFileOptions": { "description": "DeleteFileOptions options for deleting files (used for other File structs below)\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)", "type": "object", "required": [ "sha" ], "properties": { "author": { "$ref": "#/definitions/Identity" }, "branch": { "description": "branch (optional) to base this file from. if not given, the default branch is used", "type": "string", "x-go-name": "BranchName" }, "committer": { "$ref": "#/definitions/Identity" }, "dates": { "$ref": "#/definitions/CommitDateOptions" }, "message": { "description": "message (optional) for the commit of this file. if not supplied, a default message will be used", "type": "string", "x-go-name": "Message" }, "new_branch": { "description": "new_branch (optional) will make a new branch from `branch` before creating the file", "type": "string", "x-go-name": "NewBranchName" }, "sha": { "description": "sha is the SHA for the file that already exists", "type": "string", "x-go-name": "SHA" }, "signoff": { "description": "Add a Signed-off-by trailer by the committer at the end of the commit log message.", "type": "boolean", "x-go-name": "Signoff" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "DeployKey": { "description": "DeployKey a deploy key", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "fingerprint": { "type": "string", "x-go-name": "Fingerprint" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "key": { "type": "string", "x-go-name": "Key" }, "key_id": { "type": "integer", "format": "int64", "x-go-name": "KeyID" }, "read_only": { "type": "boolean", "x-go-name": "ReadOnly" }, "repository": { "$ref": "#/definitions/Repository" }, "title": { "type": "string", "x-go-name": "Title" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "DismissPullReviewOptions": { "description": "DismissPullReviewOptions are options to dismiss a pull review", "type": "object", "properties": { "message": { "type": "string", "x-go-name": "Message" }, "priors": { "type": "boolean", "x-go-name": "Priors" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditAttachmentOptions": { "description": "EditAttachmentOptions options for editing attachments", "type": "object", "properties": { "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditBranchProtectionOption": { "description": "EditBranchProtectionOption options for editing a branch protection", "type": "object", "properties": { "approvals_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "ApprovalsWhitelistTeams" }, "approvals_whitelist_username": { "type": "array", "items": { "type": "string" }, "x-go-name": "ApprovalsWhitelistUsernames" }, "block_admin_merge_override": { "type": "boolean", "x-go-name": "BlockAdminMergeOverride" }, "block_on_official_review_requests": { "type": "boolean", "x-go-name": "BlockOnOfficialReviewRequests" }, "block_on_outdated_branch": { "type": "boolean", "x-go-name": "BlockOnOutdatedBranch" }, "block_on_rejected_reviews": { "type": "boolean", "x-go-name": "BlockOnRejectedReviews" }, "dismiss_stale_approvals": { "type": "boolean", "x-go-name": "DismissStaleApprovals" }, "enable_approvals_whitelist": { "type": "boolean", "x-go-name": "EnableApprovalsWhitelist" }, "enable_force_push": { "type": "boolean", "x-go-name": "EnableForcePush" }, "enable_force_push_allowlist": { "type": "boolean", "x-go-name": "EnableForcePushAllowlist" }, "enable_merge_whitelist": { "type": "boolean", "x-go-name": "EnableMergeWhitelist" }, "enable_push": { "type": "boolean", "x-go-name": "EnablePush" }, "enable_push_whitelist": { "type": "boolean", "x-go-name": "EnablePushWhitelist" }, "enable_status_check": { "type": "boolean", "x-go-name": "EnableStatusCheck" }, "force_push_allowlist_deploy_keys": { "type": "boolean", "x-go-name": "ForcePushAllowlistDeployKeys" }, "force_push_allowlist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "ForcePushAllowlistTeams" }, "force_push_allowlist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "ForcePushAllowlistUsernames" }, "ignore_stale_approvals": { "type": "boolean", "x-go-name": "IgnoreStaleApprovals" }, "merge_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "MergeWhitelistTeams" }, "merge_whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "MergeWhitelistUsernames" }, "priority": { "type": "integer", "format": "int64", "x-go-name": "Priority" }, "protected_file_patterns": { "type": "string", "x-go-name": "ProtectedFilePatterns" }, "push_whitelist_deploy_keys": { "type": "boolean", "x-go-name": "PushWhitelistDeployKeys" }, "push_whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "PushWhitelistTeams" }, "push_whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "PushWhitelistUsernames" }, "require_signed_commits": { "type": "boolean", "x-go-name": "RequireSignedCommits" }, "required_approvals": { "type": "integer", "format": "int64", "x-go-name": "RequiredApprovals" }, "status_check_contexts": { "type": "array", "items": { "type": "string" }, "x-go-name": "StatusCheckContexts" }, "unprotected_file_patterns": { "type": "string", "x-go-name": "UnprotectedFilePatterns" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditDeadlineOption": { "description": "EditDeadlineOption options for creating a deadline", "type": "object", "required": [ "due_date" ], "properties": { "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditGitHookOption": { "description": "EditGitHookOption options when modifying one Git hook", "type": "object", "properties": { "content": { "type": "string", "x-go-name": "Content" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditHookOption": { "description": "EditHookOption options when modify one hook", "type": "object", "properties": { "active": { "type": "boolean", "x-go-name": "Active" }, "authorization_header": { "type": "string", "x-go-name": "AuthorizationHeader" }, "branch_filter": { "type": "string", "x-go-name": "BranchFilter" }, "config": { "type": "object", "additionalProperties": { "type": "string" }, "x-go-name": "Config" }, "events": { "type": "array", "items": { "type": "string" }, "x-go-name": "Events" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditIssueCommentOption": { "description": "EditIssueCommentOption options for editing a comment", "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string", "x-go-name": "Body" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditIssueOption": { "description": "EditIssueOption options for editing an issue", "type": "object", "properties": { "assignee": { "description": "deprecated", "type": "string", "x-go-name": "Assignee" }, "assignees": { "type": "array", "items": { "type": "string" }, "x-go-name": "Assignees" }, "body": { "type": "string", "x-go-name": "Body" }, "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "milestone": { "type": "integer", "format": "int64", "x-go-name": "Milestone" }, "ref": { "type": "string", "x-go-name": "Ref" }, "state": { "type": "string", "x-go-name": "State" }, "title": { "type": "string", "x-go-name": "Title" }, "unset_due_date": { "type": "boolean", "x-go-name": "RemoveDeadline" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditLabelOption": { "description": "EditLabelOption options for editing a label", "type": "object", "properties": { "color": { "type": "string", "x-go-name": "Color", "example": "#00aabb" }, "description": { "type": "string", "x-go-name": "Description" }, "exclusive": { "type": "boolean", "x-go-name": "Exclusive", "example": false }, "is_archived": { "type": "boolean", "x-go-name": "IsArchived", "example": false }, "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditMilestoneOption": { "description": "EditMilestoneOption options for editing a milestone", "type": "object", "properties": { "description": { "type": "string", "x-go-name": "Description" }, "due_on": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "state": { "type": "string", "x-go-name": "State" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditOrgOption": { "description": "EditOrgOption options for editing an organization", "type": "object", "properties": { "description": { "type": "string", "x-go-name": "Description" }, "email": { "type": "string", "x-go-name": "Email" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "location": { "type": "string", "x-go-name": "Location" }, "repo_admin_change_team_access": { "type": "boolean", "x-go-name": "RepoAdminChangeTeamAccess" }, "visibility": { "description": "possible values are `public`, `limited` or `private`", "type": "string", "enum": [ "public", "limited", "private" ], "x-go-name": "Visibility" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditPullRequestOption": { "description": "EditPullRequestOption options when modify pull request", "type": "object", "properties": { "allow_maintainer_edit": { "type": "boolean", "x-go-name": "AllowMaintainerEdit" }, "assignee": { "type": "string", "x-go-name": "Assignee" }, "assignees": { "type": "array", "items": { "type": "string" }, "x-go-name": "Assignees" }, "base": { "type": "string", "x-go-name": "Base" }, "body": { "type": "string", "x-go-name": "Body" }, "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "labels": { "type": "array", "items": { "type": "integer", "format": "int64" }, "x-go-name": "Labels" }, "milestone": { "type": "integer", "format": "int64", "x-go-name": "Milestone" }, "state": { "type": "string", "x-go-name": "State" }, "title": { "type": "string", "x-go-name": "Title" }, "unset_due_date": { "type": "boolean", "x-go-name": "RemoveDeadline" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditReactionOption": { "description": "EditReactionOption contain the reaction type", "type": "object", "properties": { "content": { "type": "string", "x-go-name": "Reaction" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditReleaseOption": { "description": "EditReleaseOption options when editing a release", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Note" }, "draft": { "type": "boolean", "x-go-name": "IsDraft" }, "name": { "type": "string", "x-go-name": "Title" }, "prerelease": { "type": "boolean", "x-go-name": "IsPrerelease" }, "tag_name": { "type": "string", "x-go-name": "TagName" }, "target_commitish": { "type": "string", "x-go-name": "Target" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditRepoOption": { "description": "EditRepoOption options when editing a repository's properties", "type": "object", "properties": { "allow_fast_forward_only_merge": { "description": "either `true` to allow fast-forward-only merging pull requests, or `false` to prevent fast-forward-only merging.", "type": "boolean", "x-go-name": "AllowFastForwardOnly" }, "allow_manual_merge": { "description": "either `true` to allow mark pr as merged manually, or `false` to prevent it.", "type": "boolean", "x-go-name": "AllowManualMerge" }, "allow_merge_commits": { "description": "either `true` to allow merging pull requests with a merge commit, or `false` to prevent merging pull requests with merge commits.", "type": "boolean", "x-go-name": "AllowMerge" }, "allow_rebase": { "description": "either `true` to allow rebase-merging pull requests, or `false` to prevent rebase-merging.", "type": "boolean", "x-go-name": "AllowRebase" }, "allow_rebase_explicit": { "description": "either `true` to allow rebase with explicit merge commits (--no-ff), or `false` to prevent rebase with explicit merge commits.", "type": "boolean", "x-go-name": "AllowRebaseMerge" }, "allow_rebase_update": { "description": "either `true` to allow updating pull request branch by rebase, or `false` to prevent it.", "type": "boolean", "x-go-name": "AllowRebaseUpdate" }, "allow_squash_merge": { "description": "either `true` to allow squash-merging pull requests, or `false` to prevent squash-merging.", "type": "boolean", "x-go-name": "AllowSquash" }, "archived": { "description": "set to `true` to archive this repository.", "type": "boolean", "x-go-name": "Archived" }, "autodetect_manual_merge": { "description": "either `true` to enable AutodetectManualMerge, or `false` to prevent it. Note: In some special cases, misjudgments can occur.", "type": "boolean", "x-go-name": "AutodetectManualMerge" }, "default_allow_maintainer_edit": { "description": "set to `true` to allow edits from maintainers by default", "type": "boolean", "x-go-name": "DefaultAllowMaintainerEdit" }, "default_branch": { "description": "sets the default branch for this repository.", "type": "string", "x-go-name": "DefaultBranch" }, "default_delete_branch_after_merge": { "description": "set to `true` to delete pr branch after merge by default", "type": "boolean", "x-go-name": "DefaultDeleteBranchAfterMerge" }, "default_merge_style": { "description": "set to a merge style to be used by this repository: \"merge\", \"rebase\", \"rebase-merge\", \"squash\", or \"fast-forward-only\".", "type": "string", "x-go-name": "DefaultMergeStyle" }, "description": { "description": "a short description of the repository.", "type": "string", "x-go-name": "Description" }, "enable_prune": { "description": "enable prune - remove obsolete remote-tracking references when mirroring", "type": "boolean", "x-go-name": "EnablePrune" }, "external_tracker": { "$ref": "#/definitions/ExternalTracker" }, "external_wiki": { "$ref": "#/definitions/ExternalWiki" }, "has_actions": { "description": "either `true` to enable actions unit, or `false` to disable them.", "type": "boolean", "x-go-name": "HasActions" }, "has_issues": { "description": "either `true` to enable issues for this repository or `false` to disable them.", "type": "boolean", "x-go-name": "HasIssues" }, "has_packages": { "description": "either `true` to enable packages unit, or `false` to disable them.", "type": "boolean", "x-go-name": "HasPackages" }, "has_projects": { "description": "either `true` to enable project unit, or `false` to disable them.", "type": "boolean", "x-go-name": "HasProjects" }, "has_pull_requests": { "description": "either `true` to allow pull requests, or `false` to prevent pull request.", "type": "boolean", "x-go-name": "HasPullRequests" }, "has_releases": { "description": "either `true` to enable releases unit, or `false` to disable them.", "type": "boolean", "x-go-name": "HasReleases" }, "has_wiki": { "description": "either `true` to enable the wiki for this repository or `false` to disable it.", "type": "boolean", "x-go-name": "HasWiki" }, "ignore_whitespace_conflicts": { "description": "either `true` to ignore whitespace for conflicts, or `false` to not ignore whitespace.", "type": "boolean", "x-go-name": "IgnoreWhitespaceConflicts" }, "internal_tracker": { "$ref": "#/definitions/InternalTracker" }, "mirror_interval": { "description": "set to a string like `8h30m0s` to set the mirror interval time", "type": "string", "x-go-name": "MirrorInterval" }, "name": { "description": "name of the repository", "type": "string", "uniqueItems": true, "x-go-name": "Name" }, "private": { "description": "either `true` to make the repository private or `false` to make it public.\nNote: you will get a 422 error if the organization restricts changing repository visibility to organization\nowners and a non-owner tries to change the value of private.", "type": "boolean", "x-go-name": "Private" }, "projects_mode": { "description": "`repo` to only allow repo-level projects, `owner` to only allow owner projects, `all` to allow both.", "type": "string", "x-go-name": "ProjectsMode" }, "template": { "description": "either `true` to make this repository a template or `false` to make it a normal repository", "type": "boolean", "x-go-name": "Template" }, "website": { "description": "a URL with more information about the repository.", "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditTagProtectionOption": { "description": "EditTagProtectionOption options for editing a tag protection", "type": "object", "properties": { "name_pattern": { "type": "string", "x-go-name": "NamePattern" }, "whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "WhitelistTeams" }, "whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "WhitelistUsernames" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditTeamOption": { "description": "EditTeamOption options for editing a team", "type": "object", "required": [ "name" ], "properties": { "can_create_org_repo": { "type": "boolean", "x-go-name": "CanCreateOrgRepo" }, "description": { "type": "string", "x-go-name": "Description" }, "includes_all_repositories": { "type": "boolean", "x-go-name": "IncludesAllRepositories" }, "name": { "type": "string", "x-go-name": "Name" }, "permission": { "type": "string", "enum": [ "read", "write", "admin" ], "x-go-name": "Permission" }, "units": { "type": "array", "items": { "type": "string" }, "x-go-name": "Units", "example": [ "repo.code", "repo.issues", "repo.ext_issues", "repo.wiki", "repo.pulls", "repo.releases", "repo.projects", "repo.ext_wiki" ] }, "units_map": { "type": "object", "additionalProperties": { "type": "string" }, "x-go-name": "UnitsMap", "example": { "repo.code": "read", "repo.ext_issues": "none", "repo.ext_wiki": "none", "repo.issues": "write", "repo.projects": "none", "repo.pulls": "owner", "repo.releases": "none", "repo.wiki": "admin" } } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "EditUserOption": { "description": "EditUserOption edit user options", "type": "object", "required": [ "source_id", "login_name" ], "properties": { "active": { "type": "boolean", "x-go-name": "Active" }, "admin": { "type": "boolean", "x-go-name": "Admin" }, "allow_create_organization": { "type": "boolean", "x-go-name": "AllowCreateOrganization" }, "allow_git_hook": { "type": "boolean", "x-go-name": "AllowGitHook" }, "allow_import_local": { "type": "boolean", "x-go-name": "AllowImportLocal" }, "description": { "type": "string", "x-go-name": "Description" }, "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "location": { "type": "string", "x-go-name": "Location" }, "login_name": { "type": "string", "x-go-name": "LoginName" }, "max_repo_creation": { "type": "integer", "format": "int64", "x-go-name": "MaxRepoCreation" }, "must_change_password": { "type": "boolean", "x-go-name": "MustChangePassword" }, "password": { "type": "string", "x-go-name": "Password" }, "prohibit_login": { "type": "boolean", "x-go-name": "ProhibitLogin" }, "restricted": { "type": "boolean", "x-go-name": "Restricted" }, "source_id": { "type": "integer", "format": "int64", "x-go-name": "SourceID" }, "visibility": { "type": "string", "x-go-name": "Visibility" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Email": { "description": "Email an email address belonging to a user", "type": "object", "properties": { "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "primary": { "type": "boolean", "x-go-name": "Primary" }, "user_id": { "type": "integer", "format": "int64", "x-go-name": "UserID" }, "username": { "type": "string", "x-go-name": "UserName" }, "verified": { "type": "boolean", "x-go-name": "Verified" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ExternalTracker": { "description": "ExternalTracker represents settings for external tracker", "type": "object", "properties": { "external_tracker_format": { "description": "External Issue Tracker URL Format. Use the placeholders {user}, {repo} and {index} for the username, repository name and issue index.", "type": "string", "x-go-name": "ExternalTrackerFormat" }, "external_tracker_regexp_pattern": { "description": "External Issue Tracker issue regular expression", "type": "string", "x-go-name": "ExternalTrackerRegexpPattern" }, "external_tracker_style": { "description": "External Issue Tracker Number Format, either `numeric`, `alphanumeric`, or `regexp`", "type": "string", "x-go-name": "ExternalTrackerStyle" }, "external_tracker_url": { "description": "URL of external issue tracker.", "type": "string", "x-go-name": "ExternalTrackerURL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ExternalWiki": { "description": "ExternalWiki represents setting for external wiki", "type": "object", "properties": { "external_wiki_url": { "description": "URL of external wiki.", "type": "string", "x-go-name": "ExternalWikiURL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "FileCommitResponse": { "type": "object", "title": "FileCommitResponse contains information generated from a Git commit for a repo's file.", "properties": { "author": { "$ref": "#/definitions/CommitUser" }, "committer": { "$ref": "#/definitions/CommitUser" }, "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "message": { "type": "string", "x-go-name": "Message" }, "parents": { "type": "array", "items": { "$ref": "#/definitions/CommitMeta" }, "x-go-name": "Parents" }, "sha": { "type": "string", "x-go-name": "SHA" }, "tree": { "$ref": "#/definitions/CommitMeta" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "FileDeleteResponse": { "description": "FileDeleteResponse contains information about a repo's file that was deleted", "type": "object", "properties": { "commit": { "$ref": "#/definitions/FileCommitResponse" }, "content": { "x-go-name": "Content" }, "verification": { "$ref": "#/definitions/PayloadCommitVerification" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "FileLinksResponse": { "description": "FileLinksResponse contains the links for a repo's file", "type": "object", "properties": { "git": { "type": "string", "x-go-name": "GitURL" }, "html": { "type": "string", "x-go-name": "HTMLURL" }, "self": { "type": "string", "x-go-name": "Self" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "FileResponse": { "description": "FileResponse contains information about a repo's file", "type": "object", "properties": { "commit": { "$ref": "#/definitions/FileCommitResponse" }, "content": { "$ref": "#/definitions/ContentsResponse" }, "verification": { "$ref": "#/definitions/PayloadCommitVerification" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "FilesResponse": { "description": "FilesResponse contains information about multiple files from a repo", "type": "object", "properties": { "commit": { "$ref": "#/definitions/FileCommitResponse" }, "files": { "type": "array", "items": { "$ref": "#/definitions/ContentsResponse" }, "x-go-name": "Files" }, "verification": { "$ref": "#/definitions/PayloadCommitVerification" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GPGKey": { "description": "GPGKey a user GPG key to sign commit and tag in repository", "type": "object", "properties": { "can_certify": { "type": "boolean", "x-go-name": "CanCertify" }, "can_encrypt_comms": { "type": "boolean", "x-go-name": "CanEncryptComms" }, "can_encrypt_storage": { "type": "boolean", "x-go-name": "CanEncryptStorage" }, "can_sign": { "type": "boolean", "x-go-name": "CanSign" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "emails": { "type": "array", "items": { "$ref": "#/definitions/GPGKeyEmail" }, "x-go-name": "Emails" }, "expires_at": { "type": "string", "format": "date-time", "x-go-name": "Expires" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "key_id": { "type": "string", "x-go-name": "KeyID" }, "primary_key_id": { "type": "string", "x-go-name": "PrimaryKeyID" }, "public_key": { "type": "string", "x-go-name": "PublicKey" }, "subkeys": { "type": "array", "items": { "$ref": "#/definitions/GPGKey" }, "x-go-name": "SubsKey" }, "verified": { "type": "boolean", "x-go-name": "Verified" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GPGKeyEmail": { "description": "GPGKeyEmail an email attached to a GPGKey", "type": "object", "properties": { "email": { "type": "string", "x-go-name": "Email" }, "verified": { "type": "boolean", "x-go-name": "Verified" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GeneralAPISettings": { "description": "GeneralAPISettings contains global api settings exposed by it", "type": "object", "properties": { "default_git_trees_per_page": { "type": "integer", "format": "int64", "x-go-name": "DefaultGitTreesPerPage" }, "default_max_blob_size": { "type": "integer", "format": "int64", "x-go-name": "DefaultMaxBlobSize" }, "default_max_response_size": { "type": "integer", "format": "int64", "x-go-name": "DefaultMaxResponseSize" }, "default_paging_num": { "type": "integer", "format": "int64", "x-go-name": "DefaultPagingNum" }, "max_response_items": { "type": "integer", "format": "int64", "x-go-name": "MaxResponseItems" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GeneralAttachmentSettings": { "description": "GeneralAttachmentSettings contains global Attachment settings exposed by API", "type": "object", "properties": { "allowed_types": { "type": "string", "x-go-name": "AllowedTypes" }, "enabled": { "type": "boolean", "x-go-name": "Enabled" }, "max_files": { "type": "integer", "format": "int64", "x-go-name": "MaxFiles" }, "max_size": { "type": "integer", "format": "int64", "x-go-name": "MaxSize" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GeneralRepoSettings": { "description": "GeneralRepoSettings contains global repository settings exposed by API", "type": "object", "properties": { "http_git_disabled": { "type": "boolean", "x-go-name": "HTTPGitDisabled" }, "lfs_disabled": { "type": "boolean", "x-go-name": "LFSDisabled" }, "migrations_disabled": { "type": "boolean", "x-go-name": "MigrationsDisabled" }, "mirrors_disabled": { "type": "boolean", "x-go-name": "MirrorsDisabled" }, "stars_disabled": { "type": "boolean", "x-go-name": "StarsDisabled" }, "time_tracking_disabled": { "type": "boolean", "x-go-name": "TimeTrackingDisabled" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GeneralUISettings": { "description": "GeneralUISettings contains global ui settings exposed by API", "type": "object", "properties": { "allowed_reactions": { "type": "array", "items": { "type": "string" }, "x-go-name": "AllowedReactions" }, "custom_emojis": { "type": "array", "items": { "type": "string" }, "x-go-name": "CustomEmojis" }, "default_theme": { "type": "string", "x-go-name": "DefaultTheme" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GenerateRepoOption": { "description": "GenerateRepoOption options when creating repository using a template", "type": "object", "required": [ "owner", "name" ], "properties": { "avatar": { "description": "include avatar of the template repo", "type": "boolean", "x-go-name": "Avatar" }, "default_branch": { "description": "Default branch of the new repository", "type": "string", "x-go-name": "DefaultBranch" }, "description": { "description": "Description of the repository to create", "type": "string", "x-go-name": "Description" }, "git_content": { "description": "include git content of default branch in template repo", "type": "boolean", "x-go-name": "GitContent" }, "git_hooks": { "description": "include git hooks in template repo", "type": "boolean", "x-go-name": "GitHooks" }, "labels": { "description": "include labels in template repo", "type": "boolean", "x-go-name": "Labels" }, "name": { "description": "Name of the repository to create", "type": "string", "uniqueItems": true, "x-go-name": "Name" }, "owner": { "description": "The organization or person who will own the new repository", "type": "string", "x-go-name": "Owner" }, "private": { "description": "Whether the repository is private", "type": "boolean", "x-go-name": "Private" }, "protected_branch": { "description": "include protected branches in template repo", "type": "boolean", "x-go-name": "ProtectedBranch" }, "topics": { "description": "include topics in template repo", "type": "boolean", "x-go-name": "Topics" }, "webhooks": { "description": "include webhooks in template repo", "type": "boolean", "x-go-name": "Webhooks" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GetFilesOptions": { "description": "GetFilesOptions options for retrieving metadate and content of multiple files", "type": "object", "properties": { "files": { "type": "array", "items": { "type": "string" }, "x-go-name": "Files" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GitBlobResponse": { "description": "GitBlobResponse represents a git blob", "type": "object", "properties": { "content": { "type": "string", "x-go-name": "Content" }, "encoding": { "type": "string", "x-go-name": "Encoding" }, "sha": { "type": "string", "x-go-name": "SHA" }, "size": { "type": "integer", "format": "int64", "x-go-name": "Size" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GitEntry": { "description": "GitEntry represents a git tree", "type": "object", "properties": { "mode": { "type": "string", "x-go-name": "Mode" }, "path": { "type": "string", "x-go-name": "Path" }, "sha": { "type": "string", "x-go-name": "SHA" }, "size": { "type": "integer", "format": "int64", "x-go-name": "Size" }, "type": { "type": "string", "x-go-name": "Type" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GitHook": { "description": "GitHook represents a Git repository hook", "type": "object", "properties": { "content": { "type": "string", "x-go-name": "Content" }, "is_active": { "type": "boolean", "x-go-name": "IsActive" }, "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GitObject": { "type": "object", "title": "GitObject represents a Git object.", "properties": { "sha": { "type": "string", "x-go-name": "SHA" }, "type": { "type": "string", "x-go-name": "Type" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GitTreeResponse": { "description": "GitTreeResponse returns a git tree", "type": "object", "properties": { "page": { "type": "integer", "format": "int64", "x-go-name": "Page" }, "sha": { "type": "string", "x-go-name": "SHA" }, "total_count": { "type": "integer", "format": "int64", "x-go-name": "TotalCount" }, "tree": { "type": "array", "items": { "$ref": "#/definitions/GitEntry" }, "x-go-name": "Entries" }, "truncated": { "type": "boolean", "x-go-name": "Truncated" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "GitignoreTemplateInfo": { "description": "GitignoreTemplateInfo name and text of a gitignore template", "type": "object", "properties": { "name": { "type": "string", "x-go-name": "Name" }, "source": { "type": "string", "x-go-name": "Source" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Hook": { "description": "Hook a hook is a web hook when one repository changed", "type": "object", "properties": { "active": { "type": "boolean", "x-go-name": "Active" }, "authorization_header": { "type": "string", "x-go-name": "AuthorizationHeader" }, "branch_filter": { "type": "string", "x-go-name": "BranchFilter" }, "config": { "type": "object", "additionalProperties": { "type": "string" }, "x-go-name": "Config" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "events": { "type": "array", "items": { "type": "string" }, "x-go-name": "Events" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "type": { "type": "string", "x-go-name": "Type" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Identity": { "description": "Identity for a person's identity like an author or committer", "type": "object", "properties": { "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "InternalTracker": { "description": "InternalTracker represents settings for internal tracker", "type": "object", "properties": { "allow_only_contributors_to_track_time": { "description": "Let only contributors track time (Built-in issue tracker)", "type": "boolean", "x-go-name": "AllowOnlyContributorsToTrackTime" }, "enable_issue_dependencies": { "description": "Enable dependencies for issues and pull requests (Built-in issue tracker)", "type": "boolean", "x-go-name": "EnableIssueDependencies" }, "enable_time_tracker": { "description": "Enable time tracking (Built-in issue tracker)", "type": "boolean", "x-go-name": "EnableTimeTracker" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Issue": { "description": "Issue represents an issue in a repository", "type": "object", "properties": { "assets": { "type": "array", "items": { "$ref": "#/definitions/Attachment" }, "x-go-name": "Attachments" }, "assignee": { "$ref": "#/definitions/User" }, "assignees": { "type": "array", "items": { "$ref": "#/definitions/User" }, "x-go-name": "Assignees" }, "body": { "type": "string", "x-go-name": "Body" }, "closed_at": { "type": "string", "format": "date-time", "x-go-name": "Closed" }, "comments": { "type": "integer", "format": "int64", "x-go-name": "Comments" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "is_locked": { "type": "boolean", "x-go-name": "IsLocked" }, "labels": { "type": "array", "items": { "$ref": "#/definitions/Label" }, "x-go-name": "Labels" }, "milestone": { "$ref": "#/definitions/Milestone" }, "number": { "type": "integer", "format": "int64", "x-go-name": "Index" }, "original_author": { "type": "string", "x-go-name": "OriginalAuthor" }, "original_author_id": { "type": "integer", "format": "int64", "x-go-name": "OriginalAuthorID" }, "pin_order": { "type": "integer", "format": "int64", "x-go-name": "PinOrder" }, "pull_request": { "$ref": "#/definitions/PullRequestMeta" }, "ref": { "type": "string", "x-go-name": "Ref" }, "repository": { "$ref": "#/definitions/RepositoryMeta" }, "state": { "$ref": "#/definitions/StateType" }, "title": { "type": "string", "x-go-name": "Title" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "url": { "type": "string", "x-go-name": "URL" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueConfig": { "type": "object", "properties": { "blank_issues_enabled": { "type": "boolean", "x-go-name": "BlankIssuesEnabled" }, "contact_links": { "type": "array", "items": { "$ref": "#/definitions/IssueConfigContactLink" }, "x-go-name": "ContactLinks" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueConfigContactLink": { "type": "object", "properties": { "about": { "type": "string", "x-go-name": "About" }, "name": { "type": "string", "x-go-name": "Name" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueConfigValidation": { "type": "object", "properties": { "message": { "type": "string", "x-go-name": "Message" }, "valid": { "type": "boolean", "x-go-name": "Valid" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueDeadline": { "description": "IssueDeadline represents an issue deadline", "type": "object", "properties": { "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueFormField": { "description": "IssueFormField represents a form field", "type": "object", "properties": { "attributes": { "type": "object", "additionalProperties": {}, "x-go-name": "Attributes" }, "id": { "type": "string", "x-go-name": "ID" }, "type": { "$ref": "#/definitions/IssueFormFieldType" }, "validations": { "type": "object", "additionalProperties": {}, "x-go-name": "Validations" }, "visible": { "type": "array", "items": { "$ref": "#/definitions/IssueFormFieldVisible" }, "x-go-name": "Visible" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueFormFieldType": { "type": "string", "title": "IssueFormFieldType defines issue form field type, can be \"markdown\", \"textarea\", \"input\", \"dropdown\" or \"checkboxes\"", "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueFormFieldVisible": { "description": "IssueFormFieldVisible defines issue form field visible", "type": "string", "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueLabelsOption": { "description": "IssueLabelsOption a collection of labels", "type": "object", "properties": { "labels": { "description": "Labels can be a list of integers representing label IDs\nor a list of strings representing label names", "type": "array", "items": {}, "x-go-name": "Labels" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueMeta": { "description": "IssueMeta basic issue information", "type": "object", "properties": { "index": { "type": "integer", "format": "int64", "x-go-name": "Index" }, "owner": { "type": "string", "x-go-name": "Owner" }, "repo": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueTemplate": { "description": "IssueTemplate represents an issue template for a repository", "type": "object", "properties": { "about": { "type": "string", "x-go-name": "About" }, "assignees": { "$ref": "#/definitions/IssueTemplateStringSlice" }, "body": { "type": "array", "items": { "$ref": "#/definitions/IssueFormField" }, "x-go-name": "Fields" }, "content": { "type": "string", "x-go-name": "Content" }, "file_name": { "type": "string", "x-go-name": "FileName" }, "labels": { "$ref": "#/definitions/IssueTemplateStringSlice" }, "name": { "type": "string", "x-go-name": "Name" }, "ref": { "type": "string", "x-go-name": "Ref" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "IssueTemplateStringSlice": { "type": "array", "items": { "type": "string" }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Label": { "description": "Label a label to an issue or a pr", "type": "object", "properties": { "color": { "type": "string", "x-go-name": "Color", "example": "00aabb" }, "description": { "type": "string", "x-go-name": "Description" }, "exclusive": { "type": "boolean", "x-go-name": "Exclusive", "example": false }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "is_archived": { "type": "boolean", "x-go-name": "IsArchived", "example": false }, "name": { "type": "string", "x-go-name": "Name" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "LabelTemplate": { "description": "LabelTemplate info of a Label template", "type": "object", "properties": { "color": { "type": "string", "x-go-name": "Color", "example": "00aabb" }, "description": { "type": "string", "x-go-name": "Description" }, "exclusive": { "type": "boolean", "x-go-name": "Exclusive", "example": false }, "name": { "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "LicenseTemplateInfo": { "description": "LicensesInfo contains information about a License", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Body" }, "implementation": { "type": "string", "x-go-name": "Implementation" }, "key": { "type": "string", "x-go-name": "Key" }, "name": { "type": "string", "x-go-name": "Name" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "LicensesTemplateListEntry": { "description": "LicensesListEntry is used for the API", "type": "object", "properties": { "key": { "type": "string", "x-go-name": "Key" }, "name": { "type": "string", "x-go-name": "Name" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "LockIssueOption": { "description": "LockIssueOption options to lock an issue", "type": "object", "properties": { "lock_reason": { "type": "string", "x-go-name": "Reason" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "MarkdownOption": { "description": "MarkdownOption markdown options", "type": "object", "properties": { "Context": { "description": "URL path for rendering issue, media and file links\nExpected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}\n\nin: body", "type": "string" }, "Mode": { "description": "Mode to render (markdown, comment, wiki, file)\n\nin: body", "type": "string" }, "Text": { "description": "Text markdown to render\n\nin: body", "type": "string" }, "Wiki": { "description": "Is it a wiki page? (use mode=wiki instead)\n\nDeprecated: true\nin: body", "type": "boolean" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "MarkupOption": { "description": "MarkupOption markup options", "type": "object", "properties": { "Context": { "description": "URL path for rendering issue, media and file links\nExpected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}\n\nin: body", "type": "string" }, "FilePath": { "description": "File path for detecting extension in file mode\n\nin: body", "type": "string" }, "Mode": { "description": "Mode to render (markdown, comment, wiki, file)\n\nin: body", "type": "string" }, "Text": { "description": "Text markup to render\n\nin: body", "type": "string" }, "Wiki": { "description": "Is it a wiki page? (use mode=wiki instead)\n\nDeprecated: true\nin: body", "type": "boolean" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "MergePullRequestOption": { "description": "MergePullRequestForm form for merging Pull Request", "type": "object", "required": [ "Do" ], "properties": { "Do": { "type": "string", "enum": [ "merge", "rebase", "rebase-merge", "squash", "fast-forward-only", "manually-merged" ] }, "MergeCommitID": { "type": "string" }, "MergeMessageField": { "type": "string" }, "MergeTitleField": { "type": "string" }, "delete_branch_after_merge": { "type": "boolean", "x-go-name": "DeleteBranchAfterMerge" }, "force_merge": { "type": "boolean", "x-go-name": "ForceMerge" }, "head_commit_id": { "type": "string", "x-go-name": "HeadCommitID" }, "merge_when_checks_succeed": { "type": "boolean", "x-go-name": "MergeWhenChecksSucceed" } }, "x-go-name": "MergePullRequestForm", "x-go-package": "code.gitea.io/gitea/services/forms" }, "MergeUpstreamRequest": { "type": "object", "properties": { "branch": { "type": "string", "x-go-name": "Branch" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "MergeUpstreamResponse": { "type": "object", "properties": { "merge_type": { "type": "string", "x-go-name": "MergeStyle" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "MigrateRepoOptions": { "description": "MigrateRepoOptions options for migrating repository's\nthis is used to interact with api v1", "type": "object", "required": [ "clone_addr", "repo_name" ], "properties": { "auth_password": { "type": "string", "x-go-name": "AuthPassword" }, "auth_token": { "type": "string", "x-go-name": "AuthToken" }, "auth_username": { "type": "string", "x-go-name": "AuthUsername" }, "aws_access_key_id": { "type": "string", "x-go-name": "AWSAccessKeyID" }, "aws_secret_access_key": { "type": "string", "x-go-name": "AWSSecretAccessKey" }, "clone_addr": { "type": "string", "x-go-name": "CloneAddr" }, "description": { "type": "string", "x-go-name": "Description" }, "issues": { "type": "boolean", "x-go-name": "Issues" }, "labels": { "type": "boolean", "x-go-name": "Labels" }, "lfs": { "type": "boolean", "x-go-name": "LFS" }, "lfs_endpoint": { "type": "string", "x-go-name": "LFSEndpoint" }, "milestones": { "type": "boolean", "x-go-name": "Milestones" }, "mirror": { "type": "boolean", "x-go-name": "Mirror" }, "mirror_interval": { "type": "string", "x-go-name": "MirrorInterval" }, "private": { "type": "boolean", "x-go-name": "Private" }, "pull_requests": { "type": "boolean", "x-go-name": "PullRequests" }, "releases": { "type": "boolean", "x-go-name": "Releases" }, "repo_name": { "type": "string", "x-go-name": "RepoName" }, "repo_owner": { "description": "Name of User or Organisation who will own Repo after migration", "type": "string", "x-go-name": "RepoOwner" }, "service": { "type": "string", "enum": [ "git", "github", "gitea", "gitlab", "gogs", "onedev", "gitbucket", "codebase", "codecommit" ], "x-go-name": "Service" }, "uid": { "description": "deprecated (only for backwards compatibility)", "type": "integer", "format": "int64", "x-go-name": "RepoOwnerID" }, "wiki": { "type": "boolean", "x-go-name": "Wiki" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Milestone": { "description": "Milestone milestone is a collection of issues on one repository", "type": "object", "properties": { "closed_at": { "type": "string", "format": "date-time", "x-go-name": "Closed" }, "closed_issues": { "type": "integer", "format": "int64", "x-go-name": "ClosedIssues" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "description": { "type": "string", "x-go-name": "Description" }, "due_on": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "open_issues": { "type": "integer", "format": "int64", "x-go-name": "OpenIssues" }, "state": { "$ref": "#/definitions/StateType" }, "title": { "type": "string", "x-go-name": "Title" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NewIssuePinsAllowed": { "description": "NewIssuePinsAllowed represents an API response that says if new Issue Pins are allowed", "type": "object", "properties": { "issues": { "type": "boolean", "x-go-name": "Issues" }, "pull_requests": { "type": "boolean", "x-go-name": "PullRequests" } }, "x-go-package": "code.gitea.io/gitea/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": { "type": "object", "x-go-name": "Metadata" }, "openRegistrations": { "type": "boolean", "x-go-name": "OpenRegistrations" }, "protocols": { "type": "array", "items": { "type": "string" }, "x-go-name": "Protocols" }, "services": { "$ref": "#/definitions/NodeInfoServices" }, "software": { "$ref": "#/definitions/NodeInfoSoftware" }, "usage": { "$ref": "#/definitions/NodeInfoUsage" }, "version": { "type": "string", "x-go-name": "Version" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NodeInfoServices": { "description": "NodeInfoServices contains the third party sites this server can connect to via their application API", "type": "object", "properties": { "inbound": { "type": "array", "items": { "type": "string" }, "x-go-name": "Inbound" }, "outbound": { "type": "array", "items": { "type": "string" }, "x-go-name": "Outbound" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NodeInfoSoftware": { "description": "NodeInfoSoftware contains Metadata about server software in use", "type": "object", "properties": { "homepage": { "type": "string", "x-go-name": "Homepage" }, "name": { "type": "string", "x-go-name": "Name" }, "repository": { "type": "string", "x-go-name": "Repository" }, "version": { "type": "string", "x-go-name": "Version" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NodeInfoUsage": { "description": "NodeInfoUsage contains usage statistics for this server", "type": "object", "properties": { "localComments": { "type": "integer", "format": "int64", "x-go-name": "LocalComments" }, "localPosts": { "type": "integer", "format": "int64", "x-go-name": "LocalPosts" }, "users": { "$ref": "#/definitions/NodeInfoUsageUsers" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NodeInfoUsageUsers": { "description": "NodeInfoUsageUsers contains statistics about the users of this server", "type": "object", "properties": { "activeHalfyear": { "type": "integer", "format": "int64", "x-go-name": "ActiveHalfyear" }, "activeMonth": { "type": "integer", "format": "int64", "x-go-name": "ActiveMonth" }, "total": { "type": "integer", "format": "int64", "x-go-name": "Total" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Note": { "description": "Note contains information related to a git note", "type": "object", "properties": { "commit": { "$ref": "#/definitions/Commit" }, "message": { "type": "string", "x-go-name": "Message" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NotificationCount": { "description": "NotificationCount number of unread notifications", "type": "object", "properties": { "new": { "type": "integer", "format": "int64", "x-go-name": "New" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NotificationSubject": { "description": "NotificationSubject contains the notification subject (Issue/Pull/Commit)", "type": "object", "properties": { "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "latest_comment_html_url": { "type": "string", "x-go-name": "LatestCommentHTMLURL" }, "latest_comment_url": { "type": "string", "x-go-name": "LatestCommentURL" }, "state": { "$ref": "#/definitions/StateType" }, "title": { "type": "string", "x-go-name": "Title" }, "type": { "$ref": "#/definitions/NotifySubjectType" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NotificationThread": { "description": "NotificationThread expose Notification on API", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "pinned": { "type": "boolean", "x-go-name": "Pinned" }, "repository": { "$ref": "#/definitions/Repository" }, "subject": { "$ref": "#/definitions/NotificationSubject" }, "unread": { "type": "boolean", "x-go-name": "Unread" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "UpdatedAt" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "NotifySubjectType": { "description": "NotifySubjectType represent type of notification subject", "type": "string", "x-go-package": "code.gitea.io/gitea/modules/structs" }, "OAuth2Application": { "type": "object", "title": "OAuth2Application represents an OAuth2 application.", "properties": { "client_id": { "type": "string", "x-go-name": "ClientID" }, "client_secret": { "type": "string", "x-go-name": "ClientSecret" }, "confidential_client": { "type": "boolean", "x-go-name": "ConfidentialClient" }, "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "redirect_uris": { "type": "array", "items": { "type": "string" }, "x-go-name": "RedirectURIs" }, "skip_secondary_authorization": { "type": "boolean", "x-go-name": "SkipSecondaryAuthorization" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Organization": { "description": "Organization represents an organization", "type": "object", "properties": { "avatar_url": { "type": "string", "x-go-name": "AvatarURL" }, "description": { "type": "string", "x-go-name": "Description" }, "email": { "type": "string", "x-go-name": "Email" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "location": { "type": "string", "x-go-name": "Location" }, "name": { "type": "string", "x-go-name": "Name" }, "repo_admin_change_team_access": { "type": "boolean", "x-go-name": "RepoAdminChangeTeamAccess" }, "username": { "description": "deprecated", "type": "string", "x-go-name": "UserName" }, "visibility": { "type": "string", "x-go-name": "Visibility" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "OrganizationPermissions": { "description": "OrganizationPermissions list different users permissions on an organization", "type": "object", "properties": { "can_create_repository": { "type": "boolean", "x-go-name": "CanCreateRepository" }, "can_read": { "type": "boolean", "x-go-name": "CanRead" }, "can_write": { "type": "boolean", "x-go-name": "CanWrite" }, "is_admin": { "type": "boolean", "x-go-name": "IsAdmin" }, "is_owner": { "type": "boolean", "x-go-name": "IsOwner" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PRBranchInfo": { "description": "PRBranchInfo information about a branch", "type": "object", "properties": { "label": { "type": "string", "x-go-name": "Name" }, "ref": { "type": "string", "x-go-name": "Ref" }, "repo": { "$ref": "#/definitions/Repository" }, "repo_id": { "type": "integer", "format": "int64", "x-go-name": "RepoID" }, "sha": { "type": "string", "x-go-name": "Sha" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Package": { "description": "Package represents a package", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "CreatedAt" }, "creator": { "$ref": "#/definitions/User" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "owner": { "$ref": "#/definitions/User" }, "repository": { "$ref": "#/definitions/Repository" }, "type": { "type": "string", "x-go-name": "Type" }, "version": { "type": "string", "x-go-name": "Version" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PackageFile": { "description": "PackageFile represents a package file", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "md5": { "type": "string", "x-go-name": "HashMD5" }, "name": { "type": "string", "x-go-name": "Name" }, "sha1": { "type": "string", "x-go-name": "HashSHA1" }, "sha256": { "type": "string", "x-go-name": "HashSHA256" }, "sha512": { "type": "string", "x-go-name": "HashSHA512" }, "size": { "type": "integer", "format": "int64", "x-go-name": "Size" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PayloadCommit": { "description": "PayloadCommit represents a commit", "type": "object", "properties": { "added": { "type": "array", "items": { "type": "string" }, "x-go-name": "Added" }, "author": { "$ref": "#/definitions/PayloadUser" }, "committer": { "$ref": "#/definitions/PayloadUser" }, "id": { "description": "sha1 hash of the commit", "type": "string", "x-go-name": "ID" }, "message": { "type": "string", "x-go-name": "Message" }, "modified": { "type": "array", "items": { "type": "string" }, "x-go-name": "Modified" }, "removed": { "type": "array", "items": { "type": "string" }, "x-go-name": "Removed" }, "timestamp": { "type": "string", "format": "date-time", "x-go-name": "Timestamp" }, "url": { "type": "string", "x-go-name": "URL" }, "verification": { "$ref": "#/definitions/PayloadCommitVerification" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PayloadCommitVerification": { "description": "PayloadCommitVerification represents the GPG verification of a commit", "type": "object", "properties": { "payload": { "type": "string", "x-go-name": "Payload" }, "reason": { "type": "string", "x-go-name": "Reason" }, "signature": { "type": "string", "x-go-name": "Signature" }, "signer": { "$ref": "#/definitions/PayloadUser" }, "verified": { "type": "boolean", "x-go-name": "Verified" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PayloadUser": { "description": "PayloadUser represents the author or committer of a commit", "type": "object", "properties": { "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "name": { "description": "Full name of the commit author", "type": "string", "x-go-name": "Name" }, "username": { "type": "string", "x-go-name": "UserName" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Permission": { "description": "Permission represents a set of permissions", "type": "object", "properties": { "admin": { "type": "boolean", "x-go-name": "Admin" }, "pull": { "type": "boolean", "x-go-name": "Pull" }, "push": { "type": "boolean", "x-go-name": "Push" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PublicKey": { "description": "PublicKey publickey is a user key to push code to repository", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "fingerprint": { "type": "string", "x-go-name": "Fingerprint" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "key": { "type": "string", "x-go-name": "Key" }, "key_type": { "type": "string", "x-go-name": "KeyType" }, "last_used_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "read_only": { "type": "boolean", "x-go-name": "ReadOnly" }, "title": { "type": "string", "x-go-name": "Title" }, "url": { "type": "string", "x-go-name": "URL" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PullRequest": { "description": "PullRequest represents a pull request", "type": "object", "properties": { "additions": { "type": "integer", "format": "int64", "x-go-name": "Additions" }, "allow_maintainer_edit": { "type": "boolean", "x-go-name": "AllowMaintainerEdit" }, "assignee": { "$ref": "#/definitions/User" }, "assignees": { "type": "array", "items": { "$ref": "#/definitions/User" }, "x-go-name": "Assignees" }, "base": { "$ref": "#/definitions/PRBranchInfo" }, "body": { "type": "string", "x-go-name": "Body" }, "changed_files": { "type": "integer", "format": "int64", "x-go-name": "ChangedFiles" }, "closed_at": { "type": "string", "format": "date-time", "x-go-name": "Closed" }, "comments": { "type": "integer", "format": "int64", "x-go-name": "Comments" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "deletions": { "type": "integer", "format": "int64", "x-go-name": "Deletions" }, "diff_url": { "type": "string", "x-go-name": "DiffURL" }, "draft": { "type": "boolean", "x-go-name": "Draft" }, "due_date": { "type": "string", "format": "date-time", "x-go-name": "Deadline" }, "head": { "$ref": "#/definitions/PRBranchInfo" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "is_locked": { "type": "boolean", "x-go-name": "IsLocked" }, "labels": { "type": "array", "items": { "$ref": "#/definitions/Label" }, "x-go-name": "Labels" }, "merge_base": { "type": "string", "x-go-name": "MergeBase" }, "merge_commit_sha": { "type": "string", "x-go-name": "MergedCommitID" }, "mergeable": { "type": "boolean", "x-go-name": "Mergeable" }, "merged": { "type": "boolean", "x-go-name": "HasMerged" }, "merged_at": { "type": "string", "format": "date-time", "x-go-name": "Merged" }, "merged_by": { "$ref": "#/definitions/User" }, "milestone": { "$ref": "#/definitions/Milestone" }, "number": { "type": "integer", "format": "int64", "x-go-name": "Index" }, "patch_url": { "type": "string", "x-go-name": "PatchURL" }, "pin_order": { "type": "integer", "format": "int64", "x-go-name": "PinOrder" }, "requested_reviewers": { "type": "array", "items": { "$ref": "#/definitions/User" }, "x-go-name": "RequestedReviewers" }, "requested_reviewers_teams": { "type": "array", "items": { "$ref": "#/definitions/Team" }, "x-go-name": "RequestedReviewersTeams" }, "review_comments": { "description": "number of review comments made on the diff of a PR review (not including comments on commits or issues in a PR)", "type": "integer", "format": "int64", "x-go-name": "ReviewComments" }, "state": { "$ref": "#/definitions/StateType" }, "title": { "type": "string", "x-go-name": "Title" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "url": { "type": "string", "x-go-name": "URL" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PullRequestMeta": { "description": "PullRequestMeta PR info if an issue is a PR", "type": "object", "properties": { "draft": { "type": "boolean", "x-go-name": "IsWorkInProgress" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "merged": { "type": "boolean", "x-go-name": "HasMerged" }, "merged_at": { "type": "string", "format": "date-time", "x-go-name": "Merged" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PullReview": { "description": "PullReview represents a pull request review", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Body" }, "comments_count": { "type": "integer", "format": "int64", "x-go-name": "CodeCommentsCount" }, "commit_id": { "type": "string", "x-go-name": "CommitID" }, "dismissed": { "type": "boolean", "x-go-name": "Dismissed" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "official": { "type": "boolean", "x-go-name": "Official" }, "pull_request_url": { "type": "string", "x-go-name": "HTMLPullURL" }, "stale": { "type": "boolean", "x-go-name": "Stale" }, "state": { "$ref": "#/definitions/ReviewStateType" }, "submitted_at": { "type": "string", "format": "date-time", "x-go-name": "Submitted" }, "team": { "$ref": "#/definitions/Team" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PullReviewComment": { "description": "PullReviewComment represents a comment on a pull request review", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Body" }, "commit_id": { "type": "string", "x-go-name": "CommitID" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "diff_hunk": { "type": "string", "x-go-name": "DiffHunk" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "original_commit_id": { "type": "string", "x-go-name": "OrigCommitID" }, "original_position": { "type": "integer", "format": "uint64", "x-go-name": "OldLineNum" }, "path": { "type": "string", "x-go-name": "Path" }, "position": { "type": "integer", "format": "uint64", "x-go-name": "LineNum" }, "pull_request_review_id": { "type": "integer", "format": "int64", "x-go-name": "ReviewID" }, "pull_request_url": { "type": "string", "x-go-name": "HTMLPullURL" }, "resolver": { "$ref": "#/definitions/User" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PullReviewRequestOptions": { "description": "PullReviewRequestOptions are options to add or remove pull review requests", "type": "object", "properties": { "reviewers": { "type": "array", "items": { "type": "string" }, "x-go-name": "Reviewers" }, "team_reviewers": { "type": "array", "items": { "type": "string" }, "x-go-name": "TeamReviewers" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "PushMirror": { "description": "PushMirror represents information of a push mirror", "type": "object", "properties": { "created": { "type": "string", "format": "date-time", "x-go-name": "CreatedUnix" }, "interval": { "type": "string", "x-go-name": "Interval" }, "last_error": { "type": "string", "x-go-name": "LastError" }, "last_update": { "type": "string", "format": "date-time", "x-go-name": "LastUpdateUnix" }, "remote_address": { "type": "string", "x-go-name": "RemoteAddress" }, "remote_name": { "type": "string", "x-go-name": "RemoteName" }, "repo_name": { "type": "string", "x-go-name": "RepoName" }, "sync_on_commit": { "type": "boolean", "x-go-name": "SyncOnCommit" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Reaction": { "description": "Reaction contain one reaction", "type": "object", "properties": { "content": { "type": "string", "x-go-name": "Reaction" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Reference": { "type": "object", "title": "Reference represents a Git reference.", "properties": { "object": { "$ref": "#/definitions/GitObject" }, "ref": { "type": "string", "x-go-name": "Ref" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Release": { "description": "Release represents a repository release", "type": "object", "properties": { "assets": { "type": "array", "items": { "$ref": "#/definitions/Attachment" }, "x-go-name": "Attachments" }, "author": { "$ref": "#/definitions/User" }, "body": { "type": "string", "x-go-name": "Note" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "CreatedAt" }, "draft": { "type": "boolean", "x-go-name": "IsDraft" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Title" }, "prerelease": { "type": "boolean", "x-go-name": "IsPrerelease" }, "published_at": { "type": "string", "format": "date-time", "x-go-name": "PublishedAt" }, "tag_name": { "type": "string", "x-go-name": "TagName" }, "tarball_url": { "type": "string", "x-go-name": "TarURL" }, "target_commitish": { "type": "string", "x-go-name": "Target" }, "upload_url": { "type": "string", "x-go-name": "UploadURL" }, "url": { "type": "string", "x-go-name": "URL" }, "zipball_url": { "type": "string", "x-go-name": "ZipURL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RenameOrgOption": { "description": "RenameOrgOption options when renaming an organization", "type": "object", "required": [ "new_name" ], "properties": { "new_name": { "description": "New username for this org. This name cannot be in use yet by any other user.", "type": "string", "uniqueItems": true, "x-go-name": "NewName" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RenameUserOption": { "description": "RenameUserOption options when renaming a user", "type": "object", "required": [ "new_username" ], "properties": { "new_username": { "description": "New username for this user. This name cannot be in use yet by any other user.", "type": "string", "uniqueItems": true, "x-go-name": "NewName" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RepoCollaboratorPermission": { "description": "RepoCollaboratorPermission to get repository permission for a collaborator", "type": "object", "properties": { "permission": { "type": "string", "x-go-name": "Permission" }, "role_name": { "type": "string", "x-go-name": "RoleName" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RepoCommit": { "type": "object", "title": "RepoCommit contains information of a commit in the context of a repository.", "properties": { "author": { "$ref": "#/definitions/CommitUser" }, "committer": { "$ref": "#/definitions/CommitUser" }, "message": { "type": "string", "x-go-name": "Message" }, "tree": { "$ref": "#/definitions/CommitMeta" }, "url": { "type": "string", "x-go-name": "URL" }, "verification": { "$ref": "#/definitions/PayloadCommitVerification" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RepoTopicOptions": { "description": "RepoTopicOptions a collection of repo topic names", "type": "object", "properties": { "topics": { "description": "list of topic names", "type": "array", "items": { "type": "string" }, "x-go-name": "Topics" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RepoTransfer": { "description": "RepoTransfer represents a pending repo transfer", "type": "object", "properties": { "doer": { "$ref": "#/definitions/User" }, "recipient": { "$ref": "#/definitions/User" }, "teams": { "type": "array", "items": { "$ref": "#/definitions/Team" }, "x-go-name": "Teams" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Repository": { "description": "Repository represents a repository", "type": "object", "properties": { "allow_fast_forward_only_merge": { "type": "boolean", "x-go-name": "AllowFastForwardOnly" }, "allow_merge_commits": { "type": "boolean", "x-go-name": "AllowMerge" }, "allow_rebase": { "type": "boolean", "x-go-name": "AllowRebase" }, "allow_rebase_explicit": { "type": "boolean", "x-go-name": "AllowRebaseMerge" }, "allow_rebase_update": { "type": "boolean", "x-go-name": "AllowRebaseUpdate" }, "allow_squash_merge": { "type": "boolean", "x-go-name": "AllowSquash" }, "archived": { "type": "boolean", "x-go-name": "Archived" }, "archived_at": { "type": "string", "format": "date-time", "x-go-name": "ArchivedAt" }, "avatar_url": { "type": "string", "x-go-name": "AvatarURL" }, "clone_url": { "type": "string", "x-go-name": "CloneURL" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "default_allow_maintainer_edit": { "type": "boolean", "x-go-name": "DefaultAllowMaintainerEdit" }, "default_branch": { "type": "string", "x-go-name": "DefaultBranch" }, "default_delete_branch_after_merge": { "type": "boolean", "x-go-name": "DefaultDeleteBranchAfterMerge" }, "default_merge_style": { "type": "string", "x-go-name": "DefaultMergeStyle" }, "description": { "type": "string", "x-go-name": "Description" }, "empty": { "type": "boolean", "x-go-name": "Empty" }, "external_tracker": { "$ref": "#/definitions/ExternalTracker" }, "external_wiki": { "$ref": "#/definitions/ExternalWiki" }, "fork": { "type": "boolean", "x-go-name": "Fork" }, "forks_count": { "type": "integer", "format": "int64", "x-go-name": "Forks" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "has_actions": { "type": "boolean", "x-go-name": "HasActions" }, "has_issues": { "type": "boolean", "x-go-name": "HasIssues" }, "has_packages": { "type": "boolean", "x-go-name": "HasPackages" }, "has_projects": { "type": "boolean", "x-go-name": "HasProjects" }, "has_pull_requests": { "type": "boolean", "x-go-name": "HasPullRequests" }, "has_releases": { "type": "boolean", "x-go-name": "HasReleases" }, "has_wiki": { "type": "boolean", "x-go-name": "HasWiki" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "ignore_whitespace_conflicts": { "type": "boolean", "x-go-name": "IgnoreWhitespaceConflicts" }, "internal": { "type": "boolean", "x-go-name": "Internal" }, "internal_tracker": { "$ref": "#/definitions/InternalTracker" }, "language": { "type": "string", "x-go-name": "Language" }, "languages_url": { "type": "string", "x-go-name": "LanguagesURL" }, "licenses": { "type": "array", "items": { "type": "string" }, "x-go-name": "Licenses" }, "link": { "type": "string", "x-go-name": "Link" }, "mirror": { "type": "boolean", "x-go-name": "Mirror" }, "mirror_interval": { "type": "string", "x-go-name": "MirrorInterval" }, "mirror_updated": { "type": "string", "format": "date-time", "x-go-name": "MirrorUpdated" }, "name": { "type": "string", "x-go-name": "Name" }, "object_format_name": { "description": "ObjectFormatName of the underlying git repository", "type": "string", "enum": [ "sha1", "sha256" ], "x-go-name": "ObjectFormatName" }, "open_issues_count": { "type": "integer", "format": "int64", "x-go-name": "OpenIssues" }, "open_pr_counter": { "type": "integer", "format": "int64", "x-go-name": "OpenPulls" }, "original_url": { "type": "string", "x-go-name": "OriginalURL" }, "owner": { "$ref": "#/definitions/User" }, "parent": { "$ref": "#/definitions/Repository" }, "permissions": { "$ref": "#/definitions/Permission" }, "private": { "type": "boolean", "x-go-name": "Private" }, "projects_mode": { "type": "string", "x-go-name": "ProjectsMode" }, "release_counter": { "type": "integer", "format": "int64", "x-go-name": "Releases" }, "repo_transfer": { "$ref": "#/definitions/RepoTransfer" }, "size": { "type": "integer", "format": "int64", "x-go-name": "Size" }, "ssh_url": { "type": "string", "x-go-name": "SSHURL" }, "stars_count": { "type": "integer", "format": "int64", "x-go-name": "Stars" }, "template": { "type": "boolean", "x-go-name": "Template" }, "topics": { "type": "array", "items": { "type": "string" }, "x-go-name": "Topics" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "url": { "type": "string", "x-go-name": "URL" }, "watchers_count": { "type": "integer", "format": "int64", "x-go-name": "Watchers" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "RepositoryMeta": { "description": "RepositoryMeta basic repository information", "type": "object", "properties": { "full_name": { "type": "string", "x-go-name": "FullName" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name": { "type": "string", "x-go-name": "Name" }, "owner": { "type": "string", "x-go-name": "Owner" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ReviewStateType": { "description": "ReviewStateType review state type", "type": "string", "x-go-package": "code.gitea.io/gitea/modules/structs" }, "SearchResults": { "description": "SearchResults results of a successful search", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/Repository" }, "x-go-name": "Data" }, "ok": { "type": "boolean", "x-go-name": "OK" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Secret": { "description": "Secret represents a secret", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "description": { "description": "the secret's description", "type": "string", "x-go-name": "Description" }, "name": { "description": "the secret's name", "type": "string", "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "ServerVersion": { "description": "ServerVersion wraps the version of the server", "type": "object", "properties": { "version": { "type": "string", "x-go-name": "Version" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "StateType": { "description": "StateType issue state type", "type": "string", "x-go-package": "code.gitea.io/gitea/modules/structs" }, "StopWatch": { "description": "StopWatch represent a running stopwatch", "type": "object", "properties": { "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "duration": { "type": "string", "x-go-name": "Duration" }, "issue_index": { "type": "integer", "format": "int64", "x-go-name": "IssueIndex" }, "issue_title": { "type": "string", "x-go-name": "IssueTitle" }, "repo_name": { "type": "string", "x-go-name": "RepoName" }, "repo_owner_name": { "type": "string", "x-go-name": "RepoOwnerName" }, "seconds": { "type": "integer", "format": "int64", "x-go-name": "Seconds" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "SubmitPullReviewOptions": { "description": "SubmitPullReviewOptions are options to submit a pending pull review", "type": "object", "properties": { "body": { "type": "string", "x-go-name": "Body" }, "event": { "$ref": "#/definitions/ReviewStateType" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Tag": { "description": "Tag represents a repository tag", "type": "object", "properties": { "commit": { "$ref": "#/definitions/CommitMeta" }, "id": { "type": "string", "x-go-name": "ID" }, "message": { "type": "string", "x-go-name": "Message" }, "name": { "type": "string", "x-go-name": "Name" }, "tarball_url": { "type": "string", "x-go-name": "TarballURL" }, "zipball_url": { "type": "string", "x-go-name": "ZipballURL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "TagProtection": { "description": "TagProtection represents a tag protection", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "name_pattern": { "type": "string", "x-go-name": "NamePattern" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "whitelist_teams": { "type": "array", "items": { "type": "string" }, "x-go-name": "WhitelistTeams" }, "whitelist_usernames": { "type": "array", "items": { "type": "string" }, "x-go-name": "WhitelistUsernames" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "Team": { "description": "Team represents a team in an organization", "type": "object", "properties": { "can_create_org_repo": { "type": "boolean", "x-go-name": "CanCreateOrgRepo" }, "description": { "type": "string", "x-go-name": "Description" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "includes_all_repositories": { "type": "boolean", "x-go-name": "IncludesAllRepositories" }, "name": { "type": "string", "x-go-name": "Name" }, "organization": { "$ref": "#/definitions/Organization" }, "permission": { "type": "string", "enum": [ "none", "read", "write", "admin", "owner" ], "x-go-name": "Permission" }, "units": { "type": "array", "items": { "type": "string" }, "x-go-name": "Units", "example": [ "repo.code", "repo.issues", "repo.ext_issues", "repo.wiki", "repo.pulls", "repo.releases", "repo.projects", "repo.ext_wiki" ] }, "units_map": { "type": "object", "additionalProperties": { "type": "string" }, "x-go-name": "UnitsMap", "example": { "repo.code": "read", "repo.ext_issues": "none", "repo.ext_wiki": "none", "repo.issues": "write", "repo.projects": "none", "repo.pulls": "owner", "repo.releases": "none", "repo.wiki": "admin" } } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "TimeStamp": { "description": "TimeStamp defines a timestamp", "type": "integer", "format": "int64", "x-go-package": "code.gitea.io/gitea/modules/timeutil" }, "TimelineComment": { "description": "TimelineComment represents a timeline comment (comment of any type) on a commit or issue", "type": "object", "properties": { "assignee": { "$ref": "#/definitions/User" }, "assignee_team": { "$ref": "#/definitions/Team" }, "body": { "type": "string", "x-go-name": "Body" }, "created_at": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "dependent_issue": { "$ref": "#/definitions/Issue" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "issue_url": { "type": "string", "x-go-name": "IssueURL" }, "label": { "$ref": "#/definitions/Label" }, "milestone": { "$ref": "#/definitions/Milestone" }, "new_ref": { "type": "string", "x-go-name": "NewRef" }, "new_title": { "type": "string", "x-go-name": "NewTitle" }, "old_milestone": { "$ref": "#/definitions/Milestone" }, "old_project_id": { "type": "integer", "format": "int64", "x-go-name": "OldProjectID" }, "old_ref": { "type": "string", "x-go-name": "OldRef" }, "old_title": { "type": "string", "x-go-name": "OldTitle" }, "project_id": { "type": "integer", "format": "int64", "x-go-name": "ProjectID" }, "pull_request_url": { "type": "string", "x-go-name": "PRURL" }, "ref_action": { "type": "string", "x-go-name": "RefAction" }, "ref_comment": { "$ref": "#/definitions/Comment" }, "ref_commit_sha": { "description": "commit SHA where issue/PR was referenced", "type": "string", "x-go-name": "RefCommitSHA" }, "ref_issue": { "$ref": "#/definitions/Issue" }, "removed_assignee": { "description": "whether the assignees were removed or added", "type": "boolean", "x-go-name": "RemovedAssignee" }, "resolve_doer": { "$ref": "#/definitions/User" }, "review_id": { "type": "integer", "format": "int64", "x-go-name": "ReviewID" }, "tracked_time": { "$ref": "#/definitions/TrackedTime" }, "type": { "type": "string", "x-go-name": "Type" }, "updated_at": { "type": "string", "format": "date-time", "x-go-name": "Updated" }, "user": { "$ref": "#/definitions/User" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "TopicName": { "description": "TopicName a list of repo topic names", "type": "object", "properties": { "topics": { "type": "array", "items": { "type": "string" }, "x-go-name": "TopicNames" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "TopicResponse": { "description": "TopicResponse for returning topics", "type": "object", "properties": { "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "repo_count": { "type": "integer", "format": "int64", "x-go-name": "RepoCount" }, "topic_name": { "type": "string", "x-go-name": "Name" }, "updated": { "type": "string", "format": "date-time", "x-go-name": "Updated" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "TrackedTime": { "description": "TrackedTime worked time for an issue / pr", "type": "object", "properties": { "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "id": { "type": "integer", "format": "int64", "x-go-name": "ID" }, "issue": { "$ref": "#/definitions/Issue" }, "issue_id": { "description": "deprecated (only for backwards compatibility)", "type": "integer", "format": "int64", "x-go-name": "IssueID" }, "time": { "description": "Time in seconds", "type": "integer", "format": "int64", "x-go-name": "Time" }, "user_id": { "description": "deprecated (only for backwards compatibility)", "type": "integer", "format": "int64", "x-go-name": "UserID" }, "user_name": { "type": "string", "x-go-name": "UserName" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "TransferRepoOption": { "description": "TransferRepoOption options when transfer a repository's ownership", "type": "object", "required": [ "new_owner" ], "properties": { "new_owner": { "type": "string", "x-go-name": "NewOwner" }, "team_ids": { "description": "ID of the team or teams to add to the repository. Teams can only be added to organization-owned repositories.", "type": "array", "items": { "type": "integer", "format": "int64" }, "x-go-name": "TeamIDs" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UpdateBranchProtectionPriories": { "description": "UpdateBranchProtectionPriories a list to update the branch protection rule priorities", "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "integer", "format": "int64" }, "x-go-name": "IDs" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UpdateBranchRepoOption": { "description": "UpdateBranchRepoOption options when updating a branch in a repository", "type": "object", "required": [ "name" ], "properties": { "name": { "description": "New branch name", "type": "string", "uniqueItems": true, "x-go-name": "Name" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UpdateFileOptions": { "description": "UpdateFileOptions options for updating files\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)", "type": "object", "required": [ "sha", "content" ], "properties": { "author": { "$ref": "#/definitions/Identity" }, "branch": { "description": "branch (optional) to base this file from. if not given, the default branch is used", "type": "string", "x-go-name": "BranchName" }, "committer": { "$ref": "#/definitions/Identity" }, "content": { "description": "content must be base64 encoded", "type": "string", "x-go-name": "ContentBase64" }, "dates": { "$ref": "#/definitions/CommitDateOptions" }, "from_path": { "description": "from_path (optional) is the path of the original file which will be moved/renamed to the path in the URL", "type": "string", "x-go-name": "FromPath" }, "message": { "description": "message (optional) for the commit of this file. if not supplied, a default message will be used", "type": "string", "x-go-name": "Message" }, "new_branch": { "description": "new_branch (optional) will make a new branch from `branch` before creating the file", "type": "string", "x-go-name": "NewBranchName" }, "sha": { "description": "sha is the SHA for the file that already exists", "type": "string", "x-go-name": "SHA" }, "signoff": { "description": "Add a Signed-off-by trailer by the committer at the end of the commit log message.", "type": "boolean", "x-go-name": "Signoff" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UpdateRepoAvatarOption": { "description": "UpdateRepoAvatarUserOption options when updating the repo avatar", "type": "object", "properties": { "image": { "description": "image must be base64 encoded", "type": "string", "x-go-name": "Image" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UpdateUserAvatarOption": { "description": "UpdateUserAvatarUserOption options when updating the user avatar", "type": "object", "properties": { "image": { "description": "image must be base64 encoded", "type": "string", "x-go-name": "Image" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UpdateVariableOption": { "description": "UpdateVariableOption the option when updating variable", "type": "object", "required": [ "value" ], "properties": { "description": { "description": "Description of the variable to update", "type": "string", "x-go-name": "Description" }, "name": { "description": "New name for the variable. If the field is empty, the variable name won't be updated.", "type": "string", "x-go-name": "Name" }, "value": { "description": "Value of the variable to update", "type": "string", "x-go-name": "Value" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "User": { "description": "User represents a user", "type": "object", "properties": { "active": { "description": "Is user active", "type": "boolean", "x-go-name": "IsActive" }, "avatar_url": { "description": "URL to the user's avatar", "type": "string", "x-go-name": "AvatarURL" }, "created": { "type": "string", "format": "date-time", "x-go-name": "Created" }, "description": { "description": "the user's description", "type": "string", "x-go-name": "Description" }, "email": { "type": "string", "format": "email", "x-go-name": "Email" }, "followers_count": { "description": "user counts", "type": "integer", "format": "int64", "x-go-name": "Followers" }, "following_count": { "type": "integer", "format": "int64", "x-go-name": "Following" }, "full_name": { "description": "the user's full name", "type": "string", "x-go-name": "FullName" }, "html_url": { "description": "URL to the user's gitea page", "type": "string", "x-go-name": "HTMLURL" }, "id": { "description": "the user's id", "type": "integer", "format": "int64", "x-go-name": "ID" }, "is_admin": { "description": "Is the user an administrator", "type": "boolean", "x-go-name": "IsAdmin" }, "language": { "description": "User locale", "type": "string", "x-go-name": "Language" }, "last_login": { "type": "string", "format": "date-time", "x-go-name": "LastLogin" }, "location": { "description": "the user's location", "type": "string", "x-go-name": "Location" }, "login": { "description": "the user's username", "type": "string", "x-go-name": "UserName" }, "login_name": { "description": "the user's authentication sign-in name.", "type": "string", "default": "empty", "x-go-name": "LoginName" }, "prohibit_login": { "description": "Is user login prohibited", "type": "boolean", "x-go-name": "ProhibitLogin" }, "restricted": { "description": "Is user restricted", "type": "boolean", "x-go-name": "Restricted" }, "source_id": { "description": "The ID of the user's Authentication Source", "type": "integer", "format": "int64", "x-go-name": "SourceID" }, "starred_repos_count": { "type": "integer", "format": "int64", "x-go-name": "StarredRepos" }, "visibility": { "description": "User visibility level option: public, limited, private", "type": "string", "x-go-name": "Visibility" }, "website": { "description": "the user's website", "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UserBadgeOption": { "description": "UserBadgeOption options for link between users and badges", "type": "object", "properties": { "badge_slugs": { "type": "array", "items": { "type": "string" }, "x-go-name": "BadgeSlugs", "example": [ "badge1", "badge2" ] } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UserHeatmapData": { "description": "UserHeatmapData represents the data needed to create a heatmap", "type": "object", "properties": { "contributions": { "type": "integer", "format": "int64", "x-go-name": "Contributions" }, "timestamp": { "$ref": "#/definitions/TimeStamp" } }, "x-go-package": "code.gitea.io/gitea/models/activities" }, "UserSettings": { "description": "UserSettings represents user settings", "type": "object", "properties": { "description": { "type": "string", "x-go-name": "Description" }, "diff_view_style": { "type": "string", "x-go-name": "DiffViewStyle" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "hide_activity": { "type": "boolean", "x-go-name": "HideActivity" }, "hide_email": { "description": "Privacy", "type": "boolean", "x-go-name": "HideEmail" }, "language": { "type": "string", "x-go-name": "Language" }, "location": { "type": "string", "x-go-name": "Location" }, "theme": { "type": "string", "x-go-name": "Theme" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "UserSettingsOptions": { "description": "UserSettingsOptions represents options to change user settings", "type": "object", "properties": { "description": { "type": "string", "x-go-name": "Description" }, "diff_view_style": { "type": "string", "x-go-name": "DiffViewStyle" }, "full_name": { "type": "string", "x-go-name": "FullName" }, "hide_activity": { "type": "boolean", "x-go-name": "HideActivity" }, "hide_email": { "description": "Privacy", "type": "boolean", "x-go-name": "HideEmail" }, "language": { "type": "string", "x-go-name": "Language" }, "location": { "type": "string", "x-go-name": "Location" }, "theme": { "type": "string", "x-go-name": "Theme" }, "website": { "type": "string", "x-go-name": "Website" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "WatchInfo": { "description": "WatchInfo represents an API watch status of one repository", "type": "object", "properties": { "created_at": { "type": "string", "format": "date-time", "x-go-name": "CreatedAt" }, "ignored": { "type": "boolean", "x-go-name": "Ignored" }, "reason": { "x-go-name": "Reason" }, "repository_url": { "type": "string", "x-go-name": "RepositoryURL" }, "subscribed": { "type": "boolean", "x-go-name": "Subscribed" }, "url": { "type": "string", "x-go-name": "URL" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "WikiCommit": { "description": "WikiCommit page commit/revision", "type": "object", "properties": { "author": { "$ref": "#/definitions/CommitUser" }, "commiter": { "$ref": "#/definitions/CommitUser" }, "message": { "type": "string", "x-go-name": "Message" }, "sha": { "type": "string", "x-go-name": "ID" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "WikiCommitList": { "description": "WikiCommitList commit/revision list", "type": "object", "properties": { "commits": { "type": "array", "items": { "$ref": "#/definitions/WikiCommit" }, "x-go-name": "WikiCommits" }, "count": { "type": "integer", "format": "int64", "x-go-name": "Count" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "WikiPage": { "description": "WikiPage a wiki page", "type": "object", "properties": { "commit_count": { "type": "integer", "format": "int64", "x-go-name": "CommitCount" }, "content_base64": { "description": "Page content, base64 encoded", "type": "string", "x-go-name": "ContentBase64" }, "footer": { "type": "string", "x-go-name": "Footer" }, "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "last_commit": { "$ref": "#/definitions/WikiCommit" }, "sidebar": { "type": "string", "x-go-name": "Sidebar" }, "sub_url": { "type": "string", "x-go-name": "SubURL" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" }, "WikiPageMetaData": { "description": "WikiPageMetaData wiki page meta information", "type": "object", "properties": { "html_url": { "type": "string", "x-go-name": "HTMLURL" }, "last_commit": { "$ref": "#/definitions/WikiCommit" }, "sub_url": { "type": "string", "x-go-name": "SubURL" }, "title": { "type": "string", "x-go-name": "Title" } }, "x-go-package": "code.gitea.io/gitea/modules/structs" } }, "responses": { "AccessToken": { "description": "AccessToken represents an API access token.", "schema": { "$ref": "#/definitions/AccessToken" } }, "AccessTokenList": { "description": "AccessTokenList represents a list of API access token.", "schema": { "type": "array", "items": { "$ref": "#/definitions/AccessToken" } } }, "ActionVariable": { "description": "ActionVariable", "schema": { "$ref": "#/definitions/ActionVariable" } }, "ActionWorkflow": { "description": "ActionWorkflow", "schema": { "$ref": "#/definitions/ActionWorkflow" } }, "ActionWorkflowList": { "description": "ActionWorkflowList", "schema": { "$ref": "#/definitions/ActionWorkflowResponse" } }, "ActivityFeedsList": { "description": "ActivityFeedsList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Activity" } } }, "ActivityPub": { "description": "ActivityPub", "schema": { "$ref": "#/definitions/ActivityPub" } }, "AnnotatedTag": { "description": "AnnotatedTag", "schema": { "$ref": "#/definitions/AnnotatedTag" } }, "Artifact": { "description": "Artifact", "schema": { "$ref": "#/definitions/ActionArtifact" } }, "ArtifactsList": { "description": "ArtifactsList", "schema": { "$ref": "#/definitions/ActionArtifactsResponse" } }, "Attachment": { "description": "Attachment", "schema": { "$ref": "#/definitions/Attachment" } }, "AttachmentList": { "description": "AttachmentList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Attachment" } } }, "BadgeList": { "description": "BadgeList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Badge" } } }, "Branch": { "description": "Branch", "schema": { "$ref": "#/definitions/Branch" } }, "BranchList": { "description": "BranchList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Branch" } } }, "BranchProtection": { "description": "BranchProtection", "schema": { "$ref": "#/definitions/BranchProtection" } }, "BranchProtectionList": { "description": "BranchProtectionList", "schema": { "type": "array", "items": { "$ref": "#/definitions/BranchProtection" } } }, "ChangedFileList": { "description": "ChangedFileList", "schema": { "type": "array", "items": { "$ref": "#/definitions/ChangedFile" } }, "headers": { "X-HasMore": { "type": "boolean", "description": "True if there is another page" }, "X-Page": { "type": "integer", "format": "int64", "description": "The current page" }, "X-PageCount": { "type": "integer", "format": "int64", "description": "Total number of pages" }, "X-PerPage": { "type": "integer", "format": "int64", "description": "Commits per page" }, "X-Total": { "type": "integer", "format": "int64", "description": "Total commit count" } } }, "CombinedStatus": { "description": "CombinedStatus", "schema": { "$ref": "#/definitions/CombinedStatus" } }, "Comment": { "description": "Comment", "schema": { "$ref": "#/definitions/Comment" } }, "CommentList": { "description": "CommentList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Comment" } } }, "Commit": { "description": "Commit", "schema": { "$ref": "#/definitions/Commit" } }, "CommitList": { "description": "CommitList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Commit" } }, "headers": { "X-HasMore": { "type": "boolean", "description": "True if there is another page" }, "X-Page": { "type": "integer", "format": "int64", "description": "The current page" }, "X-PageCount": { "type": "integer", "format": "int64", "description": "Total number of pages" }, "X-PerPage": { "type": "integer", "format": "int64", "description": "Commits per page" }, "X-Total": { "type": "integer", "format": "int64", "description": "Total commit count" } } }, "CommitStatus": { "description": "CommitStatus", "schema": { "$ref": "#/definitions/CommitStatus" } }, "CommitStatusList": { "description": "CommitStatusList", "schema": { "type": "array", "items": { "$ref": "#/definitions/CommitStatus" } } }, "Compare": { "description": "", "schema": { "$ref": "#/definitions/Compare" } }, "ContentsListResponse": { "description": "ContentsListResponse", "schema": { "type": "array", "items": { "$ref": "#/definitions/ContentsResponse" } } }, "ContentsResponse": { "description": "ContentsResponse", "schema": { "$ref": "#/definitions/ContentsResponse" } }, "CronList": { "description": "CronList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Cron" } } }, "DeployKey": { "description": "DeployKey", "schema": { "$ref": "#/definitions/DeployKey" } }, "DeployKeyList": { "description": "DeployKeyList", "schema": { "type": "array", "items": { "$ref": "#/definitions/DeployKey" } } }, "EmailList": { "description": "EmailList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Email" } } }, "EmptyRepository": { "description": "EmptyRepository", "schema": { "$ref": "#/definitions/APIError" } }, "FileDeleteResponse": { "description": "FileDeleteResponse", "schema": { "$ref": "#/definitions/FileDeleteResponse" } }, "FileResponse": { "description": "FileResponse", "schema": { "$ref": "#/definitions/FileResponse" } }, "FilesResponse": { "description": "FilesResponse", "schema": { "$ref": "#/definitions/FilesResponse" } }, "GPGKey": { "description": "GPGKey", "schema": { "$ref": "#/definitions/GPGKey" } }, "GPGKeyList": { "description": "GPGKeyList", "schema": { "type": "array", "items": { "$ref": "#/definitions/GPGKey" } } }, "GeneralAPISettings": { "description": "GeneralAPISettings", "schema": { "$ref": "#/definitions/GeneralAPISettings" } }, "GeneralAttachmentSettings": { "description": "GeneralAttachmentSettings", "schema": { "$ref": "#/definitions/GeneralAttachmentSettings" } }, "GeneralRepoSettings": { "description": "GeneralRepoSettings", "schema": { "$ref": "#/definitions/GeneralRepoSettings" } }, "GeneralUISettings": { "description": "GeneralUISettings", "schema": { "$ref": "#/definitions/GeneralUISettings" } }, "GitBlobResponse": { "description": "GitBlobResponse", "schema": { "$ref": "#/definitions/GitBlobResponse" } }, "GitHook": { "description": "GitHook", "schema": { "$ref": "#/definitions/GitHook" } }, "GitHookList": { "description": "GitHookList", "schema": { "type": "array", "items": { "$ref": "#/definitions/GitHook" } } }, "GitTreeResponse": { "description": "GitTreeResponse", "schema": { "$ref": "#/definitions/GitTreeResponse" } }, "GitignoreTemplateInfo": { "description": "GitignoreTemplateInfo", "schema": { "$ref": "#/definitions/GitignoreTemplateInfo" } }, "GitignoreTemplateList": { "description": "GitignoreTemplateList", "schema": { "type": "array", "items": { "type": "string" } } }, "Hook": { "description": "Hook", "schema": { "$ref": "#/definitions/Hook" } }, "HookList": { "description": "HookList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Hook" } } }, "Issue": { "description": "Issue", "schema": { "$ref": "#/definitions/Issue" } }, "IssueDeadline": { "description": "IssueDeadline", "schema": { "$ref": "#/definitions/IssueDeadline" } }, "IssueList": { "description": "IssueList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Issue" } } }, "IssueTemplates": { "description": "IssueTemplates", "schema": { "type": "array", "items": { "$ref": "#/definitions/IssueTemplate" } } }, "Label": { "description": "Label", "schema": { "$ref": "#/definitions/Label" } }, "LabelList": { "description": "LabelList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Label" } } }, "LabelTemplateInfo": { "description": "LabelTemplateInfo", "schema": { "type": "array", "items": { "$ref": "#/definitions/LabelTemplate" } } }, "LabelTemplateList": { "description": "LabelTemplateList", "schema": { "type": "array", "items": { "type": "string" } } }, "LanguageStatistics": { "description": "LanguageStatistics", "schema": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" } } }, "LicenseTemplateInfo": { "description": "LicenseTemplateInfo", "schema": { "$ref": "#/definitions/LicenseTemplateInfo" } }, "LicenseTemplateList": { "description": "LicenseTemplateList", "schema": { "type": "array", "items": { "$ref": "#/definitions/LicensesTemplateListEntry" } } }, "LicensesList": { "description": "LicensesList", "schema": { "type": "array", "items": { "type": "string" } } }, "MarkdownRender": { "description": "MarkdownRender is a rendered markdown document", "schema": { "type": "string" } }, "MarkupRender": { "description": "MarkupRender is a rendered markup document", "schema": { "type": "string" } }, "MergeUpstreamRequest": { "description": "", "schema": { "$ref": "#/definitions/MergeUpstreamRequest" } }, "MergeUpstreamResponse": { "description": "", "schema": { "$ref": "#/definitions/MergeUpstreamResponse" } }, "Milestone": { "description": "Milestone", "schema": { "$ref": "#/definitions/Milestone" } }, "MilestoneList": { "description": "MilestoneList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Milestone" } } }, "NodeInfo": { "description": "NodeInfo", "schema": { "$ref": "#/definitions/NodeInfo" } }, "Note": { "description": "Note", "schema": { "$ref": "#/definitions/Note" } }, "NotificationCount": { "description": "Number of unread notifications", "schema": { "$ref": "#/definitions/NotificationCount" } }, "NotificationThread": { "description": "NotificationThread", "schema": { "$ref": "#/definitions/NotificationThread" } }, "NotificationThreadList": { "description": "NotificationThreadList", "schema": { "type": "array", "items": { "$ref": "#/definitions/NotificationThread" } } }, "OAuth2Application": { "description": "OAuth2Application", "schema": { "$ref": "#/definitions/OAuth2Application" } }, "OAuth2ApplicationList": { "description": "OAuth2ApplicationList represents a list of OAuth2 applications.", "schema": { "type": "array", "items": { "$ref": "#/definitions/OAuth2Application" } } }, "Organization": { "description": "Organization", "schema": { "$ref": "#/definitions/Organization" } }, "OrganizationList": { "description": "OrganizationList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Organization" } } }, "OrganizationPermissions": { "description": "OrganizationPermissions", "schema": { "$ref": "#/definitions/OrganizationPermissions" } }, "Package": { "description": "Package", "schema": { "$ref": "#/definitions/Package" } }, "PackageFileList": { "description": "PackageFileList", "schema": { "type": "array", "items": { "$ref": "#/definitions/PackageFile" } } }, "PackageList": { "description": "PackageList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Package" } } }, "PublicKey": { "description": "PublicKey", "schema": { "$ref": "#/definitions/PublicKey" } }, "PublicKeyList": { "description": "PublicKeyList", "schema": { "type": "array", "items": { "$ref": "#/definitions/PublicKey" } } }, "PullRequest": { "description": "PullRequest", "schema": { "$ref": "#/definitions/PullRequest" } }, "PullRequestList": { "description": "PullRequestList", "schema": { "type": "array", "items": { "$ref": "#/definitions/PullRequest" } } }, "PullReview": { "description": "PullReview", "schema": { "$ref": "#/definitions/PullReview" } }, "PullReviewComment": { "description": "PullComment", "schema": { "$ref": "#/definitions/PullReviewComment" } }, "PullReviewCommentList": { "description": "PullCommentList", "schema": { "type": "array", "items": { "$ref": "#/definitions/PullReviewComment" } } }, "PullReviewList": { "description": "PullReviewList", "schema": { "type": "array", "items": { "$ref": "#/definitions/PullReview" } } }, "PushMirror": { "description": "PushMirror", "schema": { "$ref": "#/definitions/PushMirror" } }, "PushMirrorList": { "description": "PushMirrorList", "schema": { "type": "array", "items": { "$ref": "#/definitions/PushMirror" } } }, "Reaction": { "description": "Reaction", "schema": { "$ref": "#/definitions/Reaction" } }, "ReactionList": { "description": "ReactionList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Reaction" } } }, "Reference": { "description": "Reference", "schema": { "$ref": "#/definitions/Reference" } }, "ReferenceList": { "description": "ReferenceList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } }, "RegistrationToken": { "description": "RegistrationToken is response related to registration token", "headers": { "token": { "type": "string" } } }, "Release": { "description": "Release", "schema": { "$ref": "#/definitions/Release" } }, "ReleaseList": { "description": "ReleaseList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Release" } } }, "RepoCollaboratorPermission": { "description": "RepoCollaboratorPermission", "schema": { "$ref": "#/definitions/RepoCollaboratorPermission" } }, "RepoIssueConfig": { "description": "RepoIssueConfig", "schema": { "$ref": "#/definitions/IssueConfig" } }, "RepoIssueConfigValidation": { "description": "RepoIssueConfigValidation", "schema": { "$ref": "#/definitions/IssueConfigValidation" } }, "RepoNewIssuePinsAllowed": { "description": "RepoNewIssuePinsAllowed", "schema": { "$ref": "#/definitions/NewIssuePinsAllowed" } }, "Repository": { "description": "Repository", "schema": { "$ref": "#/definitions/Repository" } }, "RepositoryList": { "description": "RepositoryList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Repository" } } }, "Runner": { "description": "Runner", "schema": { "$ref": "#/definitions/ActionRunner" } }, "RunnerList": { "description": "RunnerList", "schema": { "$ref": "#/definitions/ActionRunnersResponse" } }, "SearchResults": { "description": "SearchResults", "schema": { "$ref": "#/definitions/SearchResults" } }, "Secret": { "description": "Secret", "schema": { "$ref": "#/definitions/Secret" } }, "SecretList": { "description": "SecretList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Secret" } } }, "ServerVersion": { "description": "ServerVersion", "schema": { "$ref": "#/definitions/ServerVersion" } }, "StopWatch": { "description": "StopWatch", "schema": { "$ref": "#/definitions/StopWatch" } }, "StopWatchList": { "description": "StopWatchList", "schema": { "type": "array", "items": { "$ref": "#/definitions/StopWatch" } } }, "StringSlice": { "description": "StringSlice", "schema": { "type": "array", "items": { "type": "string" } } }, "Tag": { "description": "Tag", "schema": { "$ref": "#/definitions/Tag" } }, "TagList": { "description": "TagList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Tag" } } }, "TagProtection": { "description": "TagProtection", "schema": { "$ref": "#/definitions/TagProtection" } }, "TagProtectionList": { "description": "TagProtectionList", "schema": { "type": "array", "items": { "$ref": "#/definitions/TagProtection" } } }, "TasksList": { "description": "TasksList", "schema": { "$ref": "#/definitions/ActionTaskResponse" } }, "Team": { "description": "Team", "schema": { "$ref": "#/definitions/Team" } }, "TeamList": { "description": "TeamList", "schema": { "type": "array", "items": { "$ref": "#/definitions/Team" } } }, "TimelineList": { "description": "TimelineList", "schema": { "type": "array", "items": { "$ref": "#/definitions/TimelineComment" } } }, "TopicListResponse": { "description": "TopicListResponse", "schema": { "type": "array", "items": { "$ref": "#/definitions/TopicResponse" } } }, "TopicNames": { "description": "TopicNames", "schema": { "$ref": "#/definitions/TopicName" } }, "TrackedTime": { "description": "TrackedTime", "schema": { "$ref": "#/definitions/TrackedTime" } }, "TrackedTimeList": { "description": "TrackedTimeList", "schema": { "type": "array", "items": { "$ref": "#/definitions/TrackedTime" } } }, "User": { "description": "User", "schema": { "$ref": "#/definitions/User" } }, "UserHeatmapData": { "description": "UserHeatmapData", "schema": { "type": "array", "items": { "$ref": "#/definitions/UserHeatmapData" } } }, "UserList": { "description": "UserList", "schema": { "type": "array", "items": { "$ref": "#/definitions/User" } } }, "UserSettings": { "description": "UserSettings", "schema": { "type": "array", "items": { "$ref": "#/definitions/UserSettings" } } }, "VariableList": { "description": "VariableList", "schema": { "type": "array", "items": { "$ref": "#/definitions/ActionVariable" } } }, "WatchInfo": { "description": "WatchInfo", "schema": { "$ref": "#/definitions/WatchInfo" } }, "WikiCommitList": { "description": "WikiCommitList", "schema": { "$ref": "#/definitions/WikiCommitList" } }, "WikiPage": { "description": "WikiPage", "schema": { "$ref": "#/definitions/WikiPage" } }, "WikiPageList": { "description": "WikiPageList", "schema": { "type": "array", "items": { "$ref": "#/definitions/WikiPageMetaData" } } }, "conflict": { "description": "APIConflict is a conflict empty response" }, "empty": { "description": "APIEmpty is an empty response" }, "error": { "description": "APIError is error format response", "headers": { "message": { "type": "string" }, "url": { "type": "string" } } }, "forbidden": { "description": "APIForbiddenError is a forbidden error response", "headers": { "message": { "type": "string" }, "url": { "type": "string" } } }, "invalidTopicsError": { "description": "APIInvalidTopicsError is error format response to invalid topics", "headers": { "invalidTopics": { "type": "array", "items": { "type": "string" } }, "message": { "type": "string" } } }, "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": { "message": { "type": "string" }, "url": { "type": "string" } } }, "string": { "description": "APIString is a string response", "schema": { "type": "string" } }, "validationError": { "description": "APIValidationError is error format response related to input validation", "headers": { "message": { "type": "string" }, "url": { "type": "string" } } } }, "securityDefinitions": { "AccessToken": { "description": "This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.", "type": "apiKey", "name": "access_token", "in": "query" }, "AuthorizationHeaderToken": { "description": "API tokens must be prepended with \"token\" followed by a space.", "type": "apiKey", "name": "Authorization", "in": "header" }, "BasicAuth": { "type": "basic" }, "SudoHeader": { "description": "Sudo API request as the user provided as the key. Admin privileges are required.", "type": "apiKey", "name": "Sudo", "in": "header" }, "SudoParam": { "description": "Sudo API request as the user provided as the key. Admin privileges are required.", "type": "apiKey", "name": "sudo", "in": "query" }, "TOTPHeader": { "description": "Must be used in combination with BasicAuth if two-factor authentication is enabled.", "type": "apiKey", "name": "X-GITEA-OTP", "in": "header" }, "Token": { "description": "This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.", "type": "apiKey", "name": "token", "in": "query" } }, "security": [ { "BasicAuth": [] }, { "Token": [] }, { "AccessToken": [] }, { "AuthorizationHeaderToken": [] }, { "SudoParam": [] }, { "SudoHeader": [] }, { "TOTPHeader": [] } ] }