You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8011 lines
192 KiB
8011 lines
192 KiB
{
|
|
"consumes": [
|
|
"application/json",
|
|
"text/plain"
|
|
],
|
|
"produces": [
|
|
"application/json",
|
|
"text/html"
|
|
],
|
|
"schemes": [
|
|
"http",
|
|
"https"
|
|
],
|
|
"swagger": "2.0",
|
|
"info": {
|
|
"description": "This documentation describes the Gitea API.",
|
|
"title": "Gitea API.",
|
|
"license": {
|
|
"name": "MIT",
|
|
"url": "http://opensource.org/licenses/MIT"
|
|
},
|
|
"version": "1.1.1"
|
|
},
|
|
"basePath": "{{AppSubUrl}}/api/v1",
|
|
"paths": {
|
|
"/admin/users": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"admin"
|
|
],
|
|
"summary": "Create a user",
|
|
"operationId": "adminCreateUser",
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/CreateUserOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/User"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/admin/users/{username}": {
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"admin"
|
|
],
|
|
"summary": "Delete a user",
|
|
"operationId": "adminDeleteUser",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "username of user to delete",
|
|
"name": "username",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"admin"
|
|
],
|
|
"summary": "Edit an existing user",
|
|
"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"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/admin/users/{username}/keys": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"admin"
|
|
],
|
|
"summary": "Add a public key on behalf of a user",
|
|
"operationId": "adminCreatePublicKey",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "username of the user",
|
|
"name": "username",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"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": "Delete a user's public key",
|
|
"operationId": "adminDeleteUserPublicKey",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "username of user",
|
|
"name": "username",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"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": "Create an organization",
|
|
"operationId": "adminCreateOrg",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "username of the user that will own the created organization",
|
|
"name": "username",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Organization"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/admin/users/{username}/repos": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"admin"
|
|
],
|
|
"summary": "Create a repository on behalf a user",
|
|
"operationId": "adminCreateRepo",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "username of the user. This user will own the created repository",
|
|
"name": "username",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Repository"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/markdown": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"text/html"
|
|
],
|
|
"tags": [
|
|
"miscellaneous"
|
|
],
|
|
"summary": "Render a markdown document as 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": "Render raw markdown as 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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/org/{org}/repos": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Create a repository in an organization",
|
|
"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"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Get an organization",
|
|
"operationId": "orgGet",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization to get",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Organization"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Edit an organization",
|
|
"operationId": "orgEdit",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization to edit",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/EditOrgOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Organization"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/hooks": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "List an organization's webhooks",
|
|
"operationId": "orgListHooks",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/HookList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/hooks/": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Create a hook",
|
|
"operationId": "orgCreateHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Hook"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/hooks/{id}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Get a hook",
|
|
"operationId": "orgGetHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the hook to get",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Hook"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Delete a hook",
|
|
"operationId": "orgDeleteHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"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": [
|
|
"organization"
|
|
],
|
|
"summary": "Update a hook",
|
|
"operationId": "orgEditHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the hook to update",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Hook"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/members": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "List an organization's members",
|
|
"operationId": "orgListMembers",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/UserList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/members/{username}": {
|
|
"get": {
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Check if a user is a member of an organization",
|
|
"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",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "user is not a member",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Remove a member from an organization",
|
|
"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",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/public_members": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "List an organization's public members",
|
|
"operationId": "orgListPublicMembers",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/UserList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/public_members/{username}": {
|
|
"get": {
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Check if a user is a public member of an organization",
|
|
"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",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "user is not a public member",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Publicize a user's membership",
|
|
"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",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Conceal a user's membership",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/repos": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "List an organization's repos",
|
|
"operationId": "orgListRepos",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/RepositoryList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/orgs/{org}/teams": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "List an organization's teams",
|
|
"operationId": "orgListTeams",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "name of the organization",
|
|
"name": "org",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/TeamList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"organization"
|
|
],
|
|
"summary": "Create a team",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/migrate": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Migrate a remote git repository",
|
|
"operationId": "repoMigrate",
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/MigrateRepoForm"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Repository"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/search": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Search for repositories",
|
|
"operationId": "repoSearch",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "keyword",
|
|
"name": "q",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "search only for repos that the user with the given id owns or contributes to",
|
|
"name": "uid",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "page number of results to return (1-based)",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "page size of results, maximum page size is 50",
|
|
"name": "limit",
|
|
"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"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/SearchResults"
|
|
},
|
|
"422": {
|
|
"$ref": "#/responses/validationError"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a repository",
|
|
"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"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Delete a repository",
|
|
"operationId": "repoDelete",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo to delete",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo to delete",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/forbidden"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/archive/{archive}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get an archive of a repository",
|
|
"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": "archive to download, consisting of a git reference and archive",
|
|
"name": "archive",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "success"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/branches": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repository's branches",
|
|
"operationId": "repoListBranches",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/BranchList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/branches/{branch}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repository's branches",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/collaborators": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repository's collaborators",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/UserList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/collaborators/{collaborator}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Check if a user is a collaborator of a repository",
|
|
"operationId": "repoCheckCollaborator",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "username of the collaborator",
|
|
"name": "collaborator",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
},
|
|
"404": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Add a collaborator to a repository",
|
|
"operationId": "repoAddCollaborator",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"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"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Delete a collaborator from a repository",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/commits/{ref}/statuses": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a commit's combined status, by branch/tag/commit reference",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Status"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/editorconfig/{filepath}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get the EditorConfig definitions of a file in a repository",
|
|
"operationId": "repoGetEditorConfig",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "success"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/forks": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repository's forks",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/RepositoryList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Fork a repository",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/hooks": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List the hooks in a repository",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/HookList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Create a hook",
|
|
"operationId": "repoCreateHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/CreateHookOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Hook"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/hooks/{id}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a hook",
|
|
"operationId": "repoGetHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the hook to get",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Hook"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Delete a hook in a repository",
|
|
"operationId": "repoDeleteHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"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": "Edit a hook in a repository",
|
|
"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",
|
|
"description": "index of the hook",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/EditHookOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Hook"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/hooks/{id}/tests": {
|
|
"post": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Test a push webhook",
|
|
"operationId": "repoTestHook",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the hook to test",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "List a repository's issues",
|
|
"operationId": "issueListIssues",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "whether issue is open or closed",
|
|
"name": "state",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "page number of requested issues",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "search string",
|
|
"name": "q",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/IssueList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Create an issue",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/comments": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "List all comments in a repository",
|
|
"operationId": "issueGetRepoComments",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "if provided, only comments updated since the provided time are returned.",
|
|
"name": "since",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/CommentList"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/comments/{id}": {
|
|
"delete": {
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Delete a comment",
|
|
"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",
|
|
"description": "id of comment to delete",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Edit a comment",
|
|
"operationId": "issueEditComment",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{id}/times": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "List an issue's tracked times",
|
|
"operationId": "issueTrackedTimes",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the issue",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/TrackedTimeList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Add a tracked time to a issue",
|
|
"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",
|
|
"description": "index of the issue to add tracked time to",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/AddTimeOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/TrackedTime"
|
|
},
|
|
"400": {
|
|
"$ref": "#/responses/error"
|
|
},
|
|
"403": {
|
|
"$ref": "#/responses/error"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{index}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Get an issue",
|
|
"operationId": "issueGetIssue",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the issue to get",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Issue"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Edit an issue",
|
|
"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",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{index}/comments": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "List all comments on an issue",
|
|
"operationId": "issueGetComments",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the issue",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "if provided, only comments updated since the specified time are returned.",
|
|
"name": "since",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/CommentList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Add a comment to an issue",
|
|
"operationId": "issueCreateComment",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the issue",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/CreateIssueCommentOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Comment"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{index}/comments/{id}": {
|
|
"delete": {
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Delete a comment",
|
|
"operationId": "issueDeleteCommentDeprecated",
|
|
"deprecated": true,
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "this parameter is ignored",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of comment to delete",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Edit a comment",
|
|
"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",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{index}/deadline": {
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Set an issue deadline. If set to null, the deadline is deleted.",
|
|
"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",
|
|
"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": {
|
|
"description": "Not repo writer",
|
|
"schema": {
|
|
"$ref": "#/responses/forbidden"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Issue not found",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{index}/labels": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Get an issue's labels",
|
|
"operationId": "issueGetLabels",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"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": "Replace an issue's labels",
|
|
"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",
|
|
"description": "index of the issue",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/IssueLabelsOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/LabelList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Add a label to an issue",
|
|
"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",
|
|
"description": "index of the issue",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/IssueLabelsOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/LabelList"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Remove all labels from an issue",
|
|
"operationId": "issueClearLabels",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the issue",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/issues/{index}/labels/{id}": {
|
|
"delete": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Remove a label from an issue",
|
|
"operationId": "issueRemoveLabel",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the issue",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the label to remove",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/keys": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repository's keys",
|
|
"operationId": "repoListKeys",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/DeployKeyList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Add a key to a repository",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/keys/{id}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a repository's key by id",
|
|
"operationId": "repoGetKey",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the key to get",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/DeployKey"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Delete a key from a repository",
|
|
"operationId": "repoDeleteKey",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the key to delete",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/labels": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Get all of a repository's labels",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/LabelList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Create a label",
|
|
"operationId": "issueCreateLabel",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/labels/{id}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Get a single label",
|
|
"operationId": "issueGetLabel",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the label to get",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Label"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Delete a label",
|
|
"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",
|
|
"description": "id of the label to delete",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Update a label",
|
|
"operationId": "issueEditLabel",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/milestones": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Get all of a repository's milestones",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/MilestoneList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Create a milestone",
|
|
"operationId": "issueCreateMilestone",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/CreateMilestoneOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/Milestone"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/milestones/{id}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Get a milestone",
|
|
"operationId": "issueGetMilestone",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "id of the milestone",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Milestone"
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Delete a milestone",
|
|
"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": "integer",
|
|
"description": "id of the milestone to delete",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"issue"
|
|
],
|
|
"summary": "Update a milestone",
|
|
"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": "integer",
|
|
"description": "id of the milestone",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/EditMilestoneOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/Milestone"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/mirror-sync": {
|
|
"post": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Sync a mirrored repository",
|
|
"operationId": "repoMirrorSync",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo to sync",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo to sync",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/pulls": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repo's pull requests",
|
|
"operationId": "repoListPullRequests",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/PullRequestList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Create a pull request",
|
|
"operationId": "repoCreatePullRequest",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"schema": {
|
|
"$ref": "#/definitions/CreatePullRequestOption"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"$ref": "#/responses/PullRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/pulls/{index}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a pull request",
|
|
"operationId": "repoGetPullRequest",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the pull request to get",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/PullRequest"
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Update a pull request",
|
|
"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",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/pulls/{index}/merge": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Check if a pull request has been merged",
|
|
"operationId": "repoPullRequestIsMerged",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "index of the pull request",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"204": {
|
|
"description": "pull request has been merged",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "pull request has not been merged",
|
|
"schema": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Merge a pull request",
|
|
"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",
|
|
"description": "index of the pull request to merge",
|
|
"name": "index",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/empty"
|
|
},
|
|
"405": {
|
|
"$ref": "#/responses/empty"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/raw/{filepath}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a file from a repository",
|
|
"operationId": "repoGetRawFile",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "name of the repo",
|
|
"name": "repo",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "filepath of the file to get",
|
|
"name": "filepath",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "success"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/releases": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "List a repo's releases",
|
|
"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
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"$ref": "#/responses/ReleaseList"
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Create a release",
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/repos/{owner}/{repo}/releases/{id}": {
|
|
"get": {
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"repository"
|
|
],
|
|
"summary": "Get a release",
|
|
"operationId": "repoGetRelease",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "owner of the repo",
|
|
"name": "owner",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|