[ { "path": ".gitignore", "content": "# Compiled Object files, Static and Dynamic libs (Shared Objects)\n*.o\n*.a\n*.so\n\n# Folders\n_obj\n_test\n\n# Architecture specific extensions/prefixes\n*.[568vq]\n[568vq].out\n\n*.cgo1.go\n*.cgo2.c\n_cgo_defun.c\n_cgo_gotypes.go\n_cgo_export.*\n\n_testmain.go\n\n*.exe\n*.test\n*.prof\n" }, { "path": ".travis.yml", "content": "language: go\ngo: \n - 1.6.3\n - 1.7.1\n - tip\n\nscript:\n - go test -v ./...\n" }, { "path": "CONTRIBUTORS", "content": "go-raml Contributor List (ordered by date):\n\nAlon Diamant [https://github.com/advance512]\nDvir Volk [https://github.com/dvirsky]\n\nIf anyone is missing, please message me.\n" }, { "path": "LICENSE", "content": "Copyright 2014 DoAT. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice,\n this list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation and/or\n other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTIES WHATSOEVER.\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\nTHE IMPLIED WARRANTIES OF NON INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL DoAT OR CONTRIBUTORS\nBE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\nEVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\nThe views and conclusions contained in the software and documentation are those of\nthe authors and should not be interpreted as representing official policies,\neither expressed or implied, of DoAT.\n" }, { "path": "README.md", "content": "[![Build Status](https://travis-ci.org/go-raml/raml.svg?branch=v0)](https://travis-ci.org/go-raml/raml)\n\nLooking for active maintainers!\n===============================\n\n\n--\n\n\n\n\nraml\n====\n\nAn implementation of a RAML parser for Go. Compliant with RAML 0.8.\n\nIntroduction\n============\n\nRAML is a YAML-based language that describes RESTful APIs. Together with the\nYAML specification, this specification provides all the information necessary\nto describe RESTful APIs; to create API client-code and API server-code\ngenerators; and to create API user documentation from RAML API definitions.\n\nThe **_raml_** package enables Go programs to parse RAML files and valid RAML API\ndefinitions. It was originally developed within [EverythingMe](https://www.everything.me).\n\nStatus\n------\n\nThe **_raml_** package is currently unstable and does not offer any kind of API\nstability guarantees.\n\nInstallation\n============\n\nThe yaml package may be installed by running:\n\n $ go get gopkg.in/raml.v0\n\nOpening that same URL in a browser will present a nice introductory page\ncontaining links to the documentation, source code, and all versions available\nfor the given package:\n\nhttps://gopkg.in/raml.v0\n\nThe actual implementation of the package is in GitHub:\n\nhttps://github.com/go-raml/raml\n\nContributing to development\n---------------------------\n\nTypical installation process for developing purposes:\n\n $ git clone git@github.com:go-raml/raml.git\n $ cd raml\n $ go build\n $ go install\n $ go test\n\nUsage\n=====\n\nUsage is very simple:\n\n\tpackage main\n\t\n\timport (\n\t\t\"fmt\"\n\t\traml \"gopkg.in/raml.v0\"\n\t\t\"github.com/kr/pretty\"\n\t)\n\t\n\tfunc main() {\n\t\n\t\tfileName := \"./samples/congo/api.raml\"\n\t\n\t\tif apiDefinition, err := raml.ParseFile(fileName); err != nil {\n\t\t\tfmt.Printf(\"Failed parsing RAML file %s:\\n %s\", fileName, err.Error())\n\t\t} else {\n\t\t\tfmt.Printf(\"Successfully parsed RAML file %s!\\n\\n\", fileName)\n\t\t\tpretty.Printf(apiDefinition)\n\t\t}\n\t}\n\nGetting help\n============\n\n* Look up the [RAML 0.8](http://raml.org/spec.html) spec if in doubt\n* Contact Alon, the maintainer, directly: diamant.alon@gmail.com\n\nRoadmap\n=======\n\nTBD.\n\nReporting Bugs and Contributing Code\n====================================\n\n* Want to report a bug or request a feature? Please open [an issue](https://github.com/go-raml/raml/issues/new).\n* Want to contribute to **_raml_**? Fork the project and make a pull request. Cool cool cool.\n\n## License\n\nSee [LICENSE](https://github.com/go-raml/raml/blob/v0/LICENSE) file.\n" }, { "path": "errors.go", "content": "// Copyright 2014 DoAT. All rights reserved.\n//\n// Redistribution and use in source and binary forms, with or without modification,\n// are permitted provided that the following conditions are met:\n//\n// 1. Redistributions of source code must retain the above copyright notice,\n// this list of conditions and the following disclaimer.\n//\n// 2. Redistributions in binary form must reproduce the above copyright notice,\n// this list of conditions and the following disclaimer in the documentation and/or\n// other materials provided with the distribution.\n//\n// THIS SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTIES WHATSOEVER.\n// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\n// THE IMPLIED WARRANTIES OF NON INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n// PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL DoAT OR CONTRIBUTORS\n// BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n// // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\n// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n//\n// The views and conclusions contained in the software and documentation are those of\n// the authors and should not be interpreted as representing official policies,\n// either expressed or implied, of DoAT.\n\npackage raml\n\n// This file contains all code related to YAML and RAML errors.\n\nimport (\n\t\"fmt\"\n\t\"strings\"\n\n\tyaml \"github.com/advance512/yaml\"\n)\n\n// A RamlError is returned by the ParseFile function when RAML or YAML problems\n// are encountered when parsing the RAML document.\ntype RamlError struct {\n\tErrors []string\n}\n\nfunc (e *RamlError) Error() string {\n\treturn fmt.Sprintf(\"Error parsing RAML:\\n %s\\n\",\n\t\tstrings.Join(e.Errors, \"\\n \"))\n}\n\n// Populate the RAML error value with converted YAML error strings (with\n// additional context)\nfunc populateRAMLError(ramlError *RamlError,\n\tyamlErrors *yaml.TypeError) {\n\n\t// Go over the errors\n\tfor _, currErr := range yamlErrors.Errors {\n\n\t\t// Create the RAML errors\n\t\tramlError.Errors =\n\t\t\tappend(ramlError.Errors, convertYAMLError(currErr))\n\t}\n}\n\n// Convert a YAML error string into RAML error string, with more context\nfunc convertYAMLError(yamlError string) string {\n\n\tif strings.Contains(yamlError, \"cannot unmarshal\") {\n\n\t\tyamlErrorParts := strings.Split(yamlError, \" \")\n\n\t\tif len(yamlErrorParts) >= 7 {\n\n\t\t\tfmt.Println(yamlError)\n\n\t\t\tvar ok bool\n\t\t\tvar source string\n\t\t\tvar target string\n\t\t\tvar targetName string\n\t\t\tline := yamlErrorParts[1]\n\t\t\tline = line[:len(line)-1]\n\n\t\t\t// TODO: support more complex types:\n\t\t\t// map[string]raml.NamedParameter -->\n\t\t\t// detect map, format to:\n\t\t\t// \"mapping of %s to %s\", ramlTypeNames[\"string\"], ramlTypeNames[\"raml.NamedParameter\"]\n\t\t\t// if \"string\" is not found, use the key, i.e. \"string\" in this case.\n\t\t\t// so the output would be:\n\t\t\t// mapping of string to named parameter\n\n\t\t\t// TODO: instead of having string in the key of some mappings,\n\t\t\t// perhaps use a type alias:\n\t\t\t// type Name string\n\t\t\t// map[Name]NamedParameter\n\t\t\t// would output:\n\t\t\t// mapping of name string to named parameter\n\n\t\t\tif source, ok = yamlTypeToName[yamlErrorParts[4]]; !ok {\n\t\t\t\tsource = yamlErrorParts[4]\n\t\t\t}\n\t\t\tfmt.Println(\"source: \", source)\n\n\t\t\tif source == \"string\" {\n\t\t\t\tsource = fmt.Sprintf(\"string (got %s)\", yamlErrorParts[5])\n\t\t\t\ttarget = yamlErrorParts[7]\n\t\t\t} else {\n\t\t\t\ttarget = yamlErrorParts[6]\n\n\t\t\t}\n\t\t\tif targetName, ok = ramlTypeNames[target]; !ok {\n\t\t\t\ttargetName = target\n\t\t\t}\n\n\t\t\ttarget, _ = ramlTypes[target]\n\n\t\t\treturn fmt.Sprintf(\"line %s: %s cannot be of \"+\n\t\t\t\t\"type %s, must be %s\", line, targetName, source, target)\n\n\t\t}\n\t}\n\n\t// Otherwise\n\treturn fmt.Sprintf(\"YAML error, %s\", yamlError)\n}\n\nvar yamlTypeToName map[string]string = map[string]string{\n\t\"!!seq\": \"sequence\",\n\t\"!!map\": \"mapping\",\n\t\"!!int\": \"integer\",\n\t\"!!str\": \"string\",\n\t\"!!null\": \"null\",\n\t\"!!bool\": \"boolean\",\n\t\"!!float\": \"float\",\n\t\"!!timestamp\": \"timestamp\",\n\t\"!!binary\": \"binary\",\n\t\"!!merge\": \"merge\",\n}\n\nvar ramlTypeNames map[string]string = map[string]string{\n\t\"string\": \"string value\",\n\t\"int\": \"numeric value\",\n\t\"raml.NamedParameter\": \"named parameter\",\n\t\"raml.HTTPCode\": \"HTTP code\",\n\t\"raml.HTTPHeader\": \"HTTP header\",\n\t\"raml.Header\": \"header\",\n\t\"raml.Documentation\": \"documentation\",\n\t\"raml.Body\": \"body\",\n\t\"raml.Response\": \"response\",\n\t\"raml.DefinitionParameters\": \"definition parameters\",\n\t\"raml.DefinitionChoice\": \"definition choice\",\n\t\"raml.Trait\": \"trait\",\n\t\"raml.ResourceTypeMethod\": \"resource type method\",\n\t\"raml.ResourceType\": \"resource type\",\n\t\"raml.SecuritySchemeMethod\": \"security scheme method\",\n\t\"raml.SecurityScheme\": \"security scheme\",\n\t\"raml.Method\": \"method\",\n\t\"raml.Resource\": \"resource\",\n\t\"raml.APIDefinition\": \"API definition\",\n}\n\nvar ramlTypes map[string]string = map[string]string{\n\t\"string\": \"string\",\n\t\"int\": \"integer\",\n\t\"raml.NamedParameter\": \"mapping\",\n\t\"raml.HTTPCode\": \"integer\",\n\t\"raml.HTTPHeader\": \"string\",\n\t\"raml.Header\": \"mapping\",\n\t\"raml.Documentation\": \"mapping\",\n\t\"raml.Body\": \"mapping\",\n\t\"raml.Response\": \"mapping\",\n\t\"raml.DefinitionParameters\": \"mapping\",\n\t\"raml.DefinitionChoice\": \"string or mapping\",\n\t\"raml.Trait\": \"mapping\",\n\t\"raml.ResourceTypeMethod\": \"mapping\",\n\t\"raml.ResourceType\": \"mapping\",\n\t\"raml.SecuritySchemeMethod\": \"mapping\",\n\t\"raml.SecurityScheme\": \"mapping\",\n\t\"raml.Method\": \"mapping\",\n\t\"raml.Resource\": \"mapping\",\n\t\"raml.APIDefinition\": \"mapping\",\n}\n" }, { "path": "parser.go", "content": "// Copyright 2014 DoAT. All rights reserved.\n//\n// Redistribution and use in source and binary forms, with or without modification,\n// are permitted provided that the following conditions are met:\n//\n// 1. Redistributions of source code must retain the above copyright notice,\n// this list of conditions and the following disclaimer.\n//\n// 2. Redistributions in binary form must reproduce the above copyright notice,\n// this list of conditions and the following disclaimer in the documentation and/or\n// other materials provided with the distribution.\n//\n// THIS SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTIES WHATSOEVER.\n// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\n// THE IMPLIED WARRANTIES OF NON INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n// PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL DoAT OR CONTRIBUTORS\n// BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n// // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\n// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n//\n// The views and conclusions contained in the software and documentation are those of\n// the authors and should not be interpreted as representing official policies,\n// either expressed or implied, of DoAT.\n\npackage raml\n\n// This file contains all of the RAML parser related code.\n\nimport (\n\t\"bufio\"\n\t\"bytes\"\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n\t\"io/ioutil\"\n\t\"path/filepath\"\n\t\"strings\"\n\n\tyaml \"github.com/advance512/yaml\"\n)\n\n// Parse a RAML file. Returns a raml.APIDefinition value or an error if\n// everything is something went wrong.\n// This is the main entry point to the RAML parser.\nfunc ParseFile(filePath string) (*APIDefinition, error) {\n\n\t// Get the working directory\n\tworkingDirectory, fileName := filepath.Split(filePath)\n\n\t// Read original file contents into a byte array\n\tmainFileBytes, err := readFileContents(workingDirectory, fileName)\n\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\t// Get the contents of the main file\n\tmainFileBuffer := bytes.NewBuffer(mainFileBytes)\n\n\t// Verify the YAML version\n\tvar ramlVersion string\n\tif firstLine, err := mainFileBuffer.ReadString('\\n'); err != nil {\n\t\treturn nil, fmt.Errorf(\"Problem reading RAML file (Error: %s)\", err.Error())\n\t} else {\n\n\t\t// We read some data...\n\t\tif len(firstLine) >= 10 {\n\t\t\tramlVersion = firstLine[:10]\n\t\t}\n\n\t\t// TODO: Make this smart. We probably won't support multiple RAML\n\t\t// versions in the same package - we'll have different branches\n\t\t// for different versions. This one is hard-coded to 0.8.\n\t\t// Still, would be good to think about this.\n\t\tif ramlVersion != \"#%RAML 0.8\" {\n\t\t\treturn nil, errors.New(\"Input file is not a RAML 0.8 file. Make \" +\n\t\t\t\t\"sure the file starts with #%RAML 0.8\")\n\t\t}\n\t}\n\n\t// Pre-process the original file, following !include directive\n\tpreprocessedContentsBytes, err :=\n\t\tpreProcess(mainFileBuffer, workingDirectory)\n\n\tif err != nil {\n\t\treturn nil,\n\t\t\tfmt.Errorf(\"Error preprocessing RAML file (Error: %s)\", err.Error())\n\t}\n\n\t//pretty.Println(string(preprocessedContentsBytes))\n\n\t// Unmarshal into an APIDefinition value\n\tapiDefinition := new(APIDefinition)\n\tapiDefinition.RAMLVersion = ramlVersion\n\n\t// Go!\n\terr = yaml.Unmarshal(preprocessedContentsBytes, apiDefinition)\n\n\t// Any errors?\n\tif err != nil {\n\n\t\t// Create a RAML error value\n\t\tramlError := new(RamlError)\n\n\t\t// Copy the YAML errors into it..\n\t\tif yamlErrors, ok := err.(*yaml.TypeError); ok {\n\t\t\tpopulateRAMLError(ramlError, yamlErrors)\n\t\t} else {\n\t\t\t// Or just any other error, though this shouldn't happen.\n\t\t\tramlError.Errors = append(ramlError.Errors, err.Error())\n\t\t}\n\n\t\treturn nil, ramlError\n\t}\n\n\t// Good.\n\treturn apiDefinition, nil\n}\n\n// Reads the contents of a file, returns a bytes buffer\nfunc readFileContents(workingDirectory string, fileName string) ([]byte, error) {\n\n\tfilePath := filepath.Join(workingDirectory, fileName)\n\n\tif fileName == \"\" {\n\t\treturn nil, fmt.Errorf(\"File name cannot be nil: %s\", filePath)\n\t}\n\n\t// Read the file\n\tfileContentsArray, err := ioutil.ReadFile(filePath)\n\tif err != nil {\n\t\treturn nil,\n\t\t\tfmt.Errorf(\"Could not read file %s (Error: %s)\",\n\t\t\t\tfilePath, err.Error())\n\t}\n\n\treturn fileContentsArray, nil\n}\n\n// preProcess acts as a preprocessor for a RAML document in YAML format,\n// including files referenced via !include. It returns a pre-processed document.\nfunc preProcess(originalContents io.Reader, workingDirectory string) ([]byte, error) {\n\n\t// NOTE: Since YAML doesn't support !include directives, and since go-yaml\n\t// does NOT play nice with !include tags, this has to be done like this.\n\t// I am considering modifying go-yaml to add custom handlers for specific\n\t// tags, to add support for !include, but for now - this method is\n\t// GoodEnough(TM) and since it will only happen once, I am not prematurely\n\t// optimizing it.\n\n\tvar preprocessedContents bytes.Buffer\n\n\t// Go over each line, looking for !include tags\n\tscanner := bufio.NewScanner(originalContents)\n\tvar line string\n\n\t// Scan the file until we reach EOF or error out\n\tfor scanner.Scan() {\n\t\tline = scanner.Text()\n\n\t\t// Did we find an !include directive to handle?\n\t\tif idx := strings.Index(line, \"!include\"); idx != -1 {\n\n\t\t\t// TODO: Do this better\n\t\t\tincludeLength := len(\"!include \")\n\n\t\t\tincludedFile := line[idx+includeLength:]\n\n\t\t\tpreprocessedContents.Write([]byte(line[:idx]))\n\n\t\t\t// Get the included file contents\n\t\t\tincludedContents, err :=\n\t\t\t\treadFileContents(workingDirectory, includedFile)\n\n\t\t\tif err != nil {\n\t\t\t\treturn nil,\n\t\t\t\t\tfmt.Errorf(\"Error including file %s:\\n %s\",\n\t\t\t\t\t\tincludedFile, err.Error())\n\t\t\t}\n\n\t\t\t// TODO: Check that you only insert .yaml, .raml, .txt and .md files\n\t\t\t// In case of .raml or .yaml, remove the comments\n\t\t\t// In case of other files, Base64 them first.\n\n\t\t\t// TODO: Better, step by step checks .. though prolly it'll panic\n\t\t\t// Write text files in the same indentation as the first line\n\t\t\tinternalScanner :=\n\t\t\t\tbufio.NewScanner(bytes.NewBuffer(includedContents))\n\n\t\t\t// Indent by this much\n\t\t\tfirstLine := true\n\t\t\tindentationString := \"\"\n\n\t\t\t// Go over each line, write it\n\t\t\tfor internalScanner.Scan() {\n\t\t\t\tinternalLine := internalScanner.Text()\n\n\t\t\t\tpreprocessedContents.WriteString(indentationString)\n\t\t\t\tif firstLine {\n\t\t\t\t\tindentationString = strings.Repeat(\" \", idx)\n\t\t\t\t\tfirstLine = false\n\t\t\t\t}\n\n\t\t\t\tpreprocessedContents.WriteString(internalLine)\n\t\t\t\tpreprocessedContents.WriteByte('\\n')\n\t\t\t}\n\n\t\t} else {\n\n\t\t\t// No, just a simple line.. write it\n\t\t\tpreprocessedContents.WriteString(line)\n\t\t\tpreprocessedContents.WriteByte('\\n')\n\t\t}\n\t}\n\n\t// Any errors encountered?\n\tif err := scanner.Err(); err != nil {\n\t\treturn nil, fmt.Errorf(\"Error reading YAML file: %s\", err.Error())\n\t}\n\n\t// Return the preprocessed contents\n\treturn preprocessedContents.Bytes(), nil\n}\n" }, { "path": "raml_test.go", "content": "// Copyright 2014 DoAT. All rights reserved.\n//\n// Redistribution and use in source and binary forms, with or without modification,\n// are permitted provided that the following conditions are met:\n//\n// 1. Redistributions of source code must retain the above copyright notice,\n// this list of conditions and the following disclaimer.\n//\n// 2. Redistributions in binary form must reproduce the above copyright notice,\n// this list of conditions and the following disclaimer in the documentation and/or\n// other materials provided with the distribution.\n//\n// THIS SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTIES WHATSOEVER.\n// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\n// THE IMPLIED WARRANTIES OF NON INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n// PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL DoAT OR CONTRIBUTORS\n// BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n// // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\n// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n//\n// The views and conclusions contained in the software and documentation are those of\n// the authors and should not be interpreted as representing official policies,\n// either expressed or implied, of DoAT.\n\npackage raml\n\n// This file contains tests.\n\nimport (\n\t\"fmt\"\n\t\"testing\"\n)\n\n// TODO: Way, way more serious tests.\n//\n// Inspirations:\n// \t \thttps://github.com/raml-org/raml-js-parser/tree/master/test\n//\t\thttps://github.com/raml-org/raml-java-parser/tree/master/src/test\n// \t\thttps://github.com/an2deg/pyraml-parser/tree/master/tests\n//\t\thttps://github.com/cybertk/ramlev/tree/master/test/fixtures\n\nfunc TestFailedParsing(t *testing.T) {\n\n\tfileNames := []string{\"./samples/bad_raml.raml\"}\n\n\tfor _, fileName := range fileNames {\n\n\t\tfmt.Printf(\"Attempting to parse RAML file: %s\\n\", fileName)\n\n\t\t_, err := ParseFile(fileName)\n\n\t\tif err == nil {\n\t\t\tt.Fatalf(\"Failed detecting bad RAML file %s\", fileName)\n\t\t} else {\n\t\t\tfmt.Printf(\"Detected bad RAML file %s:\\n%s\", fileName, err.Error())\n\t\t}\n\t}\n}\n\nfunc TestParsing(t *testing.T) {\n\n\tfileNames := []string{\"./samples/example.raml\",\n\t\t\"./samples/simple_example.raml\",\n\t\t\"./samples/other_example.raml\",\n\t\t\"./samples/congo/api.raml\",\n\t\t\"./samples/notes/api.raml\",\n\t\t\"./samples/github/github-api-v3.raml\",\n\t\t\"./samples/raml-tutorial-200/jukebox-api.raml\"}\n\n\tfor _, fileName := range fileNames {\n\n\t\tfmt.Printf(\"Attempting to parse RAML file: %s\\n\", fileName)\n\n\t\tapiDefinition, err := ParseFile(fileName)\n\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"Failed parsing file %s:\\n %s\", fileName, err.Error())\n\t\t} else {\n\t\t\tfmt.Printf(\"Successfully parsed file %s!\\n\", fileName)\n\t\t}\n\n\t\tif apiDefinition.RAMLVersion != \"#%RAML 0.8\" {\n\t\t\tt.Fatalf(\"Detected erroneous RAML version: %s\",\n\t\t\t\tapiDefinition.RAMLVersion)\n\t\t}\n\n\t\t// \tpretty.Println(apiDefinition)\n\t}\n}\n" }, { "path": "samples/bad_raml.raml", "content": "#%RAML 0.8\ntitle: Notes Example API\n/jobs:\n displayName: Jobs\n post:\n description: Create a job\n/projects:\n displayName: Projects\n post:\n description: Create a project\n/resources:\n displayName: Resources\n type:\n searchableCollection:\n queryParamName: title\n fallbackParamName: digest_all_fields\n get:\n description: Get a resource\n is:\n - secured:\n tokenName: access_token\n paged:\n maxPages: 10\n post:\n description: Post a resource\n /{resourceId}:\n get:\n description: Get a resource ID\n put:\n description: Put resource ID\n delete:\n description: Delete a resource ID\n /yet_another:\n get:\n description: Yet another\nuriParameters:\n communityDomain:\n displayName: Community Domain\n type: string\n communityPath:\n displayName: Community Path\n type: string\n pattern: ^[a-zA-Z0-9][-a-zA-Z0-9]*$\n minLength: \"hello\"\nbaseUri: /lala\nprotocols: [HTTP, HTTPS]\ntraits:\n - secured:\n queryParameters:\n <>:\n description: A valid <> is required\n paged:\n queryParameters:\n numPages:\n description: The number of pages to return, not to exceed <>\nresourceTypes:\n - rttest:\n description: test\n - one:\n description: hi\n - auditableResource:\n post?:\n body:\n application/x-www-form-urlencoded:\n formParameters:\n createAuthority:\n description: |\n If the resource has a post method defined, expect a createAuthority\n property in its body\n delete?:\n body:\n multipart/form-data:\n formParameters:\n deleteAuthority:\n description: |\n If the resource has a delete method defined, expect a deleteAuthority\n property in its body\n - searchableCollection:\n get:\n queryParameters:\n <>:\n description: Return <> that have their <> matching the given value\n <>:\n description: If no values match the value given for <>, use <> instead\nsecuritySchemes:\n - oauth_2_0:\n description: |\n Dropbox supports OAuth 2.0 for authenticating all API requests.\n type: OAuth 2.0\n describedBy:\n headers:\n Authorization:\n description: |\n Used to send a valid OAuth 2 access token. Do not use\n with the \"access_token\" query string parameter.\n type: string\n queryParameters:\n access_token:\n description: |\n Used to send a valid OAuth 2 access token. Do not use together with\n the \"Authorization\" header\n type: string\n responses:\n 401:\n description: |\n Bad or expired token. This can happen if the user or Dropbox\n revoked or expired an access token. To fix, you should re-\n authenticate the user.\n 403:\n description: |\n Bad OAuth request (wrong consumer key, bad nonce, expired\n timestamp...). Unfortunately, re-authenticating the user won't help here.\n settings:\n authorizationUri: https://www.dropbox.com/1/oauth2/authorize\n accessTokenUri: https://api.dropbox.com/1/oauth2/token\n authorizationGrants: [ code, token ]\n - oauth_1_0:\n description: |\n OAuth 1.0 continues to be supported for all API requests, but OAuth 2.0 is now preferred.\n type: OAuth 1.0\n settings:\n requestTokenUri: https://api.dropbox.com/1/oauth/request_token\n authorizationUri: https://www.dropbox.com/1/oauth/authorize\n tokenCredentialsUri: https://api.dropbox.com/1/oauth/access_token\n - customHeader:\n description: |\n A custom\n" }, { "path": "samples/congo/api.raml", "content": "#%RAML 0.8\ntitle: Congo API For Drone Deliveries\nmediaType: application/json\n/deliveries:\n get:\n description: Get a list of deliveries\n queryParameters:\n sinceDate:\n type: date\n example: Mon, 14 Jul 2014 07:00:00 GMT\n throughDate:\n type: date\n example: Mon, 18 Jul 2014 07:00:00 GMT\n responses:\n 200:\n body:\n example: |\n [\n {\n \"id\": \"4\",\n \"at\": \"Tue, 08 Jul 2014 13:00:00 GMT\",\n \"toAddressId\": \"gi6w4fgi\",\n \"orderItemId\": \"6782798\",\n \"status\": \"completed\",\n \"droneId\": \"f\"\n },\n {\n \"id\": \"137\",\n \"at\": \"Sun, 20 Jul 2014 19:36:00 GMT\",\n \"toAddressId\": \"6tg23d6i\",\n \"orderItemId\": \"7626827\",\n \"status\": \"scheduled\",\n \"droneId\": \"a\"\n },\n {\n \"id\": \"8\",\n \"at\": \"Sun, 20 Jul 2014 21:20:00 GMT\",\n \"toAddressId\": \"gi6w4fgi\",\n \"orderItemId\": \"9877292\",\n \"status\": \"scheduled\",\n \"droneId\": \"f\"\n }\n ]\n post:\n description: Create/request a new delivery\n body:\n example: |\n {\n \"at\": \"Sun, 20 Jul 2014 21:20:00 GMT\",\n \"toAddressId\": \"273hh79\",\n \"orderItemId\": \"736786\"\n }\n responses:\n 201:\n headers:\n Location:\n body:\n example: |\n {\n \"id\": \"987\",\n \"at\": \"Sun, 20 Jul 2014 21:20:00 GMT\",\n \"toAddressId\": \"273hh79\",\n \"orderItemId\": \"736786\",\n \"status\": \"scheduled\",\n \"droneId\": \"f\"\n }\n /{deliveryId}:\n get:\n description: Get information on a specific delivery\n responses:\n 200:\n body:\n example: |\n {\n \"id\": \"8\",\n \"at\": \"Sun, 20 Jul 2014 21:20:00 GMT\",\n \"toAddressId\": \"gi6w4fgi\",\n \"orderItemId\": \"736786\",\n \"status\": \"scheduled\",\n \"droneId\": \"f\"\n }\n patch:\n description: Update the information on a specific delivery\n body:\n example: |\n {\n \"at\": \"Mon, 21 Jul 2014 00:00:00 GMT\"\n }\n responses:\n 200:\n body:\n example: |\n {\n \"id\": \"8\",\n \"at\": \"Mon, 21 Jul 2014 00:00:00 GMT\",\n \"toAddressId\": \"gi6w4fgi\",\n \"orderItemId\": \"736786\",\n \"status\": \"scheduled\",\n \"droneId\": \"f\"\n }\n delete:\n description: Cancel a specific delivery\n responses:\n 204:\n/drones:\n get:\n description: Get a list of drones\n queryParameters:\n atLatitude:\n description: Latitude in decimal degrees\n type: number\n example: 37.8\n atLongitude:\n description: Longitude in decimal degrees\n type: number\n example: -122.3\n atAltitude:\n description: Altitude in meters above the [ellipsoid](http://www.w3.org/TR/geolocation-API/#ref-wgs)\n type: number\n example: 0\n atRange:\n description: Maximum distance from location, in meters\n type: number\n example: 50\n default: 100\n responses:\n 200:\n body:\n example: |\n [\n {\n \"id\": \"a\",\n \"latitude\": 37.787862,\n \"longitude\": -122.404694,\n \"altitude\": 28.3,\n \"name\": \"High Flyer\"\n },\n {\n \"id\": \"f\",\n \"latitude\": 37.852519,\n \"longitude\": -122.237390,\n \"altitude\": 56.9,\n \"name\": \"Camelot\"\n }\n ]\n post:\n description: Add a new drone to the fleet\n body:\n example: |\n {\n \"name\": \"Lancelot\"\n }\n /{droneId}:\n get:\n description: Get information on a specific drone\n responses:\n 200:\n body:\n example: |\n {\n \"id\": \"f\",\n \"latitude\": 37.852519,\n \"longitude\": -122.237390,\n \"altitude\": 56.9,\n \"name\": \"Camelot\"\n }\n patch:\n description: Update the information on a specific drone\n body:\n example: |\n {\n \"name\": \"Arthur\"\n }\n responses:\n 200:\n body:\n example: |\n {\n \"id\": \"f\",\n \"latitude\": 37.852519,\n \"longitude\": -122.237390,\n \"altitude\": 56.9,\n \"name\": \"Arthur\"\n }\n delete:\n description: Remove a drone from the fleet\n responses:\n 204:\n /deliveries:\n get:\n description: The deliveries scheduled for the current drone\n responses:\n 200:\n body:\n example: |\n [\n {\n \"id\": \"8\",\n \"at\": \"Sun, 20 Jul 2014 21:20:00 GMT\",\n \"toAddressId\": \"gi6w4fgi\",\n \"orderItemId\": \"736786\",\n \"status\": \"scheduled\",\n \"droneId\": \"f\"\n }\n ]\n" }, { "path": "samples/example.raml", "content": "#%RAML 0.8\n---\ntitle: Example API\nbaseUri: http://example.com\nsecuritySchemes:\n - basic:\n type: Basic Authentication\ntraits:\n - secured:\n description: Some requests require authentication\n - unsecured:\n description: This is not secured\n - catpictures:\n description: requires cat headers\n - anotherTrait: {}\n - andAnotherTrait: {}\n - andYetAnotherTrait: {}\n - aFinalTrait: {}\n - someParameterizedTrait:\n description: <>\nresourceTypes:\n - collection:\n description: bunk\ndocumentation:\n - title: Getting Started\n content: |\n # Header\n Content\n ## Subheader\n **Bolded content**\n/resource:\n displayName: First One\n is:\n [ secured ]\n options:\n connect:\n trace:\n patch:\n delete:\n put:\n get:\n description: get the first one\n headers:\n x-custom:\n /{resourceId}:\n description: This is a resource description *with* some _markdown_ embedded in it\n uriParameters:\n resourceId:\n required: true\n description: Which resoure would you like to view\n get:\n description: |\n Instagram’s API uses the [OAuth 2.0 protocol](http://tools.ietf.org/html/draft-ietf-oauth-v2-12) for simple, but effective authentication and authorization. OAuth 2.0 is much easier to use than previous schemes; developers can start using the Instagram API almost immediately. The one thing to keep in mind is that all requests to the API must be made over SSL (https:// not http://)\n\n ## Do you need to authenticate?\n\n For the most part, Instagram’s API only requires the use of a _client_id). A client_id simply associates your server, script, or program with a specific application. However, some requests require authentication - specifically requests made on behalf of a user. Authenticated requests require an _access_token_. These tokens are unique to a user and should be stored securely. Access tokens may expire at any time in the future.\n\n Note that in many situations, you may not need to authenticate users at all. For instance, you may request popular photos without authenticating (i.e. you do not need to provide an access_token; just use your client ID with your request). We only require authentication in cases where your application is making requests on behalf of a user (commenting, liking, browsing a user’s feed, etc.).\n\n ## Receiving an access_token\n queryParameters:\n filter:\n description: What to filter\n type: string\n post:\n body:\n application/json:\n application/x-www-form-urlencoded:\n formParameters:\n name:\n description: The name of the resource to create\n type: string\n example: Comment\n description:\n description: A description of the resource to create\n type: string\n example: User-generated content pertinent to the associated blog post\n multipart/form-data:\n formParameters:\n name:\n description: The name of the resource to create\n type: string\n example: Comment\n description:\n description: A description of the resource to create\n type: string\n example: User-generated content pertinent to the associated blog post\n\n/another/resource:\n displayName: Cats\n type: collection\n is: [secured, catpictures]\n connect: !!null\n head: !!null\n get:\n queryParameters:\n chunk:\n displayName: page\n description: Which page to display\n type: integer\n example: 1\n minimum: 1\n maximum: 100\n required: true\n order:\n description: The sort order of resources\n type: string\n enum: [\"oldest\", \"newest\"]\n example: oldest\n minLength: 5\n maxLength: 7\n default: newest\n query:\n description: A query parameter\n repeat: true\n\n/resource-with-headers:\n displayName: Resource With headers\n get:\n headers:\n x-custom-header:\n displayName: Custom header\n description: This header is used to send data that...\n type: string\n pattern: ^\\w+$\n x-p-{*}:\n displayName: Parameterized header\n\n/secured-resource:\n displayName: SO SECURE\n get:\n securedBy: [basic]\n/resource-with-method-level-traits:\n displayName: First One\n is: [secured]\n get:\n is: [unsecured, catpictures, anotherTrait, andAnotherTrait, andYetAnotherTrait, aFinalTrait, someParameterizedTrait: { someParameterName: someParameterValue }, otherParameterizedTrait : {asd: 123}]\n description: get the first one\n\n/resource-with-form-and-multipart-form-parameters:\n get:\n queryParameters:\n some_query_param:\n displayName: Some Query Param\n description: Your value for some thing.\n type: string\n required: true\n example: \"my value\"\n body:\n application/json:\n example: |\n {\n \"api_key\": \"c4f820f0420a013ea143230c290fbf99\",\n ...\n }\n application/x-www-form-urlencoded:\n formParameters:\n api_key:\n displayName: API Key\n description: Your license key for the application. Please contact developer@nzpost.co.nz for a license key\n type: string\n required: true\n example: \"c4f820f0420a013ea143230c290fbf99\"\n multipart/form-data:\n formParameters:\n api_key:\n displayName: API Key\n description: Your license key for the application. Please contact developer@nzpost.co.nz for a license key\n type: string\n required: true\n example: \"c4f820f0420a013ea143230c290fbf99\"\n" }, { "path": "samples/github/github-api-v3.raml", "content": "#%RAML 0.8\n---\ntitle: GitHub API\nversion: v3\nbaseUri: https://api.github.com/\nsecuritySchemes:\n - oauth_2_0:\n description: |\n OAuth2 is a protocol that lets external apps request authorization to private\n details in a user's GitHub account without getting their password. This is\n preferred over Basic Authentication because tokens can be limited to specific\n types of data, and can be revoked by users at any time.\n type: OAuth 2.0\n describedBy:\n headers:\n Authorization:\n description: |\n Used to send a valid OAuth 2 access token. Do not use together with\n the \"access_token\" query string parameter.\n type: string\n queryParameters:\n access_token:\n description: |\n Used to send a valid OAuth 2 access token. Do not use together with\n the \"Authorization\" header\n type: string\n responses:\n 404:\n description: Unauthorized\n settings:\n authorizationUri: https://github.com/login/oauth/authorize\n accessTokenUri: https://github.com/login/oauth/access_token\n authorizationGrants: [ code ]\n scopes:\n - \"user\"\n - \"user:email\"\n - \"user:follow\"\n - \"public_repo\"\n - \"repo\"\n - \"repo:status\"\n - \"delete_repo\"\n - \"notifications\"\n - \"gist\"\nsecuredBy: [ oauth_2_0 ]\nmediaType: application/json\nresourceTypes:\n - base:\n get?: &common\n headers:\n X-GitHub-Media-Type:\n description: |\n You can check the current version of media type in responses.\n type: string\n Accept:\n description: Is used to set specified media type.\n type: string\n X-RateLimit-Limit:\n type: integer\n X-RateLimit-Remaining:\n type: integer\n X-RateLimit-Reset:\n type: integer\n X-GitHub-Request-Id:\n type: integer\n responses:\n 403:\n description: |\n API rate limit exceeded. See http://developer.github.com/v3/#rate-limiting\n for details.\n post?: *common\n patch?: *common\n put?: *common\n delete?: *common\n - item:\n type: base\n get?:\n post?:\n patch?:\n put?:\n delete?:\n responses:\n 204:\n description: Item removed.\n - collection:\n type: base\n get?:\n post?:\ntraits:\n - historical:\n queryParameters:\n since:\n description: |\n Timestamp in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.\n Only gists updated at or after this time are returned.\n type: string\n - filterable:\n queryParameters:\n filter:\n description: |\n Issues assigned to you / created by you / mentioning you / you're\n subscribed to updates for / All issues the authenticated user can see\n enum:\n - assigned\n - created\n - mentioned\n - subscribed\n - all\n default: all\n required: true\n state:\n enum:\n - open\n - closed\n default: open\n required: true\n labels:\n description: String list of comma separated Label names. Example - bug,ui,@high.\n type: string\n required: true\n sort:\n enum:\n - created\n - updated\n - comments\n default: created\n required: true\n direction:\n enum:\n - asc\n - desc\n default: desc\n required: true\n since:\n description: |\n Optional string of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\n Only issues updated at or after this time are returned.\n type: string\n# Search\n/search:\n /repositories:\n type: collection\n get:\n description: Search repositories.\n queryParameters:\n q:\n description: |\n The search terms. This can be any combination of the supported repository\n search parameters:\n 'Search In' Qualifies which fields are searched. With this qualifier you\n can restrict the search to just the repository name, description, readme,\n or any combination of these.\n 'Size' Finds repositories that match a certain size (in kilobytes).\n 'Forks' Filters repositories based on the number of forks, and/or whether\n forked repositories should be included in the results at all.\n 'Created' and 'Last Updated' Filters repositories based on times of\n creation, or when they were last updated.\n 'Users or Repositories' Limits searches to a specific user or repository.\n 'Languages' Searches repositories based on the language they're written in.\n 'Stars' Searches repositories based on the number of stars.\n type: string\n required: true\n sort:\n description: If not provided, results are sorted by best match.\n enum:\n - stars\n - forks\n - updated\n order:\n enum:\n - asc\n - desc\n default: desc\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"total_count\": {\n \"type\": \"integer\"\n },\n \"items\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"received_events_url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"default_branch\": {\n \"type\": \"string\"\n },\n \"score\": {\n \"type\": \"number\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"total_count\": 40,\n \"items\": [\n {\n \"id\": 3081286,\n \"name\": \"Tetris\",\n \"full_name\": \"dtrupenn/Tetris\",\n \"owner\": {\n \"login\": \"dtrupenn\",\n \"id\": 872147,\n \"avatar_url\": \"https://secure.gravatar.com/avatar/e7956084e75f239de85d3a31bc172ace?d=https://a248.e.akamai.net/assets.github.com/images/gravatars/gravatar-user-420.png\",\n \"gravatar_id\": \"e7956084e75f239de85d3a31bc172ace\",\n \"url\": \"https://api.github.com/users/dtrupenn\",\n \"received_events_url\": \"https://api.github.com/users/dtrupenn/received_events\",\n \"type\": \"User\"\n },\n \"private\": false,\n \"html_url\": \"https://github.com/dtrupenn/Tetris\",\n \"description\": \"A C implementation of Tetris using Pennsim through LC4\",\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/dtrupenn/Tetris\",\n \"created_at\": \"2012-01-01T00:31:50Z\",\n \"updated_at\": \"2013-01-05T17:58:47Z\",\n \"pushed_at\": \"2012-01-01T00:37:02Z\",\n \"homepage\": \"\",\n \"size\": 524,\n \"watchers_count\": 1,\n \"language\": \"Assembly\",\n \"forks_count\": 0,\n \"open_issues_count\": 0,\n \"forks\": 0,\n \"open_issues\": 0,\n \"watchers\": 1,\n \"master_branch\": \"master\",\n \"default_branch\": \"master\",\n \"score\": 10.309712\n }\n ]\n }\n /code:\n type: collection\n get:\n description: Search code.\n queryParameters:\n q:\n description: |\n The search terms. This can be any combination of the supported code\n search parameters:\n 'Search In' Qualifies which fields are searched. With this qualifier\n you can restrict the search to just the file contents, the file path,\n or both.\n 'Languages' Searches code based on the language it's written in.\n 'Forks' Filters repositories based on the number of forks, and/or\n whether code from forked repositories should be included in the results\n at all.\n 'Size' Finds files that match a certain size (in bytes).\n 'Path' Specifies the path that the resulting file must be at.\n 'Extension' Matches files with a certain extension.\n 'Users' or 'Repositories' Limits searches to a specific user or repository.\n type: string\n required: true\n sort:\n description: |\n Can only be 'indexed', which indicates how recently a file has been indexed\n by the GitHub search infrastructure. If not provided, results are sorted\n by best match.\n enum:\n - indexed\n order:\n enum:\n - asc\n - desc\n default: desc\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"total_count\": {\n \"type\": \"integer\"\n },\n \"items\": [\n {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"repository\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"followers_url\": {\n \"type\": \"string\"\n },\n \"following_url\": {\n \"type\": \"string\"\n },\n \"gists_url\": {\n \"type\": \"string\"\n },\n \"starred_url\": {\n \"type\": \"string\"\n },\n \"subscriptions_url\": {\n \"type\": \"string\"\n },\n \"organizations_url\": {\n \"type\": \"string\"\n },\n \"repos_url\": {\n \"type\": \"string\"\n },\n \"events_url\": {\n \"type\": \"string\"\n },\n \"received_events_url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"forks_url\": {\n \"type\": \"string\"\n },\n \"keys_url\": {\n \"type\": \"string\"\n },\n \"collaborators_url\": {\n \"type\": \"string\"\n },\n \"teams_url\": {\n \"type\": \"string\"\n },\n \"hooks_url\": {\n \"type\": \"string\"\n },\n \"issue_events_url\": {\n \"type\": \"string\"\n },\n \"events_url\": {\n \"type\": \"string\"\n },\n \"assignees_url\": {\n \"type\": \"string\"\n },\n \"branches_url\": {\n \"type\": \"string\"\n },\n \"tags_url\": {\n \"type\": \"string\"\n },\n \"blobs_url\": {\n \"type\": \"string\"\n },\n \"git_tags_url\": {\n \"type\": \"string\"\n },\n \"git_refs_url\": {\n \"type\": \"string\"\n },\n \"trees_url\": {\n \"type\": \"string\"\n },\n \"statuses_url\": {\n \"type\": \"string\"\n },\n \"languages_url\": {\n \"type\": \"string\"\n },\n \"stargazers_url\": {\n \"type\": \"string\"\n },\n \"contributors_url\": {\n \"type\": \"string\"\n },\n \"subscribers_url\": {\n \"type\": \"string\"\n },\n \"subscription_url\": {\n \"type\": \"string\"\n },\n \"commits_url\": {\n \"type\": \"string\"\n },\n \"git_commits_url\": {\n \"type\": \"string\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"issue_comment_url\": {\n \"type\": \"string\"\n },\n \"contents_url\": {\n \"type\": \"string\"\n },\n \"compare_url\": {\n \"type\": \"string\"\n },\n \"merges_url\": {\n \"type\": \"string\"\n },\n \"archive_url\": {\n \"type\": \"string\"\n },\n \"downloads_url\": {\n \"type\": \"string\"\n },\n \"issues_url\": {\n \"type\": \"string\"\n },\n \"pulls_url\": {\n \"type\": \"string\"\n },\n \"milestones_url\": {\n \"type\": \"string\"\n },\n \"notifications_url\": {\n \"type\": \"string\"\n },\n \"labels_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"score\": {\n \"type\": \"number\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"total_count\": 104,\n \"items\": [\n {\n \"name\": \"github-issue-importer.gemspec\",\n \"path\": \"github-issue-importer.gemspec\",\n \"sha\": \"394508202991504d8a0771ae027454facaaa045a\",\n \"url\": \"https://api.github.com/repositories/1586630/contents/github-issue-importer.gemspec?ref=aa22a4be513163c73531e96bd99f4b49d6ded8a6\",\n \"git_url\": \"https://api.github.com/repositories/1586630/git/blobs/394508202991504d8a0771ae027454facaaa045a\",\n \"html_url\": \"https://github.com/johnf/github-issue-importer/blob/aa22a4be513163c73531e96bd99f4b49d6ded8a6/github-issue-importer.gemspec\",\n \"repository\": {\n \"id\": 1586630,\n \"name\": \"github-issue-importer\",\n \"full_name\": \"johnf/github-issue-importer\",\n \"owner\": {\n \"login\": \"johnf\",\n \"id\": 42590,\n \"avatar_url\": \"https://secure.gravatar.com/avatar/ab4d879ba3233a270aa14f447c795505?d=https://a248.e.akamai.net/assets.github.com/images/gravatars/gravatar-user-420.png\",\n \"gravatar_id\": \"ab4d879ba3233a270aa14f447c795505\",\n \"url\": \"https://api.github.com/users/johnf\",\n \"html_url\": \"https://github.com/johnf\",\n \"followers_url\": \"https://api.github.com/users/johnf/followers\",\n \"following_url\": \"https://api.github.com/users/johnf/following{/other_user}\",\n \"gists_url\": \"https://api.github.com/users/johnf/gists{/gist_id}\",\n \"starred_url\": \"https://api.github.com/users/johnf/starred{/owner}{/repo}\",\n \"subscriptions_url\": \"https://api.github.com/users/johnf/subscriptions\",\n \"organizations_url\": \"https://api.github.com/users/johnf/orgs\",\n \"repos_url\": \"https://api.github.com/users/johnf/repos\",\n \"events_url\": \"https://api.github.com/users/johnf/events{/privacy}\",\n \"received_events_url\": \"https://api.github.com/users/johnf/received_events\",\n \"type\": \"User\"\n },\n \"private\": false,\n \"html_url\": \"https://github.com/johnf/github-issue-importer\",\n \"description\": \"Import Issues from Launchpad (for now) into github\",\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/johnf/github-issue-importer\",\n \"forks_url\": \"https://api.github.com/repos/johnf/github-issue-importer/forks\",\n \"keys_url\": \"https://api.github.com/repos/johnf/github-issue-importer/keys{/key_id}\",\n \"collaborators_url\": \"https://api.github.com/repos/johnf/github-issue-importer/collaborators{/collaborator}\",\n \"teams_url\": \"https://api.github.com/repos/johnf/github-issue-importer/teams\",\n \"hooks_url\": \"https://api.github.com/repos/johnf/github-issue-importer/hooks\",\n \"issue_events_url\": \"https://api.github.com/repos/johnf/github-issue-importer/issues/events{/number}\",\n \"events_url\": \"https://api.github.com/repos/johnf/github-issue-importer/events\",\n \"assignees_url\": \"https://api.github.com/repos/johnf/github-issue-importer/assignees{/user}\",\n \"branches_url\": \"https://api.github.com/repos/johnf/github-issue-importer/branches{/branch}\",\n \"tags_url\": \"https://api.github.com/repos/johnf/github-issue-importer/tags\",\n \"blobs_url\": \"https://api.github.com/repos/johnf/github-issue-importer/git/blobs{/sha}\",\n \"git_tags_url\": \"https://api.github.com/repos/johnf/github-issue-importer/git/tags{/sha}\",\n \"git_refs_url\": \"https://api.github.com/repos/johnf/github-issue-importer/git/refs{/sha}\",\n \"trees_url\": \"https://api.github.com/repos/johnf/github-issue-importer/git/trees{/sha}\",\n \"statuses_url\": \"https://api.github.com/repos/johnf/github-issue-importer/statuses/{sha}\",\n \"languages_url\": \"https://api.github.com/repos/johnf/github-issue-importer/languages\",\n \"stargazers_url\": \"https://api.github.com/repos/johnf/github-issue-importer/stargazers\",\n \"contributors_url\": \"https://api.github.com/repos/johnf/github-issue-importer/contributors\",\n \"subscribers_url\": \"https://api.github.com/repos/johnf/github-issue-importer/subscribers\",\n \"subscription_url\": \"https://api.github.com/repos/johnf/github-issue-importer/subscription\",\n \"commits_url\": \"https://api.github.com/repos/johnf/github-issue-importer/commits{/sha}\",\n \"git_commits_url\": \"https://api.github.com/repos/johnf/github-issue-importer/git/commits{/sha}\",\n \"comments_url\": \"https://api.github.com/repos/johnf/github-issue-importer/comments{/number}\",\n \"issue_comment_url\": \"https://api.github.com/repos/johnf/github-issue-importer/issues/comments/{number}\",\n \"contents_url\": \"https://api.github.com/repos/johnf/github-issue-importer/contents/{ path}\",\n \"compare_url\": \"https://api.github.com/repos/johnf/github-issue-importer/compare/{base}...{head}\",\n \"merges_url\": \"https://api.github.com/repos/johnf/github-issue-importer/merges\",\n \"archive_url\": \"https://api.github.com/repos/johnf/github-issue-importer/{archive_format}{/ref}\",\n \"downloads_url\": \"https://api.github.com/repos/johnf/github-issue-importer/downloads\",\n \"issues_url\": \"https://api.github.com/repos/johnf/github-issue-importer/issues{/number}\",\n \"pulls_url\": \"https://api.github.com/repos/johnf/github-issue-importer/pulls{/number}\",\n \"milestones_url\": \"https://api.github.com/repos/johnf/github-issue-importer/milestones{/number}\",\n \"notifications_url\": \"https://api.github.com/repos/johnf/github-issue-importer/notifications{?since,all,participating}\",\n \"labels_url\": \"https://api.github.com/repos/johnf/github-issue-importer/labels{/name}\"\n },\n \"score\": 0.96691436\n }\n ]\n }\n /users:\n type: collection\n get:\n description: Search users.\n queryParameters:\n q:\n description: |\n The search terms. This can be any combination of the supported user\n search parameters:\n 'Search In' Qualifies which fields are searched. With this qualifier you\n can restrict the search to just the username, public email, full name,\n location, or any combination of these.\n 'Repository count' Filters users based on the number of repositories they\n have.\n 'Location' Filter users by the location indicated in their profile.\n 'Language' Search for users that have repositories that match a certain\n language.\n 'Created' Filter users based on when they joined.\n 'Followers' Filter users based on the number of followers they have.\n type: string\n required: true\n sort:\n description: If not provided, results are sorted by best match.\n enum:\n - followers\n - repositories\n - joined\n order:\n enum:\n - asc\n - desc\n default: desc\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"total_count\": {\n \"type\": \"integer\"\n },\n \"items\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"followers_url\": {\n \"type\": \"string\"\n },\n \"subscriptions_url\": {\n \"type\": \"string\"\n },\n \"organizations_url\": {\n \"type\": \"string\"\n },\n \"repos_url\": {\n \"type\": \"string\"\n },\n \"received_events_url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n },\n \"score\": {\n \"type\": \"number\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"total_count\": 12,\n \"items\": [\n {\n \"login\": \"mojombo\",\n \"id\": 1,\n \"avatar_url\": \"https://secure.gravatar.com/avatar/25c7c18223fb42a4c6ae1c8db6f50f9b?d=https://a248.e.akamai.net/assets.github.com/images/gravatars/gravatar-user-420.png\",\n \"gravatar_id\": \"25c7c18223fb42a4c6ae1c8db6f50f9b\",\n \"url\": \"https://api.github.com/users/mojombo\",\n \"html_url\": \"https://github.com/mojombo\",\n \"followers_url\": \"https://api.github.com/users/mojombo/followers\",\n \"subscriptions_url\": \"https://api.github.com/users/mojombo/subscriptions\",\n \"organizations_url\": \"https://api.github.com/users/mojombo/orgs\",\n \"repos_url\": \"https://api.github.com/users/mojombo/repos\",\n \"received_events_url\": \"https://api.github.com/users/mojombo/received_events\",\n \"type\": \"User\",\n \"score\": 105.47857\n }\n ]\n }\n# Events\n/events:\n type: collection\n get:\n description: List public events.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n# Feeds\n/feeds:\n type: collection\n get:\n description: |\n List Feeds.\n GitHub provides several timeline resources in Atom format. The Feeds API\n lists all the feeds available to the authenticating user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"timeline_url\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"user_url\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"current_user_public\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"current_user_url\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"current_user_actor_url\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"current_user_organization_url\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"_links\": {\n \t\t\"properties\": {\n \t\t\t\"timeline\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"href\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"user\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"href\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"current_user_public\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"href\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"current_user\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"href\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"current_user_actor\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"href\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"current_user_organization\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"href\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t}\n \t\t}\n \t}\n }\n }\n example: |\n {\n \"timeline_url\": \"https://github.com/timeline\",\n \"user_url\": \"https://github.com/{user}\",\n \"current_user_public\": \"https://github.com/defunkt\",\n \"current_user_url\": \"https://github.com/defunkt.private?token=abc123\",\n \"current_user_actor_url\": \"https://github.com/defunkt.private.actor?token=abc123\",\n \"current_user_organization_url\": \"https://github.com/organizations/{org}/defunkt.private.atom?token=abc123\",\n \"_links\": {\n \"timeline\": {\n \"href\": \"https://github.com/timeline\",\n \"type\": \"application/atom xml\"\n },\n \"user\": {\n \"href\": \"https://github.com/{user}\",\n \"type\": \"application/atom xml\"\n },\n \"current_user_public\": {\n \"href\": \"https://github.com/defunkt\",\n \"type\": \"application/atom xml\"\n },\n \"current_user\": {\n \"href\": \"https://github.com/defunkt.private?token=abc123\",\n \"type\": \"application/atom xml\"\n },\n \"current_user_actor\": {\n \"href\": \"https://github.com/defunkt.private.actor?token=abc123\",\n \"type\": \"application/atom xml\"\n },\n \"current_user_organization\": {\n \"href\": \"https://github.com/organizations/{org}/defunkt.private.atom?token=abc123\",\n \"type\": \"application/atom xml\"\n }\n }\n }\n# Meta\n/meta:\n type: collection\n get:\n description: This gives some information about GitHub.com, the service.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"hooks\": [\n {\n \"description\": \"An Array of IP addresses in CIDR format specifying the addresses that incoming service hooks will originate from.\",\n \"type\": \"string\"\n }\n ],\n \"type\": \"array\",\n \"git\": [\n {\n \"description\": \"An Array of IP addresses in CIDR format specifying the Git servers at GitHub.\",\n \"type\": \"string\"\n }\n ]\n }\n }\n example: |\n {\n \"hooks\": [\n \"127.0.0.1/32\"\n ],\n \"git\": [\n \"127.0.0.1/32\"\n ]\n }\n# Rate limit\n/rate_limit:\n type: collection\n get:\n description: |\n Get your current rate limit status\n Note: Accessing this endpoint does not count against your rate limit.\n responses:\n 200:\n body:\n schema: |\n {\n \t\"$schema\": \"http://json-schema.org/draft-03/schema\",\n \t\"type\": \"object\",\n \t\"properties\": {\n \t\t\"rate\": {\n \t\t\t\"properties\": {\n \t\t\t\t\"limit\": {\n \t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t},\n \t\t\t \"remaining\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"reset\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t }\n \t\t\t}\n \t\t}\n \t}\n }\n example: |\n {\n \"rate\": {\n \"limit\": 5000,\n \"remaining\": 4999,\n \"reset\": 1372700873\n }\n }\n# Issues\n/issues:\n type: item\n get:\n is: [ filterable ]\n description: |\n List issues.\n List all issues across all the authenticated user's visible repositories.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"issues\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n ]\n# Other\n/notifications:\n type: collection\n get:\n description: |\n List your notifications.\n List all notifications for the current user, grouped by repository.\n queryParameters:\n all:\n description: True to show notifications marked as read.\n type: string\n participating:\n description: |\n True to show only notifications in which the user is directly participating\n or mentioned.\n type: string\n since:\n description: |\n Time filters out any notifications updated before the given time. The\n time should be passed in as UTC in the ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\n Example: \"2012-10-09T23:39:01Z\".\n type: string\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"id\": {\n \t\t\t\t\"type\": \"integer\"\n \t\t\t},\n \t\t\t\"repository\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"id\": {\n \t\t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t\t},\n \t\t\t\t\t\"owner\": {\n \t\t\t\t\t\t\"properties\": {\n \t\t\t\t\t\t\t\"login\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"id\": {\n \t\t\t\t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"avatar_url\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"gravatar_id\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t}\n \t\t\t\t\t\t},\n \t\t\t\t\t\t\"type\": \"object\"\n \t\t\t\t\t},\n \t\t\t\t\t\"name\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"full_name\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"description\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"private\": {\n \t\t\t\t\t\t\"type\": \"boolean\"\n \t\t\t\t\t},\n \t\t\t\t\t\"fork\": {\n \t\t\t\t\t\t\"type\": \"boolean\"\n \t\t\t\t\t},\n \t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"html_url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"subject\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"title\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"latest_comment_url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"reason\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"unread\": {\n \t\t\t\t\"type\": \"boolean\"\n \t\t\t},\n \t\t\t\"updated_at\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"last_read_at\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t}\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"repository\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\"\n },\n \"subject\": {\n \"title\": \"Greetings\",\n \"url\": \"https://api.github.com/repos/pengwynn/octokit/issues/123\",\n \"latest_comment_url\": \"https://api.github.com/repos/pengwynn/octokit/issues/comments/123\",\n \"type\": \"Issue\"\n },\n \"reason\": \"subscribed\",\n \"unread\": true,\n \"updated_at\": \"2012-09-25T07:54:41-07:00\",\n \"last_read_at\": \"2012-09-25T07:54:41-07:00\",\n \"url\": \"https://api.github.com/notifications/threads/1\"\n }\n ]\n put:\n description: |\n Mark as read.\n Marking a notification as \"read\" removes it from the default view on GitHub.com.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"last_read_at\": {\n \t\t\"description\": \"Describes the last point that notifications were checked. Anything updated since this time will not be updated. Default: Now.\",\n \t\t\"type\": \"string\"\n \t}\n }\n }\n responses:\n 205:\n description: Marked as read.\n /threads/{id}:\n uriParameters:\n id:\n description: Id of a thread.\n type: integer\n type: item\n get:\n description: View a single thread.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"id\": {\n \t\t\t\t\"type\": \"integer\"\n \t\t\t},\n \t\t\t\"repository\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"id\": {\n \t\t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t\t},\n \t\t\t\t\t\"owner\": {\n \t\t\t\t\t\t\"properties\": {\n \t\t\t\t\t\t\t\"login\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"id\": {\n \t\t\t\t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"avatar_url\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"gravatar_id\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t}\n \t\t\t\t\t\t},\n \t\t\t\t\t\t\"type\": \"object\"\n \t\t\t\t\t},\n \t\t\t\t\t\"name\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"full_name\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"description\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"private\": {\n \t\t\t\t\t\t\"type\": \"boolean\"\n \t\t\t\t\t},\n \t\t\t\t\t\"fork\": {\n \t\t\t\t\t\t\"type\": \"boolean\"\n \t\t\t\t\t},\n \t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"html_url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"subject\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"title\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"latest_comment_url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"reason\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"unread\": {\n \t\t\t\t\"type\": \"boolean\"\n \t\t\t},\n \t\t\t\"updated_at\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"last_read_at\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t}\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"repository\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\"\n },\n \"subject\": {\n \"title\": \"Greetings\",\n \"url\": \"https://api.github.com/repos/pengwynn/octokit/issues/123\",\n \"latest_comment_url\": \"https://api.github.com/repos/pengwynn/octokit/issues/comments/123\",\n \"type\": \"Issue\"\n },\n \"reason\": \"subscribed\",\n \"unread\": true,\n \"updated_at\": \"2012-09-25T07:54:41-07:00\",\n \"last_read_at\": \"2012-09-25T07:54:41-07:00\",\n \"url\": \"https://api.github.com/notifications/threads/1\"\n }\n ]\n patch:\n responses:\n 205:\n description: Thread marked as read.\n /subscription:\n type: item\n get:\n description: Get a Thread Subscription.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"subscribed\":{\n \t\t\"type\": \"boolean\"\n \t},\n \t\t\"ignored\": {\n \t\t\t\"type\": \"boolean\"\n \t\t},\n \t\t\"reason\": {\n \t\t\t\"type\": \"boolean\"\n \t\t},\n \t\t\"created_at\": {\n \t\t\t\"type\": \"string\"\n \t\t},\n \t\t\"url\": {\n \t\t\t\"type\": \"string\"\n \t\t},\n \t\t\"thread_url\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n }\n }\n example: |\n {\n \"subscribed\": true,\n \"ignored\": false,\n \"reason\": null,\n \"created_at\": \"2012-10-06T21:34:12Z\",\n \"url\": \"https://api.github.com/notifications/threads/1/subscription\",\n \"thread_url\": \"https://api.github.com/notifications/threads/1\"\n }\n put:\n description: |\n Set a Thread Subscription.\n This lets you subscribe to a thread, or ignore it. Subscribing to a thread\n is unnecessary if the user is already subscribed to the repository. Ignoring\n a thread will mute all future notifications (until you comment or get @mentioned).\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"subscribed\": {\n \t\t\"description\": \"Determines if notifications should be received from this thread.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"ignored\": {\n \t\t\"description\": \"Determines if all notifications should be blocked from this thread.\",\n \t\t\"type\": \"string\"\n \t}\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"subscribed\":{\n \t\t\"type\": \"boolean\"\n \t},\n \t\t\"ignored\": {\n \t\t\t\"type\": \"boolean\"\n \t\t},\n \t\t\"reason\": {\n \t\t\t\"type\": \"boolean\"\n \t\t},\n \t\t\"created_at\": {\n \t\t\t\"type\": \"string\"\n \t\t},\n \t\t\"url\": {\n \t\t\t\"type\": \"string\"\n \t\t},\n \t\t\"thread_url\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n }\n }\n example: |\n {\n \"subscribed\": true,\n \"ignored\": false,\n \"reason\": null,\n \"created_at\": \"2012-10-06T21:34:12Z\",\n \"url\": \"https://api.github.com/notifications/threads/1/subscription\",\n \"thread_url\": \"https://api.github.com/notifications/threads/1\"\n }\n delete:\n description: Delete a Thread Subscription.\n/gists:\n securedBy: [ null, oauth_2_0 ]\n type: collection\n get:\n is: [ historical ]\n description: |\n List the authenticated user's gists or if called anonymously, this will\n return all public gists.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"gists\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"type\": \"string\"\n }\n }\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n post:\n description: Create a gist.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"public\": {\n \t\t\"type\": \"boolean\"\n \t},\n \t\"files\": {\n \t\t\"description\": \"Files that make up this gist. The key of which should be a required string filename and the value another required hash with parameter 'content'.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"content\": {\n \t\t\"description\": \"File contents.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"public\", \"files\", \"content\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n },\n \"forks\": [\n {\n \"properties\": {\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"history\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"change_status\": {\n \"properties\": {\n \"deletions\": {\n \"type\": \"integer\"\n },\n \"additions\": {\n \"type\": \"integer\"\n },\n \"total\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n },\n \"committed_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n },\n \"type\": \"object\"\n }\n }\n ]\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\",\n \"forks\": [\n {\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"url\": \"https://api.github.com/gists/d39d0d37fb24f12e2045\",\n \"created_at\": \"2011-04-14T16:00:49Z\"\n }\n ],\n \"history\": [\n {\n \"url\": \"https://api.github.com/gists/3a8bdc16d2e39d809469\",\n \"version\": \"57a7f021a713b1c5a6a199b54cc514735d2d462f\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"change_status\": {\n \"deletions\": 0,\n \"additions\": 180,\n \"total\": 180\n },\n \"committed_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n }\n # Public\n /public:\n securedBy: [ null, oauth_2_0 ]\n type: collection\n get:\n is: [ historical ]\n description: List all public gists.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"gists\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"type\": \"string\"\n }\n }\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n # Starred\n /starred:\n securedBy: [ null, oauth_2_0 ]\n type: collection\n get:\n is: [ historical ]\n description: List the authenticated user's starred gists.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"gists\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"type\": \"string\"\n }\n }\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n # ID\n /{id}:\n uriParameters:\n id:\n description: Id of a thread.\n type: integer\n type: item\n get:\n description: Get a single gist.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n },\n \"forks\": [\n {\n \"properties\": {\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"history\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"change_status\": {\n \"properties\": {\n \"deletions\": {\n \"type\": \"integer\"\n },\n \"additions\": {\n \"type\": \"integer\"\n },\n \"total\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n },\n \"committed_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n },\n \"type\": \"object\"\n }\n }\n ]\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\",\n \"forks\": [\n {\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"url\": \"https://api.github.com/gists/d39d0d37fb24f12e2045\",\n \"created_at\": \"2011-04-14T16:00:49Z\"\n }\n ],\n \"history\": [\n {\n \"url\": \"https://api.github.com/gists/3a8bdc16d2e39d809469\",\n \"version\": \"57a7f021a713b1c5a6a199b54cc514735d2d462f\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"change_status\": {\n \"deletions\": 0,\n \"additions\": 180,\n \"total\": 180\n },\n \"committed_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n }\n patch:\n description: Edit a gist.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"files\": {\n \"properties\": {\n \"file1.txt\": {\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"old_name.txt\": {\n \"properties\": {\n \"filename\": {\n \"type\": \"string\"\n },\n \"content\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"new_file.txt\": {\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"delete_this_file.txt\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n },\n \"forks\": [\n {\n \"properties\": {\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"history\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"version\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"change_status\": {\n \"properties\": {\n \"deletions\": {\n \"type\": \"integer\"\n },\n \"additions\": {\n \"type\": \"integer\"\n },\n \"total\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n },\n \"committed_at\": {\n \"description\": \"Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\",\n \"type\": \"string\"\n },\n \"type\": \"object\"\n }\n }\n ]\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\",\n \"forks\": [\n {\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"url\": \"https://api.github.com/gists/d39d0d37fb24f12e2045\",\n \"created_at\": \"2011-04-14T16:00:49Z\"\n }\n ],\n \"history\": [\n {\n \"url\": \"https://api.github.com/gists/3a8bdc16d2e39d809469\",\n \"version\": \"57a7f021a713b1c5a6a199b54cc514735d2d462f\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"change_status\": {\n \"deletions\": 0,\n \"additions\": 180,\n \"total\": 180\n },\n \"committed_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n }\n delete:\n description: Delete a gist.\n # Star\n /star:\n type: base\n put:\n description: Star a gist.\n responses:\n 204:\n description: Starred.\n delete:\n description: Unstar a gist.\n responses:\n 204:\n description: Item removed.\n get:\n description: Check if a gist is starred.\n responses:\n 204:\n description: Exists.\n 404:\n description: Not exists.\n # Forks\n /forks:\n type: base\n post:\n description: Fork a gist.\n responses:\n 204:\n description: Exists.\n 404:\n description: Not exists.\n /comments:\n type: collection\n get:\n description: List comments on a gist.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"comments\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601.\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/gists/ae709e9cf889e485e65f/comments/1\",\n \"body\": \"Just commenting for the sake of commenting\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-18T23:23:56Z\"\n }\n ]\n post:\n description: Create a comment\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"body\": {\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"body\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601.\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/gists/83ba86d111d39709da8c/comments/1\",\n \"body\": \"Just commenting for the sake of commenting\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-18T23:23:56Z\"\n }\n /{commentId}:\n type: item\n uriParameters:\n commentId:\n description: Id of the comment.\n type: integer\n get:\n description: Get a single comment.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601.\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/gists/83ba86d111d39709da8c/comments/1\",\n \"body\": \"Just commenting for the sake of commenting\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-18T23:23:56Z\"\n }\n patch:\n description: Edit a comment.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601.\",\n \"type\": \"string\"\n }\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601.\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/gists/83ba86d111d39709da8c/comments/1\",\n \"body\": \"Just commenting for the sake of commenting\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-18T23:23:56Z\"\n }\n delete:\n description: Delete a comment.\n/orgs/{orgId}:\n uriParameters:\n orgId:\n description: Id of organisation.\n type: integer\n type: item\n get:\n description: Get an Organization.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"company\": {\n \"type\": \"string\"\n },\n \"blog\": {\n \"type\": \"string\"\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"public_repos\": {\n \"type\": \"integer\"\n },\n \"public_gists\": {\n \"type\": \"integer\"\n },\n \"followers\": {\n \"type\": \"integer\"\n },\n \"following\": {\n \"type\": \"integer\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"login\": \"github\",\n \"id\": 1,\n \"url\": \"https://api.github.com/orgs/github\",\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"name\": \"github\",\n \"company\": \"GitHub\",\n \"blog\": \"https://github.com/blog\",\n \"location\": \"San Francisco\",\n \"email\": \"octocat@github.com\",\n \"public_repos\": 2,\n \"public_gists\": 1,\n \"followers\": 20,\n \"following\": 0,\n \"html_url\": \"https://github.com/octocat\",\n \"created_at\": \"2008-01-14T04:33:35Z\",\n \"type\": \"Organization\"\n }\n patch:\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"billing_email\": {\n \t\t\"description\": \"Billing email address. This address is not publicized.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"company\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"email\": {\n \t\t\"description\": \"Publicly visible email address.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"location\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t}\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"company\": {\n \"type\": \"string\"\n },\n \"blog\": {\n \"type\": \"string\"\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"public_repos\": {\n \"type\": \"integer\"\n },\n \"public_gists\": {\n \"type\": \"integer\"\n },\n \"followers\": {\n \"type\": \"integer\"\n },\n \"following\": {\n \"type\": \"integer\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"login\": \"github\",\n \"id\": 1,\n \"url\": \"https://api.github.com/orgs/github\",\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"name\": \"github\",\n \"company\": \"GitHub\",\n \"blog\": \"https://github.com/blog\",\n \"location\": \"San Francisco\",\n \"email\": \"octocat@github.com\",\n \"public_repos\": 2,\n \"public_gists\": 1,\n \"followers\": 20,\n \"following\": 0,\n \"html_url\": \"https://github.com/octocat\",\n \"created_at\": \"2008-01-14T04:33:35Z\",\n \"type\": \"Organization\"\n }\n description: Edit an Organization.\n # Events\n /events:\n type: collection\n get:\n description: List public events for an organization.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n # Issues\n /issues:\n type: collection\n get:\n is: [ filterable ]\n description: |\n List issues.\n List all issues for a given organization for the authenticated user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"issues\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n ]\n /members:\n type: collection\n get:\n description: |\n Members list.\n List all users who are members of an organization. A member is a user that\n belongs to at least 1 team in the organization. If the authenticated user\n is also an owner of this organization then both concealed and public members\n will be returned. If the requester is not an owner of the organization the\n query will be redirected to the public members list.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"login\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"avatar_url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"gravatar_id\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n 302:\n description: Response if requester is not an organization member.\n /{userId}:\n type: item\n uriParameters:\n userId:\n description: Id of the user.\n type: integer\n delete:\n description: |\n Remove a member.\n Removing a user from this list will remove them from all teams and they\n will no longer have any access to the organization's repositories.\n /public_members:\n type: collection\n get:\n description: |\n Public members list.\n Members of an organization can choose to have their membership publicized\n or not.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"login\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"avatar_url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"gravatar_id\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n /{userId}:\n uriParameters:\n userId:\n description: Id of the user.\n type: integer\n type: base\n get:\n description: Check public membership.\n responses:\n 204:\n description: User is a public member.\n 404:\n description: User is not a public member.\n put:\n description: Publicize a user's membership.\n responses:\n 204:\n description: Publicized.\n delete:\n description: Conceal a user's membership.\n responses:\n 204:\n description: Concealed.\n /teams:\n type: collection\n get:\n description: List teams.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"name\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/teams/1\",\n \"name\": \"Owners\",\n \"id\": 1\n }\n ]\n post:\n description: |\n Create team.\n In order to create a team, the authenticated user must be an owner of orgId.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"repo_names\": [\n {\n \"type\": \"string\"\n }\n ],\n \"type\": \"array\",\n \"permission\": {\n \"enum\": [\n \"pull\",\n \"push\",\n \"admin\"\n ]\n }\n },\n \"required\": [\n \"name\"\n ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"permission\": {\n \"type\": \"string\"\n },\n \"members_count\": {\n \"type\": \"integer\"\n },\n \"repos_count\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/teams/1\",\n \"name\": \"Owners\",\n \"id\": 1\n }\n ]\n /repos:\n type: collection\n get:\n description: List repositories for the specified org.\n queryParameters:\n type:\n enum:\n - all\n - public\n - private\n - forks\n - sources\n - member\n default: all\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n post:\n description: |\n Create a new repository for the authenticated user. OAuth users must supply\n repo scope.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"homepage\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"private\": {\n \t\t\"description\": \"True to create a private repository, false to create a public one. Creating private repositories requires a paid GitHub account.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_issues\": {\n \t\t\"description\": \"True to enable issues for this repository, false to disable them. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_wiki\": {\n \t\t\"description\": \"True to enable the wiki for this repository, false to disable it. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_downloads\": {\n \t\t\"description\": \"True to enable downloads for this repository, false to disable them. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"team_id\": {\n \t\t\"description\": \"The id of the team that will be granted access to this repository. This is only valid when creating a repo in an organization.\",\n \t\t\"type\": \"integer\"\n \t},\n \t\"auto_init\": {\n \t\t\"description\": \"True to create an initial commit with empty README. Default is false.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"gitignore_template\": {\n \t\t\"description\": \"Desired language or platform .gitignore template to apply. Use the name of the template without the extension. For example, \\\"Haskell\\\" Ignored if auto_init parameter is not provided. \",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"name\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n/teams/{teamsId}:\n uriParameters:\n teamsId:\n description: Id of a team.\n type: integer\n type: item\n get:\n description: Get team.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"permission\": {\n \"type\": \"string\"\n },\n \"members_count\": {\n \"type\": \"integer\"\n },\n \"repos_count\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/teams/1\",\n \"name\": \"Owners\",\n \"id\": 1\n }\n ]\n patch:\n description: |\n Edit team.\n In order to edit a team, the authenticated user must be an owner of the org\n that the team is associated with.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"permission\": {\n \t\t\"values\": [\n \t\t\t\"pull\",\n \t\t\t\"push\",\n \t\t\t\"admin\"\n \t\t]\n \t}\n },\n \"required\": [ \"name\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"permission\": {\n \"type\": \"string\"\n },\n \"members_count\": {\n \"type\": \"integer\"\n },\n \"repos_count\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/teams/1\",\n \"name\": \"Owners\",\n \"id\": 1\n }\n ]\n delete:\n description: |\n Delete team.\n In order to delete a team, the authenticated user must be an owner of the\n org that the team is associated with.\n /members:\n type: collection\n get:\n description: |\n List team members.\n In order to list members in a team, the authenticated user must be a member\n of the team.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"login\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"avatar_url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"gravatar_id\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n /{userId}:\n uriParameters:\n userId:\n description: Id of a member.\n type: integer\n type: base\n get:\n description: |\n Get team member.\n In order to get if a user is a member of a team, the authenticated user must\n be a member of the team.\n responses:\n 204:\n description: User is a member.\n 404:\n description: User is not a member.\n put:\n description: |\n Add team member.\n In order to add a user to a team, the authenticated user must have 'admin'\n permissions to the team or be an owner of the org that the team is associated\n with.\n responses:\n 204:\n description: Team member added.\n 422:\n description: If you attempt to add an organization to a team, you will get this.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n },\n \"errors\": [\n {\n \"properties\": {\n \"code\": {\n \"type\": \"string\"\n },\n \"field\": {\n \"type\": \"string\"\n },\n \"resource\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"object\"\n }\n }\n example: |\n {\n \"message\": \"Validation Failed\",\n \"errors\": [\n {\n \"code\": \"org\",\n \"field\": \"user\",\n \"resource\": \"TeamMember\"\n }\n ]\n }\n delete:\n description: |\n Remove team member.\n In order to remove a user from a team, the authenticated user must have 'admin'\n permissions to the team or be an owner of the org that the team is associated\n with.\n NOTE This does not delete the user, it just remove them from the team.\n responses:\n 204:\n description: Team member removed.\n/repositories:\n type: collection\n get:\n securedBy: [ null, oauth_2_0 ]\n description: |\n List all public repositories.\n This provides a dump of every public repository, in the order that they\n were created.\n Note: Pagination is powered exclusively by the since parameter. is the\n Link header to get the URL for the next page of repositories.\n queryParameters:\n since:\n description: |\n The integer ID of the last Repository that you've seen.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\"\n }\n ]\n/repos/{ownerId}/{repoId}:\n uriParameters:\n ownerId:\n description: Id of the owner.\n type: integer\n repoId:\n description: Id of repository.\n type: integer\n type: item\n get:\n description: Get repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"organization\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parent\": {\n \t\"description\": \"Is present when the repo is a fork. Parent is the repo this repo was forked from.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"source\": {\n \t\"description\": \"Is present when the repo is a fork. Source is the ultimate source for the network.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"has_issues\": {\n \"type\": \"boolean\"\n },\n \"has_wiki\": {\n \"type\": \"boolean\"\n },\n \"has_downloads\": {\n \"type\": \"boolean\"\n }\n }\n }\n example: |\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\",\n \"organization\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"type\": \"Organization\"\n },\n \"parent\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n },\n \"source\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n },\n \"has_issues\": true,\n \"has_wiki\": true,\n \"has_downloads\": true\n }\n patch:\n description: Edit repository.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"homepage\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"private\": {\n \t\t\"description\": \"True makes the repository private, and false makes it public.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_issues\": {\n \t\t\"description\": \"True to enable issues for this repository, false to disable them. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_wiki\": {\n \t\t\"description\": \"True to enable the wiki for this repository, false to disable it. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_downloads\": {\n \t\t\"description\": \"True to enable downloads for this repository, false to disable them. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"default_branch\": {\n \t\t\"description\": \"Update the default branch for this repository.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"name\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"organization\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parent\": {\n \t\"description\": \"Is present when the repo is a fork. Parent is the repo this repo was forked from.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"source\": {\n \t\"description\": \"Is present when the repo is a fork. Source is the ultimate source for the network.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"has_issues\": {\n \"type\": \"boolean\"\n },\n \"has_wiki\": {\n \"type\": \"boolean\"\n },\n \"has_downloads\": {\n \"type\": \"boolean\"\n }\n }\n }\n example: |\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\",\n \"organization\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"type\": \"Organization\"\n },\n \"parent\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n },\n \"source\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n },\n \"has_issues\": true,\n \"has_wiki\": true,\n \"has_downloads\": true\n }\n delete:\n description: |\n Delete a Repository.\n Deleting a repository requires admin access. If OAuth is used, the delete_repo\n scope is required.\n # Events\n /events:\n type: collection\n get:\n description: Get list of repository events.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n # Languages\n /languages:\n type: collection\n get:\n description: |\n List languages.\n List languages for the specified repository. The value on the right of a\n language is the number of bytes of code written in that language.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"language\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"count\": {\n \t\t\"type\": \"string\"\n \t}\n }\n }\n example: |\n {\n \"C\": 78769,\n \"Python\": 7769\n }\n # GIT\n /git:\n /blobs:\n type: collection\n post:\n description: Create a Blob.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"encoding\": {\n \"enum\": [\n \"utf-8\",\n \"base64\"\n ]\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n }\n }\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"sha\": {\n \t\t\"type\": \"string\"\n \t}\n }\n }\n example: |\n {\n \"sha\": \"3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15\"\n }\n /{shaCode}:\n uriParameters:\n shaCode:\n description: SHA-1 code.\n type: string\n type: item\n get:\n description: |\n Get a Blob.\n Since blobs can be any arbitrary binary data, the input and responses for\n the blob API takes an encoding parameter that can be either utf-8 or\n base64. If your data cannot be losslessly sent as a UTF-8 string, you can\n base64 encode it.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"encoding\": {\n \"enum\": [\n \"utf-8\",\n \"base64\"\n ]\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n {\n \"content\": \"Content of the blob\",\n \"encoding\": \"utf-8\",\n \"sha\": \"3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15\",\n \"size\": 100\n }\n /commits:\n type: item\n post:\n description: Create a Commit.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"description\": \"String of the commit message\",\n \"type\": \"string\"\n },\n \"tree\": {\n \"description\": \"String of the SHA of the tree object this commit points to.\",\n \"type\": \"string\"\n },\n \"parents\": [\n {\n \"description\": \"Array of the SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided, for a merge commit, an array of more than one should be provided.\",\n \"type\": \"string\"\n }\n ],\n \"type\": \"array\",\n \"author\": {\n \"properties\": {\n \"name\": {\n \"description\": \"String of the name of the author of the commit.\",\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"String of the email of the author of the commit.\",\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"Timestamp of when this commit was authored.\",\n \"type\": \"timestamp\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"description\": \"String of the name of the committer of the commit.\",\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"String of the email of the committer of the commit.\",\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"Timestamp of when this commit was committed.\",\n \"type\": \"timestamp\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"required\": [\n \"message\",\n \"tree\",\n \"parents\"\n ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"type\": \"string\"\n }\n ],\n \"tree\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"message\": \"my commit message\",\n \"author\": {\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\",\n \"date\": \"2008-07-09T16:13:30 12:00\"\n },\n \"parents\": [\n \"7d1b31e74ee336d15cbd21741bc88a537ed063a0\"\n ],\n \"tree\": \"827efc6d56897b048c772eb4087f854f46256132\"\n }\n /{shaCode}:\n uriParameters:\n shaCode:\n description: SHA-1 code.\n type: string\n type: item\n get:\n description: Get a Commit.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"sha\": \"7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"author\": {\n \"date\": \"2010-04-10T14:10:01-07:00\",\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\"\n },\n \"committer\": {\n \"date\": \"2010-04-10T14:10:01-07:00\",\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\"\n },\n \"message\": \"added readme, because im a good github citizen\\n\",\n \"tree\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb\",\n \"sha\": \"691272480426f78a0138979dd3ce63b77f706feb\"\n },\n \"parents\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5\",\n \"sha\": \"1acc419d4d6a9ce985db7be48c6349a0475975b5\"\n }\n ]\n }\n /refs:\n type: collection\n get:\n description: Get all References\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"references\": [\n {\n \"properties\": {\n \"ref\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"object\": {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"ref\": \"refs/heads/master\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/refs/heads/master\",\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"aa218f56b14c9653891f9e74264a383fa43fefbd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd\"\n }\n },\n {\n \"ref\": \"refs/heads/gh-pages\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/refs/heads/gh-pages\",\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac\"\n }\n },\n {\n \"ref\": \"refs/tags/v0.0.1\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/refs/tags/v0.0.1\",\n \"object\": {\n \"type\": \"tag\",\n \"sha\": \"940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac\"\n }\n }\n ]\n post:\n description: Create a Reference\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"ref\": {\n \t\t\"description\": \"String of the name of the fully qualified reference (ie: refs/heads/master). If it doesn't start with ?refs' and have at least two slashes, it will be rejected.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"sha\": {\n \t\t\"description\": \"String of the SHA1 value to set this reference to.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [\n \t\"ref\",\n \t\"sha\"\n ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"ref\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"object\": {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"ref\": \"refs/heads/sc/featureA\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/refs/heads/sc/featureA\",\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"aa218f56b14c9653891f9e74264a383fa43fefbd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd\"\n }\n }\n /{heads}:\n uriParameters:\n heads:\n description: Subfolder of path to the branch.\n type: string\n type: collection\n get:\n description: Get list of subdirectories.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"zipball_url\": {\n \"type\": \"string\"\n },\n \"tarball_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"name\": \"v0.1\",\n \"commit\": {\n \"sha\": \"c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc\",\n \"url\": \"https://api.github.com/octocat/Hello-World/commits/c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc\"\n },\n \"zipball_url\": \"https://github.com/octocat/Hello-World/zipball/v0.1\",\n \"tarball_url\": \"https://github.com/octocat/Hello-World/tarball/v0.1\"\n }\n ]\n /{branch}:\n type: item\n uriParameters:\n branch:\n description: Path to the branch.\n type: string\n get:\n description: Get a Reference.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"ref\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"object\": {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"ref\": \"refs/heads/sc/featureA\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/refs/heads/sc/featureA\",\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"aa218f56b14c9653891f9e74264a383fa43fefbd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd\"\n }\n }\n patch:\n description: Update a Reference\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"sha\": {\n \t\t\"description\": \"String of the SHA1 value to set this reference to.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"force\": {\n \t\t\"description\": \"Boolean indicating whether to force the update or to make sure the update is a fast-forward update. The default is false, so leaving this out or setting it to false will make sure you're not overwriting work.\",\n \t\t\"type\": \"boolean\"\n \t}\n },\n \"required\": [\n \t\"sha\",\n \t\"force\"\n ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"ref\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"object\": {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"ref\": \"refs/heads/sc/featureA\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/refs/heads/sc/featureA\",\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"aa218f56b14c9653891f9e74264a383fa43fefbd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd\"\n }\n }\n delete:\n description: Delete a Reference.\n /tags:\n type: collection\n post:\n description: |\n Create a Tag Object.\n Note that creating a tag object does not create the reference that makes a\n tag in Git. If you want to create an annotated tag in Git, you have to do\n this call to create the tag object, and then create the refs/tags/[tag]\n reference. If you want to create a lightweight tag, you only have to create\n the tag reference - this call would be unnecessary.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"tag\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tagger\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"object\": {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"tag\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"message\": {\n \t\t\"description\": \"String of the tag message.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"object\": {\n \t\t\"description\": \"String of the SHA of the git object this is tagging.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"type\": {\n \t\t\"description\": \"String of the type of the object we're tagging. Normally this is a commit but it can also be a tree or a blob.\",\n \t\t\"type\": \"string\"\n \t},\n \"tagger\": {\n \"properties\": {\n \"name\": {\n \"description\": \"String of the name of the author of the tag.\",\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"String of the email of the author of the tag.\",\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"Timestamp of when this object was tagged.\",\n \"type\": \"timestamp\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"required\": [\n \t\"tag\",\n \t\"message\",\n \t\"object\",\n \t\"type\",\n \t\"tagger\"\n ]\n }\n example: |\n {\n \"tag\": \"v0.0.1\",\n \"sha\": \"940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"message\": \"initial version\\n\",\n \"tagger\": {\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\",\n \"date\": \"2011-06-17T14:53:35-07:00\"\n },\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\"\n }\n }\n /{shaCode}:\n type: item\n get:\n description: Get a Tag.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"tag\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tagger\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"object\": {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"tag\": \"v0.0.1\",\n \"sha\": \"940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"message\": \"initial version\\n\",\n \"tagger\": {\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\",\n \"date\": \"2011-06-17T14:53:35-07:00\"\n },\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\"\n }\n }\n /trees:\n type: collection\n post:\n description: |\n Create a Tree.\n The tree creation API will take nested entries as well. If both a tree and\n a nested path modifying that tree are specified, it will overwrite the\n contents of that tree with the new path contents and write a new tree out.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"tree\": [\n {\n \"path\": {\n \"type\": \"string\"\n },\n \"mode\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n }\n ],\n \"type\": \"array\"\n }\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"base_tree\": {\n \"type\": \"string\"\n },\n \"tree\": [\n {\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"mode\": {\n \"description\": \"One of 100644 for file (blob), 100755 for executable (blob), 040000 for subdirectory (tree), 160000 for submodule (commit) or 120000 for a blob that specifies the path of a symlink.\",\n \"type\": \"string\",\n \"enum\": [\n \"100644\",\n \"100755\",\n \"040000\",\n \"160000\",\n \"120000\"\n ]\n },\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"blob\",\n \"tree\",\n \"commit\"\n ]\n },\n \"oneOf\": [\n {\n \"sha\": {\n \"description\": \"SHA1 checksum ID of the object in the tree.\",\n \"type\": \"string\"\n }\n },\n {\n \"content\": {\n \"description\": \"content you want this file to have - GitHub will write this blob out and use that SHA for this entry.\",\n \"type\": \"string\"\n }\n }\n ]\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n },\n \"required\": [\n \"tree\"\n ]\n }\n example: |\n {\n \"sha\": \"cd8274d15fa3ae2ab983129fb037999f264ba9a7\",\n \"url\": \"https://api.github.com/repo/octocat/Hello-World/trees/cd8274d15fa3ae2ab983129fb037999f264ba9a7\",\n \"tree\": [\n {\n \"path\": \"file.rb\",\n \"mode\": \"100644\",\n \"type\": \"blob\",\n \"size\": 132,\n \"sha\": \"7c258a9869f33c1e1e1f74fbb32f07c86cb5a75b\",\n \"url\": \"https://api.github.com/octocat/Hello-World/git/blobs/7c258a9869f33c1e1e1f74fbb32f07c86cb5a75b\"\n }\n ]\n }\n /{shaCode}:\n uriParameters:\n shaCode:\n description: Id of the owner.\n type: integer\n type: item\n get:\n description: Get a Tree.\n queryParameters:\n recursive:\n description: Get a Tree Recursively. (0 or 1)\n type: integer\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"tree\": [\n {\n \"path\": {\n \"type\": \"string\"\n },\n \"mode\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"sha\": \"9fb037999f264ba9a7fc6274d15fa3ae2ab98312\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/trees/9fb037999f264ba9a7fc6274d15fa3ae2ab98312\",\n \"tree\": [\n {\n \"path\": \"file.rb\",\n \"mode\": \"100644\",\n \"type\": \"blob\",\n \"size\": 30,\n \"sha\": \"44b4fc6d56897b048c772eb4087f854f46256132\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/blobs/44b4fc6d56897b048c772eb4087f854f46256132\"\n },\n {\n \"path\": \"subdir\",\n \"mode\": \"040000\",\n \"type\": \"tree\",\n \"sha\": \"f484d249c660418515fb01c2b9662073663c242e\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/blobs/f484d249c660418515fb01c2b9662073663c242e\"\n },\n {\n \"path\": \"exec_file\",\n \"mode\": \"100755\",\n \"type\": \"blob\",\n \"size\": 75,\n \"sha\": \"45b983be36b73c0788dc9cbcb76cbb80fc7bb057\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/blobs/45b983be36b73c0788dc9cbcb76cbb80fc7bb057\"\n }\n ]\n }\n # Readme\n /readme:\n type: item\n get:\n description: |\n Get the README.\n This method returns the preferred README for a repository.\n queryParameters:\n ref:\n description: The String name of the Commit/Branch/Tag. Defaults to master.\n type: string\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"encoding\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"content\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"git\": {\n \"type\": \"string\"\n },\n \"self\": {\n \"type\": \"string\"\n },\n \"html\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"type\": \"file\",\n \"encoding\": \"base64\",\n \"size\": 5362,\n \"name\": \"README.md\",\n \"path\": \"README.md\",\n \"content\": \"encoded content ...\",\n \"sha\": \"3d21ec53a331a6f037a91c368710b99387d012c1\",\n \"url\": \"https://api.github.com/repos/pengwynn/octokit/contents/README.md\",\n \"git_url\": \"https://api.github.com/repos/pengwynn/octokit/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1\",\n \"html_url\": \"https://github.com/pengwynn/octokit/blob/master/README.md\",\n \"_links\": {\n \"git\": \"https://api.github.com/repos/pengwynn/octokit/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1\",\n \"self\": \"https://api.github.com/repos/pengwynn/octokit/contents/README.md\",\n \"html\": \"https://github.com/pengwynn/octokit/blob/master/README.md\"\n }\n }\n # Stargazers\n /stargazers:\n type: collection\n get:\n description: List Stargazers.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n # Subscribers\n /subscribers:\n type: collection\n get:\n description: List watchers.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n # Tags\n /tags:\n type: collection\n get:\n description: Get list of tags.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"tag\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"message\": {\n \t\t\"description\": \"String of the tag message.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"object\": {\n \t\t\"description\": \"String of the SHA of the git object this is tagging.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"type\": {\n \t\t\"description\": \"String of the type of the object we're tagging. Normally this is a commit but it can also be a tree or a blob.\",\n \t\t\"type\": \"string\"\n \t},\n \"tagger\": {\n \"properties\": {\n \"name\": {\n \"description\": \"String of the name of the author of the tag.\",\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"String of the email of the author of the tag.\",\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"Timestamp of when this object was tagged.\",\n \"type\": \"timestamp\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"required\": [\n \t\"tag\",\n \t\"message\",\n \t\"object\",\n \t\"type\",\n \t\"tagger\"\n ]\n }\n example: |\n {\n \"tag\": \"v0.0.1\",\n \"sha\": \"940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac\",\n \"message\": \"initial version\\n\",\n \"tagger\": {\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\",\n \"date\": \"2011-06-17T14:53:35-07:00\"\n },\n \"object\": {\n \"type\": \"commit\",\n \"sha\": \"c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\"\n }\n }\n # Teams\n /teams:\n type: collection\n get:\n description: Get list of teams\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"name\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/teams/1\",\n \"name\": \"Owners\",\n \"id\": 1\n }\n ]\n # Watchers\n /watchers:\n type: collection\n get:\n description: List Stargazers. New implementation.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n # Other links\n /contributors:\n type: collection\n get:\n description: Get list of contributors.\n queryParameters:\n anon:\n description: Set to 1 or true to include anonymous contributors in results.\n type: string\n required: true\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"contributions\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"contributions\": 32\n }\n ]\n /branches:\n type: collection\n get:\n description: Get list of branches\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"name\": \"master\",\n \"commit\": {\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc\"\n }\n }\n ]\n /{branchId}:\n uriParameters:\n branchId:\n description: Id of the branch.\n type: integer\n type: item\n get:\n description: Get Branch\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"author\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"author\": {\n \"properties\": {\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"login\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"url\": {\n \"type\": \"string\"\n },\n \"committer\": {\n \"properties\": {\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"login\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"_links\": {\n \"properties\": {\n \"html\": {\n \"type\": \"string\"\n },\n \"self\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"name\": \"master\",\n \"commit\": {\n \"sha\": \"7fd1a60b01f91b314f59955a4e4d4e80d8edf11d\",\n \"commit\": {\n \"author\": {\n \"name\": \"The Octocat\",\n \"date\": \"2012-03-06T15:06:50-08:00\",\n \"email\": \"octocat@nowhere.com\"\n },\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d\",\n \"message\": \"Merge pull request #6 from Spaceghost/patch-1\\n\\nNew line at end of file.\",\n \"tree\": {\n \"sha\": \"b4eecafa9be2f2006ce1b709d6857b07069b4608\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/trees/b4eecafa9be2f2006ce1b709d6857b07069b4608\"\n },\n \"committer\": {\n \"name\": \"The Octocat\",\n \"date\": \"2012-03-06T15:06:50-08:00\",\n \"email\": \"octocat@nowhere.com\"\n }\n },\n \"author\": {\n \"gravatar_id\": \"7ad39074b0584bc555d0417ae3e7d974\",\n \"avatar_url\": \"https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com/images/gravatars/gravatar-140.png\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"id\": 583231,\n \"login\": \"octocat\"\n },\n \"parents\": [\n {\n \"sha\": \"553c2077f0edc3d5dc5d17262f6aa498e69d6f8e\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/553c2077f0edc3d5dc5d17262f6aa498e69d6f8e\"\n },\n {\n \"sha\": \"762941318ee16e59dabbacb1b4049eec22f0d303\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/762941318ee16e59dabbacb1b4049eec22f0d303\"\n }\n ],\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d\",\n \"committer\": {\n \"gravatar_id\": \"7ad39074b0584bc555d0417ae3e7d974\",\n \"avatar_url\": \"https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com/images/gravatars/gravatar-140.png\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"id\": 583231,\n \"login\": \"octocat\"\n }\n },\n \"_links\": {\n \"html\": \"https://github.com/octocat/Hello-World/tree/master\",\n \"self\": \"https://api.github.com/repos/octocat/Hello-World/branches/master\"\n }\n }\n /issues:\n type: collection\n get:\n is: [ filterable ]\n description: List issues for a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"issues\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n ]\n post:\n description: |\n Create an issue.\n Any user with pull access to a repository can create an issue.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"title\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"body\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"assignee\": {\n \t\t\"description\": \"Login for the user that this issue should be assigned to. NOTE: Only users with push access can set the assignee for new issues. The assignee is silently dropped otherwise.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"milestone\": {\n \t\t\"description\": \"Milestone to associate this issue with. NOTE: Only users with push access can set the milestone for new issues. The milestone is silently dropped otherwise.\",\n \t\t\"type\": \"integer\"\n \t},\n \t\"labels\": [\n \t\t{\n \t\t\t\"description\": \"Array of strings - Labels to associate with this issue. NOTE: Only users with push access can set labels for new issues. Labels are silently dropped otherwise.\",\n \t\t\t\"type\": \"string\"\n \t\t}\n \t],\n \t\"type\": \"array\"\n },\n \"required\": [ \"title\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n /events:\n type: collection\n get:\n description: List issue events for a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n /{eventId}:\n uriParameters:\n eventId:\n description: Id of the event.\n type: integer\n type: item\n get:\n description: Get a single event.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"type\": \"object\"\n },\n \"event\": {\n \"type\": \"string\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"issue\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/events/1\",\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"event\": \"closed\",\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"issue\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n }\n /{number}:\n uriParameters:\n number:\n description: Id of the issue.\n type: integer\n type: item\n get:\n description: Get a single issue\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n patch:\n description: |\n Edit an issue.\n Issue owners and users with push access can edit an issue.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n # Comments\n /comments:\n type: collection\n get:\n description: List comments on an issue.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n ]\n post:\n description: Create a comment.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"body\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n \t},\n \t\"required\": [ \"body\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/comments/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347#issuecomment-1\",\n \"body\": \"Me too\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n # Events\n /events:\n type: collection\n get:\n description: List issue events for a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n /{eventId}:\n uriParameters:\n eventId:\n description: Id of the event.\n type: integer\n type: item\n get:\n description: Get a single event.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"type\": \"object\"\n },\n \"event\": {\n \"type\": \"string\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"issue\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/events/1\",\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"event\": \"closed\",\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"issue\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n }\n # Labels\n /labels:\n type: collection\n get:\n description: List labels on an issue.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"name\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"color\": {\n \t\t\t \t\"type\": \"string\",\n \t\t\t \t\"maxLength\": 6,\n \t\t\t \t\"minLength\": 6\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ]\n post:\n description: Add labels to an issue.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"color\": {\n \t\t\"description\": \"6 character hex code, without a leading #.\",\n \t\t\"type\": \"string\",\n \t\t\"minLength\": 6,\n \t\t\"maxLength\": 6\n \t}\n },\n \"required\": [ \"name\", \"color\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\",\n \"maxLength\": 6,\n \"minLength\": 6\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n put:\n description: |\n Replace all labels for an issue.\n Sending an empty array ([]) will remove all Labels from the Issue.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"color\": {\n \t\t\"description\": \"6 character hex code, without a leading #.\",\n \t\t\"type\": \"string\",\n \t\t\"minLength\": 6,\n \t\t\"maxLength\": 6\n \t}\n },\n \"required\": [ \"name\", \"color\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\",\n \"maxLength\": 6,\n \"minLength\": 6\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n delete:\n description: Remove all labels from an issue.\n /{name}:\n uriParameters:\n name:\n description: Name of the label.\n type: string\n type: base\n delete:\n description: Remove a label from an issue.\n responses:\n 204:\n description: Item removed.\n /comments:\n type: collection\n get:\n description: List comments in a repository.\n queryParameters:\n sort:\n enum:\n - created\n - updated\n direction:\n description: Ignored without sort parameter.\n enum:\n - asc\n - desc\n since:\n description: Timestamp in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.\n type: string\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n ]\n /{commentId}:\n uriParameters:\n commentId:\n description: Id of the comment.\n type: integer\n type: item\n get:\n description: Get a single comment.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/comments/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347#issuecomment-1\",\n \"body\": \"Me too\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n patch:\n description: Edit a comment.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"body\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n \t},\n \t\"required\": [ \"body\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/comments/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347#issuecomment-1\",\n \"body\": \"Me too\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n delete:\n description: Delete a comment.\n /notifications:\n type: collection\n get:\n description: |\n List your notifications in a repository\n List all notifications for the current user.\n queryParameters:\n all:\n description: True to show notifications marked as read.\n type: string\n participating:\n description: |\n True to show only notifications in which the user is directly participating\n or mentioned.\n type: string\n since:\n description: |\n Time filters out any notifications updated before the given time. The\n time should be passed in as UTC in the ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.\n Example: \"2012-10-09T23:39:01Z\".\n type: string\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"id\": {\n \t\t\t\t\"type\": \"integer\"\n \t\t\t},\n \t\t\t\"repository\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"id\": {\n \t\t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t\t},\n \t\t\t\t\t\"owner\": {\n \t\t\t\t\t\t\"properties\": {\n \t\t\t\t\t\t\t\"login\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"id\": {\n \t\t\t\t\t\t\t\t\"type\": \"integer\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"avatar_url\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"gravatar_id\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t\t\t}\n \t\t\t\t\t\t},\n \t\t\t\t\t\t\"type\": \"object\"\n \t\t\t\t\t},\n \t\t\t\t\t\"name\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"full_name\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"description\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"private\": {\n \t\t\t\t\t\t\"type\": \"boolean\"\n \t\t\t\t\t},\n \t\t\t\t\t\"fork\": {\n \t\t\t\t\t\t\"type\": \"boolean\"\n \t\t\t\t\t},\n \t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"html_url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"subject\": {\n \t\t\t\t\"properties\": {\n \t\t\t\t\t\"title\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"latest_comment_url\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t},\n \t\t\t\t\t\"type\": {\n \t\t\t\t\t\t\"type\": \"string\"\n \t\t\t\t\t}\n \t\t\t\t},\n \t\t\t\t\"type\": \"object\"\n \t\t\t},\n \t\t\t\"reason\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"unread\": {\n \t\t\t\t\"type\": \"boolean\"\n \t\t\t},\n \t\t\t\"updated_at\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"last_read_at\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t}\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"repository\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\"\n },\n \"subject\": {\n \"title\": \"Greetings\",\n \"url\": \"https://api.github.com/repos/pengwynn/octokit/issues/123\",\n \"latest_comment_url\": \"https://api.github.com/repos/pengwynn/octokit/issues/comments/123\",\n \"type\": \"Issue\"\n },\n \"reason\": \"subscribed\",\n \"unread\": true,\n \"updated_at\": \"2012-09-25T07:54:41-07:00\",\n \"last_read_at\": \"2012-09-25T07:54:41-07:00\",\n \"url\": \"https://api.github.com/notifications/threads/1\"\n }\n ]\n put:\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"last_read_at\": {\n \t\t\"description\": \"Describes the last point that notifications were checked. Anything updated since this time will not be updated. Default: Now.\",\n \t\t\"type\": \"string\"\n \t}\n }\n }\n description: |\n Mark notifications as read in a repository.\n Marking all notifications in a repository as \"read\" removes them from the\n default view on GitHub.com.\n responses:\n 205:\n description: Marked as read.\n /subscription:\n type: collection\n get:\n description: Get a Repository Subscription.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"subscribed\": {\n \"type\": \"boolean\"\n },\n \"ignored\": {\n \"type\": \"boolean\"\n },\n \"reason\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"repository_url\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"subscribed\": true,\n \"ignored\": false,\n \"reason\": null,\n \"created_at\": \"2012-10-06T21:34:12Z\",\n \"url\": \"https://api.github.com/repos/octocat/example/subscription\",\n \"repository_url\": \"https://api.github.com/repos/octocat/example\"\n }\n put:\n description: Set a Repository Subscription\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"subscribed\": {\n \t\t\"description\": \"Determines if notifications should be received from this repository.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"ignored\": {\n \t\t\"description\": \"Determines if all notifications should be blocked from this repository.\",\n \t\t\"type\": \"boolean\"\n \t}\n },\n \"required\": [ \"subscribed\", \"ignored\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"subscribed\": {\n \"type\": \"boolean\"\n },\n \"ignored\": {\n \"type\": \"boolean\"\n },\n \"reason\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"repository_url\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"subscribed\": true,\n \"ignored\": false,\n \"reason\": null,\n \"created_at\": \"2012-10-06T21:34:12Z\",\n \"url\": \"https://api.github.com/repos/octocat/example/subscription\",\n \"repository_url\": \"https://api.github.com/repos/octocat/example\"\n }\n delete:\n description: Delete a Repository Subscription.\n /assignees:\n type: collection\n get:\n description: |\n List assignees.\n This call lists all the available assignees (owner collaborators) to which\n issues may be assigned.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"login\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"avatar_url\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"gravatar_id\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n /{assignee}:\n type: base\n uriParameters:\n assignee:\n description: Login of the assignee.\n type: string\n get:\n description: |\n Check assignee.\n You may also check to see if a particular user is an assignee for a repository.\n responses:\n 204:\n description: User is an assignee.\n 404:\n description: User isn't an assignee.\n /labels:\n type: collection\n get:\n description: List all labels for this repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"name\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"color\": {\n \t\t\t \t\"type\": \"string\",\n \t\t\t \t\"maxLength\": 6,\n \t\t\t \t\"minLength\": 6\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ]\n post:\n description: Create a label.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"color\": {\n \t\t\"description\": \"6 character hex code, without a leading #.\",\n \t\t\"type\": \"string\",\n \t\t\"minLength\": 6,\n \t\t\"maxLength\": 6\n \t}\n },\n \"required\": [ \"name\", \"color\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\",\n \"maxLength\": 6,\n \"minLength\": 6\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n /{name}:\n uriParameters:\n name:\n description: Name of the label.\n type: string\n type: item\n get:\n description: Get a single label.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\",\n \"maxLength\": 6,\n \"minLength\": 6\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n patch:\n description: Update a label.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"color\": {\n \t\t\"description\": \"6 character hex code, without a leading #.\",\n \t\t\"type\": \"string\",\n \t\t\"minLength\": 6,\n \t\t\"maxLength\": 6\n \t}\n },\n \"required\": [ \"name\", \"color\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\",\n \"maxLength\": 6,\n \"minLength\": 6\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n delete:\n description: Delete a label.\n /milestones:\n type: collection\n get:\n description: List milestones for a repository.\n queryParameters:\n state:\n enum:\n - open\n - closed\n default: open\n sort:\n enum:\n - due_date\n - completeness\n default: due_date\n direction:\n enum:\n - asc\n - desc\n default: desc\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n }\n post:\n description: Create a milestone.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"title\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"state\": {\n \t\t\"enum\": [\n \t\t\t\"open\",\n \t\t\t\"closed\"\n \t\t]\n \t},\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"due_on\": {\n \t\t\"description\": \"ISO 8601 time.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"title\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n }\n /{number}:\n uriParameters:\n number:\n description: Id of the milestone.\n type: integer\n type: item\n get:\n description: Get a single milestone.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n }\n patch:\n description: Update a milestone.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"number\": {\n \t\t\"type\": \"integer\"\n \t},\n \t\"title\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"state\": {\n \t\t\"enum\": [\n \t\t\t\"open\",\n \t\t\t\"closed\"\n \t\t]\n \t},\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"due_on\": {\n \t\t\"description\": \"ISO 8601 time.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"number\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n }\n delete:\n description: Delete a milestone.\n /labels:\n type: collection\n get:\n description: Get labels for every issue in a milestone.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"url\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"name\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"color\": {\n \t\t\t \t\"type\": \"string\",\n \t\t\t \t\"maxLength\": 6,\n \t\t\t \t\"minLength\": 6\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ]\n /pulls:\n type: collection\n get:\n description: List pull requests.\n queryParameters:\n state:\n description: String to filter by state.\n enum:\n - open\n - closed\n default: open\n head:\n description: |\n Filter pulls by head user and branch name in the format of 'user:ref-name'.\n Example: github:new-script-format.\n type: string\n base:\n description: Filter pulls by base branch name. Example - gh-pages.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n },\n \"issue_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"merged_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"head\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"base\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"review_comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/octocat/Hello-World/pulls/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/pulls/1\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/pulls/1.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/pulls/1.patch\",\n \"issue_url\": \"https://github.com/octocat/Hello-World/issue/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"new-feature\",\n \"body\": \"Please pull these awesome changes\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:01:12Z\",\n \"closed_at\": \"2011-01-26T19:01:12Z\",\n \"merged_at\": \"2011-01-26T19:01:12Z\",\n \"head\": {\n \"label\": \"new-topic\",\n \"ref\": \"new-topic\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"base\": {\n \"label\": \"master\",\n \"ref\": \"master\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1\"\n },\n \"comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/issues/1/comments\"\n },\n \"review_comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1/comments\"\n }\n },\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n }\n ]\n post:\n description: Create a pull request.\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n },\n \"issue_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"merged_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"head\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"base\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"review_comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/octocat/Hello-World/pulls/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/pulls/1\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/pulls/1.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/pulls/1.patch\",\n \"issue_url\": \"https://github.com/octocat/Hello-World/issue/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"new-feature\",\n \"body\": \"Please pull these awesome changes\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:01:12Z\",\n \"closed_at\": \"2011-01-26T19:01:12Z\",\n \"merged_at\": \"2011-01-26T19:01:12Z\",\n \"head\": {\n \"label\": \"new-topic\",\n \"ref\": \"new-topic\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"base\": {\n \"label\": \"master\",\n \"ref\": \"master\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1\"\n },\n \"comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/issues/1/comments\"\n },\n \"review_comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1/comments\"\n }\n },\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n }\n ]\n /{number}:\n uriParameters:\n number:\n description: Id of a pull.\n type: integer\n type: item\n get:\n description: Get a single pull request.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n },\n \"issue_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"merged_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"head\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"base\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"review_comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/octocat/Hello-World/pulls/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/pulls/1\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/pulls/1.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/pulls/1.patch\",\n \"issue_url\": \"https://github.com/octocat/Hello-World/issue/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"new-feature\",\n \"body\": \"Please pull these awesome changes\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:01:12Z\",\n \"closed_at\": \"2011-01-26T19:01:12Z\",\n \"merged_at\": \"2011-01-26T19:01:12Z\",\n \"head\": {\n \"label\": \"new-topic\",\n \"ref\": \"new-topic\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"base\": {\n \"label\": \"master\",\n \"ref\": \"master\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1\"\n },\n \"comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/issues/1/comments\"\n },\n \"review_comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1/comments\"\n }\n },\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"merge_commit_sha\": \"e5bd3914e2e596debea16f433f57875b5b90bcd6\",\n \"merged\": false,\n \"mergeable\": true,\n \"merged_by\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"comments\": 10,\n \"commits\": 3,\n \"additions\": 100,\n \"deletions\": 3,\n \"changed_files\": 5\n }\n patch:\n description: Update a pull request.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"title\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"body\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"state\": {\n \t\t\"enum\": [ \"open\", \"closed\" ]\n \t}\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"organization\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parent\": {\n \t\"description\": \"Is present when the repo is a fork. Parent is the repo this repo was forked from.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"source\": {\n \t\"description\": \"Is present when the repo is a fork. Source is the ultimate source for the network.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"has_issues\": {\n \"type\": \"boolean\"\n },\n \"has_wiki\": {\n \"type\": \"boolean\"\n },\n \"has_downloads\": {\n \"type\": \"boolean\"\n }\n }\n }\n example: |\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\",\n \"organization\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"type\": \"Organization\"\n },\n \"parent\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n },\n \"source\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n },\n \"has_issues\": true,\n \"has_wiki\": true,\n \"has_downloads\": true\n }\n # Files\n /files:\n type: item\n get:\n description: List pull requests files.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n },\n \"issue_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"merged_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"head\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"base\": {\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"ref\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"review_comments\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/octocat/Hello-World/pulls/1\",\n \"html_url\": \"https://github.com/octocat/Hello-World/pulls/1\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/pulls/1.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/pulls/1.patch\",\n \"issue_url\": \"https://github.com/octocat/Hello-World/issue/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"new-feature\",\n \"body\": \"Please pull these awesome changes\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:01:12Z\",\n \"closed_at\": \"2011-01-26T19:01:12Z\",\n \"merged_at\": \"2011-01-26T19:01:12Z\",\n \"head\": {\n \"label\": \"new-topic\",\n \"ref\": \"new-topic\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"base\": {\n \"label\": \"master\",\n \"ref\": \"master\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"repo\": {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n },\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1\"\n },\n \"comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/issues/1/comments\"\n },\n \"review_comments\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1/comments\"\n }\n },\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n }\n ]\n # Commits\n /commits:\n type: item\n get:\n description: List commits on a pull request.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"author\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"commit\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"author\": {\n \"name\": \"Monalisa Octocat\",\n \"email\": \"support@github.com\",\n \"date\": \"2011-04-14T16:00:49Z\"\n },\n \"committer\": {\n \"name\": \"Monalisa Octocat\",\n \"email\": \"support@github.com\",\n \"date\": \"2011-04-14T16:00:49Z\"\n },\n \"message\": \"Fix all the bugs\",\n \"tree\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\"\n }\n },\n \"author\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"committer\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"parents\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\"\n }\n ]\n }\n ]\n /merge:\n type: base\n get:\n description: Get if a pull request has been merged.\n responses:\n 204:\n description: Pull request has been merged.\n 404:\n description: Pull request has not been merged.\n put:\n description: Merge a pull request (Merge Button™)\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"commit_message\": {\n \t\t\"description\": \"The message that will be used for the merge commit\",\n \t\t\"type\": \"string\"\n \t}\n }\n }\n responses:\n 200:\n description: Response if merge was successful.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"merged\": {\n \"type\": \"boolean\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"merged\": true,\n \"message\": \"Pull Request successfully merged\"\n }\n 405:\n description: Response if merge cannot be performed.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"merged\": {\n \"type\": \"boolean\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"sha\": null,\n \"merged\": false,\n \"message\": \"Failure reason\"\n }\n /comments:\n type: collection\n get:\n description: List comments on a pull request.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n post:\n description: |\n Create a comment.\n #TODO Alternative input ( http://developer.github.com/v3/pulls/comments/ )\n description: |\n Alternative Input.\n Instead of passing commit_id, path, and position you can reply to an\n existing Pull Request Comment like this:\n\n body\n Required string\n in_reply_to\n Required number - Comment id to reply to.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"body\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"commit_id\": {\n \t\t\"description\": \"Sha of the commit to comment on.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"path\": {\n \t\t\"description\": \"Relative path of the file to comment on.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"position\": {\n \t\t\"description\": \"Line index in the diff to comment on.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"body\", \"commit_id\", \"path\", \"position\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n /comments:\n type: collection\n get:\n description: |\n List comments in a repository.\n By default, Review Comments are ordered by ascending ID.\n queryParameters:\n sort:\n enum:\n - created\n - updated\n direction:\n description: Ignored without 'sort' parameter.\n enum:\n - asc\n - desc\n since:\n description: Timestamp in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ\n type: string\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n ]\n /{number}:\n uriParameters:\n number:\n description: Id of the comment.\n type: integer\n type: item\n get:\n description: Get a single comment.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n patch:\n description: Edit a comment.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"body\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n \t},\n \t\"required\": [ \"body\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"html\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"pull_request\": {\n \"properties\": {\n \"href\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/pulls/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/comments/1\"\n },\n \"html\": {\n \"href\": \"https://github.com/octocat/Hello-World/pull/1#discussion-diff-1\"\n },\n \"pull_request\": {\n \"href\": \"https://api.github.com/octocat/Hello-World/pulls/1\"\n }\n }\n }\n delete:\n description: Delete a comment.\n /collaborators:\n type: collection\n get:\n description: |\n List.\n When authenticating as an organization owner of an organization-owned\n repository, all organization owners are included in the list of\n collaborators. Otherwise, only users with access to the repository are\n returned in the collaborators list.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"properties\": {\n \t\t\t\"login\": {\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t \"id\": {\n \t\t\t \t\"type\": \"integer\"\n \t\t\t },\n \t\t\t \"avatar_url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"gravatar_id\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t },\n \t\t\t \"url\": {\n \t\t\t \t\"type\": \"string\"\n \t\t\t }\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n /{user}:\n uriParameters:\n user:\n description: Login of the user.\n type: string\n type: base\n get:\n description: Check if user is a collaborator\n responses:\n 204:\n description: User is a collaborator.\n 404:\n description: User is not a collaborator.\n put:\n description: Add collaborator.\n responses:\n 204:\n description: Collaborator added.\n delete:\n description: Remove collaborator.\n responses:\n 204:\n description: Collaborator removed.\n /comments:\n type: collection\n get:\n description: |\n List commit comments for a repository.\n Comments are ordered by ascending ID.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"line\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"html_url\": \"https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"line\": 14,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n ]\n /{commentId}:\n uriParameters:\n commentId:\n description: Id of a comment.\n type: integer\n type: item\n get:\n description: Get a single commit comment.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"line\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"html_url\": \"https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"line\": 14,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n patch:\n description: Update a commit comment.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"body\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n \t},\n \t\"required\": [ \"body\" ]\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"line\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"html_url\": \"https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"line\": 14,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n delete:\n description: Delete a commit comment\n /commits:\n type: collection\n get:\n description: List commits on a repository.\n queryParameters:\n sha:\n description: Sha or branch to start listing commits from.\n type: string\n path:\n description: Only commits containing this file path will be returned.\n type: string\n author:\n description: GitHub login, name, or email by which to filter by commit author.\n type: string\n since:\n description: ISO 8601 Date - Only commits after this date will be returned.\n type: string\n until:\n description: ISO 8601 Date - Only commits before this date will be returned.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"author\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"commit\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"author\": {\n \"name\": \"Monalisa Octocat\",\n \"email\": \"support@github.com\",\n \"date\": \"2011-04-14T16:00:49Z\"\n },\n \"committer\": {\n \"name\": \"Monalisa Octocat\",\n \"email\": \"support@github.com\",\n \"date\": \"2011-04-14T16:00:49Z\"\n },\n \"message\": \"Fix all the bugs\",\n \"tree\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\"\n }\n },\n \"author\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"committer\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"parents\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\"\n }\n ]\n }\n ]\n /{shaCode}:\n uriParameters:\n shaCode:\n description: SHA-1 code of the commit.\n type: string\n type: item\n get:\n description: Get a single commit.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"author\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"commit\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"author\": {\n \"name\": \"Monalisa Octocat\",\n \"email\": \"support@github.com\",\n \"date\": \"2011-04-14T16:00:49Z\"\n },\n \"committer\": {\n \"name\": \"Monalisa Octocat\",\n \"email\": \"support@github.com\",\n \"date\": \"2011-04-14T16:00:49Z\"\n },\n \"message\": \"Fix all the bugs\",\n \"tree\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\"\n }\n },\n \"author\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"committer\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"parents\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\"\n }\n ],\n \"stats\": {\n \"additions\": 104,\n \"deletions\": 4,\n \"total\": 108\n },\n \"files\": [\n {\n \"filename\": \"file1.txt\",\n \"additions\": 10,\n \"deletions\": 2,\n \"changes\": 12,\n \"status\": \"modified\",\n \"raw_url\": \"https://github.com/octocat/Hello-World/raw/7ca483543807a51b6079e54ac4cc392bc29ae284/file1.txt\",\n \"blob_url\": \"https://github.com/octocat/Hello-World/blob/7ca483543807a51b6079e54ac4cc392bc29ae284/file1.txt\",\n \"patch\": \"@@ -29,7 29,7 @@\\n.....\"\n }\n ]\n }\n /comments:\n type: collection\n get:\n description: List comments for a single commitList comments for a single commit.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"line\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"html_url\": \"https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"line\": 14,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n ]\n post:\n description: Create a commit comment.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"sha\": {\n \t\t\"description\": \"SHA of the commit to comment on.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"body\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"path\": {\n \t\t\"description\": \"Relative path of the file to comment on.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"position\": {\n \t\t\"description\": \"Line index in the diff to comment on.\",\n \t\t\"type\": \"integer\"\n \t},\n \t\"line\": {\n \t\t\"description\": \"Deprecated - Use position parameter instead.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"number\": {\n \t\t\"description\": \"Line number in the file to comment on. Defaults to null.\",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"sha\", \"body\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"position\": {\n \"type\": \"integer\"\n },\n \"line\": {\n \"type\": \"integer\"\n },\n \"commit_id\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"html_url\": \"https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/comments/1\",\n \"id\": 1,\n \"body\": \"Great stuff\",\n \"path\": \"file1.txt\",\n \"position\": 4,\n \"line\": 14,\n \"commit_id\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-04-14T16:00:49Z\",\n \"updated_at\": \"2011-04-14T16:00:49Z\"\n }\n /contents/{path}:\n uriParameters:\n path:\n type: string\n type: base\n get:\n description: |\n Get contents.\n This method returns the contents of a file or directory in a repository.\n Files and symlinks support a custom media type for getting the raw content.\n Directories and submodules do not support custom media types.\n Note: This API supports files up to 1 megabyte in size.\n Here can be many outcomes. For details see \"http://developer.github.com/v3/repos/contents/\"\n queryParameters:\n path:\n description: The content path.\n type: string\n ref:\n description: The String name of the Commit/Branch/Tag. Defaults to 'master'.\n type: string\n responses:\n 200:\n body:\n application/json:\n #TODO many outcomes\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"encoding\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"content\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"git\": {\n \"type\": \"string\"\n },\n \"self\": {\n \"type\": \"string\"\n },\n \"html\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"type\": \"file\",\n \"encoding\": \"base64\",\n \"size\": 5362,\n \"name\": \"README.md\",\n \"path\": \"README.md\",\n \"content\": \"encoded content ...\",\n \"sha\": \"3d21ec53a331a6f037a91c368710b99387d012c1\",\n \"url\": \"https://api.github.com/repos/pengwynn/octokit/contents/README.md\",\n \"git_url\": \"https://api.github.com/repos/pengwynn/octokit/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1\",\n \"html_url\": \"https://github.com/pengwynn/octokit/blob/master/README.md\",\n \"_links\": {\n \"git\": \"https://api.github.com/repos/pengwynn/octokit/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1\",\n \"self\": \"https://api.github.com/repos/pengwynn/octokit/contents/README.md\",\n \"html\": \"https://github.com/pengwynn/octokit/blob/master/README.md\"\n }\n }\n put:\n description: Create a file.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n },\n \"_links\": {\n \"properties\": {\n \"self\": {\n \"type\": \"string\"\n },\n \"git\": {\n \"type\": \"string\"\n },\n \"html\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"commit\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"date\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"date\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n },\n \"type\": \"object\"\n }\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"path\": {\n \t\t\"description\": \"The content path.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"message\": {\n \t\t\"description\": \"The commit message.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"content\": {\n \t\t\"description\": \"The new file content, Base64 encoded.\",\n \t\t\"type\": \"string\"\n \t},\n \"sha\": {\n \"description\": \"Is included if we want to modify existing file. The blob SHA of the file being replaced.\",\n \"type\": \"string\"\n },\n \t\"branch\": {\n \t\t\"description\": \"The branch name. If not provided, uses the repository's default branch (usually master).\",\n \t\t\"type\": \"string\"\n \t},\n \t\"author\": {\n \t\t\"properties\": {\n \t\t\t\"name\": {\n \t\t\t\t\"description\": \"The name of the author of the commit.\",\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"email\": {\n \t\t\t\t\"description\": \"The email of the author of the commit\",\n \t\t\t\t\"type\": \"string\"\n \t\t\t}\n \t\t},\n \t\t\"type\": \"object\"\n \t},\n \t\"committer\": {\n \t\t\"properties\": {\n \t\t\t\"name\": {\n \t\t\t\t\"description\": \"The name of the committer of the commit.\",\n \t\t\t\t\"type\": \"string\"\n \t\t\t},\n \t\t\t\"email\": {\n \t\t\t\t\"description\": \"The email of the committer of the commit.\",\n \t\t\t\t\"type\": \"string\"\n \t\t\t}\n \t\t},\n \t\t\"type\": \"object\"\n \t}\n \t},\n \t\"required\": [ \"path\", \"message\", \"content\", \"branch\" ]\n }\n example: |\n {\n \"content\": {\n \"name\": \"hello.txt\",\n \"path\": \"notes/hello.txt\",\n \"sha\": \"95b966ae1c166bd92f8ae7d1c313e738c731dfc3\",\n \"size\": 9,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt\",\n \"html_url\": \"https://github.com/octocat/Hello-World/blob/master/notes/hello.txt\",\n \"git_url\": \"https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3\",\n \"type\": \"file\",\n \"_links\": {\n \"self\": \"https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt\",\n \"git\": \"https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3\",\n \"html\": \"https://github.com/octocat/Hello-World/blob/master/notes/hello.txt\"\n }\n },\n \"commit\": {\n \"sha\": \"7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"html_url\": \"https://github.com/octocat/Hello-World/git/commit/7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"author\": {\n \"date\": \"2010-04-10T14:10:01-07:00\",\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\"\n },\n \"committer\": {\n \"date\": \"2010-04-10T14:10:01-07:00\",\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\"\n },\n \"message\": \"my commit message\",\n \"tree\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb\",\n \"sha\": \"691272480426f78a0138979dd3ce63b77f706feb\"\n },\n \"parents\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5\",\n \"html_url\": \"https://github.com/octocat/Hello-World/git/commit/1acc419d4d6a9ce985db7be48c6349a0475975b5\",\n \"sha\": \"1acc419d4d6a9ce985db7be48c6349a0475975b5\"\n }\n ]\n }\n }\n delete:\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"path\": {\n \"description\": \"The content path.\",\n \"type\": \"string\"\n },\n \"message\": {\n \"description\": \"The commit message.\",\n \"type\": \"string\"\n },\n \"content\": {\n \"description\": \"The new file content, Base64 encoded.\",\n \"type\": \"string\"\n },\n \"sha\": {\n \"description\": \"The blob SHA of the file being removed.\",\n \"type\": \"string\"\n },\n \"branch\": {\n \"description\": \"The branch name. If not provided, uses the repository's default branch (usually master).\",\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"name\": {\n \"description\": \"The name of the author of the commit.\",\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"The email of the author of the commit\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"description\": \"The name of the committer of the commit.\",\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"The email of the committer of the commit.\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"required\": [ \"path\", \"message\", \"sha\" ]\n }\n description: |\n Delete a file.\n This method deletes a file in a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"content\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"date\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"date\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"sha\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"content\": null,\n \"commit\": {\n \"sha\": \"7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"html_url\": \"https://github.com/octocat/Hello-World/git/commit/7638417db6d59f3c431d3e1f261cc637155684cd\",\n \"author\": {\n \"date\": \"2010-04-10T14:10:01-07:00\",\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\"\n },\n \"committer\": {\n \"date\": \"2010-04-10T14:10:01-07:00\",\n \"name\": \"Scott Chacon\",\n \"email\": \"schacon@gmail.com\"\n },\n \"message\": \"my commit message\",\n \"tree\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb\",\n \"sha\": \"691272480426f78a0138979dd3ce63b77f706feb\"\n },\n \"parents\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5\",\n \"html_url\": \"https://github.com/octocat/Hello-World/git/commit/1acc419d4d6a9ce985db7be48c6349a0475975b5\",\n \"sha\": \"1acc419d4d6a9ce985db7be48c6349a0475975b5\"\n }\n ]\n }\n }\n /{archive_format}/{path}:\n type: base\n uriParameters:\n archive_format:\n enum:\n - tarball\n - zipball\n required: true\n path:\n description: Valid Git reference, defaults to 'master'.\n type: string\n get:\n description: |\n Get archive link.\n This method will return a 302 to a URL to download a tarball or zipball\n archive for a repository. Please make sure your HTTP framework is\n configured to follow redirects or you will need to use the Location header\n to make a second GET request.\n Note: For private repositories, these links are temporary and expire quickly.\n responses:\n 302:\n description: Found.\n /downloads:\n type: collection\n get:\n description: List downloads for a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"download_count\": {\n \"type\": \"integer\"\n },\n \"content_type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/downloads/1\",\n \"html_url\": \"https://github.com/repos/octocat/Hello-World/downloads/new_file.jpg\",\n \"id\": 1,\n \"name\": \"new_file.jpg\",\n \"description\": \"Description of your download\",\n \"size\": 1024,\n \"download_count\": 40,\n \"content_type\": \".jpg\"\n }\n post:\n description: |\n Create a new download (Part 1: Create the resource).\n For part 2 see http://developer.github.com/v3/repos/downloads/#create-a-new-download-part-2-upload-file-to-s3\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"size\": {\n \t\t\"description\": \"Size of file in bytes.\",\n \t\t\"type\": \"integer\"\n \t},\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"content_type\": {\n \t\t\"type\": \"string\"\n \t}\n \t},\n \t\"required\": [ \"name\", \"size\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"download_count\": {\n \"type\": \"integer\"\n },\n \"content_type\": {\n \"type\": \"string\"\n },\n \"policy\": {\n \"type\": \"string\"\n },\n \"signature\": {\n \"type\": \"string\"\n },\n \"bucket\": {\n \"type\": \"string\"\n },\n \"accesskeyid\": {\n \"type\": \"string\"\n },\n \"path\": {\n \"type\": \"string\"\n },\n \"acl\": {\n \"type\": \"string\"\n },\n \"expirationdate\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"prefix\": {\n \"type\": \"string\"\n },\n \"mime_type\": {\n \"type\": \"string\"\n },\n \"redirect\": {\n \"type\": \"boolean\"\n },\n \"s3_url\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/downloads/1\",\n \"html_url\": \"https://github.com/repos/octocat/Hello-World/downloads/new_file.jpg\",\n \"id\": 1,\n \"name\": \"new_file.jpg\",\n \"description\": \"Description of your download\",\n \"size\": 1024,\n \"download_count\": 40,\n \"content_type\": \".jpg\",\n \"policy\": \"ewogICAg...\",\n \"signature\": \"mwnFDC...\",\n \"bucket\": \"github\",\n \"accesskeyid\": \"1ABCDEFG...\",\n \"path\": \"downloads/octocat/Hello-World/new_file.jpg\",\n \"acl\": \"public-read\",\n \"expirationdate\": \"2011-04-14T16:00:49Z\",\n \"prefix\": \"downloads/octocat/Hello-World/\",\n \"mime_type\": \"image/jpeg\",\n \"redirect\": false,\n \"s3_url\": \"https://github.s3.amazonaws.com/\"\n }\n /{downloadId}:\n type: item\n uriParameters:\n downloadId:\n description: Id of the download.\n type: integer\n get:\n description: Get a single download.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"download_count\": {\n \"type\": \"integer\"\n },\n \"content_type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n delete:\n description: Delete a download.\n /forks:\n type: collection\n get:\n description: List forks.\n queryParameters:\n sort:\n enum:\n - newest\n - oldest\n - watchers\n default: newest\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n post:\n description: |\n Create a fork.\n Forking a Repository happens asynchronously. Therefore, you may have to wait\n a short period before accessing the git objects. If this takes longer than 5\n minutes, be sure to contact Support.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"organization\": {\n \t\t\t\"description\": \"Organization login. The repository will be forked into this organization.\",\n \t\t\t\"type\": \"string\"\n \t\t}\n \t}\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n /keys:\n type: collection\n get:\n description: Get list of keys.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n ]\n post:\n description: Create a key.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"title\": {\n \t\t\t\"type\": \"string\"\n \t\t},\n \t\t\"key\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n \t}\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n /{keyId}:\n uriParameters:\n keyId:\n description: Id of a key.\n type: integer\n type: item\n get:\n description: Get a key\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n patch:\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"title\": {\n \t\t\t\"type\": \"string\"\n \t\t},\n \t\t\"key\": {\n \t\t\t\"type\": \"string\"\n \t\t}\n \t}\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n description: Edit a key.\n delete:\n description: Delete a key.\n /hooks:\n type: collection\n get:\n description: Get list of hooks.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"events\": [\n {\n \"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n }\n ],\n \"type\": \"array\",\n \"active\": {\n \"type\": \"boolean\"\n },\n \"config\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"content_type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/hooks/1\",\n \"updated_at\": \"2011-09-06T20:39:23Z\",\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"name\": \"web\",\n \"events\": [\n \"push\",\n \"pull_request\"\n ],\n \"active\": true,\n \"config\": {\n \"url\": \"http://example.com\",\n \"content_type\": \"json\"\n },\n \"id\": 1\n }\n ]\n post:\n description: Create a hook.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"config\": {\n \t\t\"description\": \"A Hash containing key/value pairs to provide settings for this hook. Modifying this will replace the entire config object. These settings vary between the services and are defined in the github-services repo. Booleans are stored internally as \\\"1\\\" for true, and \\\"0\\\" for false. Any JSON true/false values will be converted automatically.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"events\": [\n \t\t{\n \t\t\t\"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n \t\t}\n \t],\n \t\"type\": \"array\",\n \t\"add_events\": [\n \t\t{\n \t\t\t\"description\": \"Determines a list of events to be added to the list of events that the Hook triggers for.\",\n \t\t\t\"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n \t\t}\n \t],\n \t\"type\": \"array\",\n \t\"remove_events\": [\n \t\t{\n \t\t\t\"description\": \"Determines a list of events to be removed from the list of events that the Hook triggers for.\",\n \t\t\t\"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n \t\t}\n \t],\n \t\"type\": \"array\",\n \t\"active\": {\n \t\t\"description\": \"Determines whether the hook is actually triggered on pushes.\",\n \t\t\"type\": \"boolean\"\n \t}\n \t}\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"events\": [\n {\n \"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n }\n ],\n \"type\": \"array\",\n \"active\": {\n \"type\": \"boolean\"\n },\n \"config\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"content_type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/hooks/1\",\n \"updated_at\": \"2011-09-06T20:39:23Z\",\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"name\": \"web\",\n \"events\": [\n \"push\",\n \"pull_request\"\n ],\n \"active\": true,\n \"config\": {\n \"url\": \"http://example.com\",\n \"content_type\": \"json\"\n },\n \"id\": 1\n }\n ]\n /{hookId}:\n uriParameters:\n hookId:\n description: Id of the hook.\n type: integer\n type: item\n get:\n description: Get single hook.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"events\": [\n {\n \"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n }\n ],\n \"type\": \"array\",\n \"active\": {\n \"type\": \"boolean\"\n },\n \"config\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"content_type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/hooks/1\",\n \"updated_at\": \"2011-09-06T20:39:23Z\",\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"name\": \"web\",\n \"events\": [\n \"push\",\n \"pull_request\"\n ],\n \"active\": true,\n \"config\": {\n \"url\": \"http://example.com\",\n \"content_type\": \"json\"\n },\n \"id\": 1\n }\n ]\n patch:\n description: Edit a hook.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"config\": {\n \t\t\"description\": \"A Hash containing key/value pairs to provide settings for this hook. Modifying this will replace the entire config object. These settings vary between the services and are defined in the github-services repo. Booleans are stored internally as \\\"1\\\" for true, and \\\"0\\\" for false. Any JSON true/false values will be converted automatically.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"events\": [\n \t\t{\n \t\t\t\"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n \t\t}\n \t],\n \t\"type\": \"array\",\n \t\"add_events\": [\n \t\t{\n \t\t\t\"description\": \"Determines a list of events to be added to the list of events that the Hook triggers for.\",\n \t\t\t\"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n \t\t}\n \t],\n \t\"type\": \"array\",\n \t\"remove_events\": [\n \t\t{\n \t\t\t\"description\": \"Determines a list of events to be removed from the list of events that the Hook triggers for.\",\n \t\t\t\"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n \t\t}\n \t],\n \t\"type\": \"array\",\n \t\"active\": {\n \t\t\"description\": \"Determines whether the hook is actually triggered on pushes.\",\n \t\t\"type\": \"boolean\"\n \t}\n \t}\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"events\": [\n {\n \"enum\": [\n \"push\",\n \"issues\",\n \"issue_comment\",\n \"commit_comment\",\n \"pull_request\",\n \"pull_request_review_comment\",\n \"gollum\",\n \"watch\",\n \"download\",\n \"fork\",\n \"fork_apply\",\n \"member\",\n \"public\",\n \"team_add\",\n \"status\"\n ]\n }\n ],\n \"type\": \"array\",\n \"active\": {\n \"type\": \"boolean\"\n },\n \"config\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"content_type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n }\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/hooks/1\",\n \"updated_at\": \"2011-09-06T20:39:23Z\",\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"name\": \"web\",\n \"events\": [\n \"push\",\n \"pull_request\"\n ],\n \"active\": true,\n \"config\": {\n \"url\": \"http://example.com\",\n \"content_type\": \"json\"\n },\n \"id\": 1\n }\n ]\n delete:\n description: Delete a hook.\n /tests:\n type: base\n post:\n description: |\n Test a push hook.\n This will trigger the hook with the latest push to the current repository\n if the hook is subscribed to push events. If the hook is not subscribed\n to push events, the server will respond with 204 but no test POST will\n be generated.\n Note: Previously /repos/:owner/:repo/hooks/:id/test\n responses:\n 204:\n description: Hook is triggered.\n /merges:\n type: base\n post:\n description: Perform a merge.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"base\": {\n \t\t\"description\": \"The name of the base branch that the head will be merged into.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"head\": {\n \t\t\"description\": \"The head to merge. This can be a branch name or a commit SHA1.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"commit_message\": {\n \t\t\"description\": \"Commit message to use for the merge commit. If omitted, a default message will be used.\",\n \t\t\"type\": \"string\"\n \t}\n \t},\n \t\"required\": [ \"base\", \"head\" ]\n }\n responses:\n 201:\n description: Successful Response (The resulting merge commit)\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"commit\": {\n \"properties\": {\n \"author\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"date\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"message\": {\n \"type\": \"string\"\n },\n \"tree\": {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"comment_count\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"author\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"followers_url\": {\n \"type\": \"string\"\n },\n \"following_url\": {\n \"type\": \"string\"\n },\n \"gists_url\": {\n \"type\": \"string\"\n },\n \"starred_url\": {\n \"type\": \"string\"\n },\n \"subscriptions_url\": {\n \"type\": \"string\"\n },\n \"organizations_url\": {\n \"type\": \"string\"\n },\n \"repos_url\": {\n \"type\": \"string\"\n },\n \"events_url\": {\n \"type\": \"string\"\n },\n \"received_events_url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"committer\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"followers_url\": {\n \"type\": \"string\"\n },\n \"following_url\": {\n \"type\": \"string\"\n },\n \"gists_url\": {\n \"type\": \"string\"\n },\n \"starred_url\": {\n \"type\": \"string\"\n },\n \"subscriptions_url\": {\n \"type\": \"string\"\n },\n \"organizations_url\": {\n \"type\": \"string\"\n },\n \"repos_url\": {\n \"type\": \"string\"\n },\n \"events_url\": {\n \"type\": \"string\"\n },\n \"received_events_url\": {\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"parents\": [\n {\n \"properties\": {\n \"sha\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n }\n example: |\n {\n \"sha\": \"6dcb09b5b57875f334f61aebed695e2e4193db5e\",\n \"merged\": true,\n \"message\": \"Pull Request successfully merged\"\n }\n 204:\n description: No-op response (base already contains the head, nothing to merge)\n 409:\n description: Merge conflict response.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"message\": {\n \t\t\t\"description\": \"Error message\",\n \t\t\t\"type\": \"string\"\n \t\t}\n \t}\n }\n example: |\n {\n \"message\": \"Merge Conflict\"\n }\n 404:\n description: Missing base response or missing head response\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"message\": {\n \t\t\t\"description\": \"Error message\",\n \t\t\t\"type\": \"string\"\n \t\t}\n \t}\n }\n example: |\n {\n \"message\": \"Base does not exist\"\n }\n /statuses/{ref}:\n type: collection\n uriParameters:\n ref:\n description: |\n Ref to list the statuses from. It can be a SHA, a branch name, or a tag name.\n type: string\n get:\n description: List Statuses for a specific Ref.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"state\": {\n \"type\": \"string\"\n },\n \"target_url\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"created_at\": \"2012-07-20T01:19:13Z\",\n \"updated_at\": \"2012-07-20T01:19:13Z\",\n \"state\": \"success\",\n \"target_url\": \"https://ci.example.com/1000/output\",\n \"description\": \"Build has completed successfully\",\n \"id\": 1,\n \"url\": \"https://api.github.com/repos/octocat/example/statuses/1\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n }\n ]\n post:\n description: Create a Status.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"state\": {\n \t\t\"enum\": [\n \t\t\t\"pending\", \"success\", \"error\", \"failure\"\n \t\t]\n \t},\n \t\"target_url\": {\n \t\t\"description\": \"Target url to associate with this status. This URL will be linked from the GitHub UI to allow users to easily see the ?source' of the Status.\",\n \t\t\"type\": \"string\"\n \t},\n \t\"description\": {\n \t\t\"description\": \"Short description of the status\",\n \t\t\"type\": \"string\"\n \t}\n \t}\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"state\": {\n \"type\": \"string\"\n },\n \"target_url\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"created_at\": \"2012-07-20T01:19:13Z\",\n \"updated_at\": \"2012-07-20T01:19:13Z\",\n \"state\": \"success\",\n \"target_url\": \"https://ci.example.com/1000/output\",\n \"description\": \"Build has completed successfully\",\n \"id\": 1,\n \"url\": \"https://api.github.com/repos/octocat/example/statuses/1\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n }\n ]\n /stats:\n /contributors:\n type: collection\n get:\n description: Get contributors list with additions, deletions, and commit counts.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"author\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"total\": {\n \"description\": \"The Total number of commits authored by the contributor.\",\n \"type\": \"integer\"\n },\n \"weeks\": [\n {\n \"properties\": {\n \"w\": {\n \"description\": \"Start of the week.\",\n \"type\": \"string\"\n },\n \"a\": {\n \"description\": \"Number of additions.\",\n \"type\": \"integer\"\n },\n \"d\": {\n \"description\": \"Number of deletions.\",\n \"type\": \"integer\"\n },\n \"c\": {\n \"description\": \"Number of commits.\",\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\"\n }\n ]\n }\n example: |\n [\n {\n \"author\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"total\": 135,\n \"weeks\": [\n {\n \"w\": \"1367712000\",\n \"a\": 6898,\n \"d\": 77,\n \"c\": 10\n }\n ]\n }\n ]\n /commit_activity:\n type: collection\n get:\n description: |\n Get the last year of commit activity data.\n Returns the last year of commit activity grouped by week. The days array\n is a group of commits per day, starting on Sunday.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"days\": [\n {\n \"type\": \"integer\"\n }\n ],\n \"type\": \"array\",\n \"total\": {\n \"type\": \"integer\"\n },\n \"week\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"days\": [\n 0,\n 3,\n 26,\n 20,\n 39,\n 1,\n 0\n ],\n \"total\": 89,\n \"week\": 1336280400\n }\n ]\n /code_frequency:\n type: collection\n get:\n description: |\n Get the number of additions and deletions per week.\n Returns a weekly aggregate of the number of additions and deletions pushed\n to a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n \t{\n \t\t\"type\": \"integer\"\n \t}\n ]\n }\n example: |\n [\n [\n 1302998400,\n 1124,\n -435\n ]\n ]\n /participation:\n type: collection\n get:\n description: Get the weekly commit count for the repo owner and everyone else.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\t\"all\": [\n \t\t\t{\n \t\t\t\t\"type\": \"integer\"\n \t\t\t}\n \t\t],\n \t\t\"type\": \"array\",\n \t\t\"owner\": [\n \t\t\t{\n \t\t\t\t\"type\": \"integer\"\n \t\t\t}\n \t\t],\n \t\t\"type\": \"array\"\n \t}\n }\n example: |\n {\n \"all\": [\n 11,\n 21,\n 15,\n 2,\n 8,\n 1,\n 8,\n 23,\n 17,\n 21,\n 11,\n 10,\n 33,\n 91,\n 38,\n 34,\n 22,\n 23,\n 32,\n 3,\n 43,\n 87,\n 71,\n 18,\n 13,\n 5,\n 13,\n 16,\n 66,\n 27,\n 12,\n 45,\n 110,\n 117,\n 13,\n 8,\n 18,\n 9,\n 19,\n 26,\n 39,\n 12,\n 20,\n 31,\n 46,\n 91,\n 45,\n 10,\n 24,\n 9,\n 29,\n 7\n ],\n \"owner\": [\n 3,\n 2,\n 3,\n 0,\n 2,\n 0,\n 5,\n 14,\n 7,\n 9,\n 1,\n 5,\n 0,\n 48,\n 19,\n 2,\n 0,\n 1,\n 10,\n 2,\n 23,\n 40,\n 35,\n 8,\n 8,\n 2,\n 10,\n 6,\n 30,\n 0,\n 2,\n 9,\n 53,\n 104,\n 3,\n 3,\n 10,\n 4,\n 7,\n 11,\n 21,\n 4,\n 4,\n 22,\n 26,\n 63,\n 11,\n 2,\n 14,\n 1,\n 10,\n 3\n ]\n }\n /punch_card:\n type: collection\n get:\n description: |\n Get the number of commits per hour in each day.\n Each array contains the day number, hour number, and number of commits\n 0-6 Sunday - Saturday\n 0-23 Hour of day\n Number of commits\n\n For example, [2, 14, 25] indicates that there were 25 total commits, during\n the 2.00pm hour on Tuesdays. All times are based on the time zone of\n individual commits.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"\": [\n {\n \"type\": \"integer\"\n }\n ]\n }\n ]\n }\n example: |\n [\n [\n 0,\n 0,\n 5\n ],\n [\n 0,\n 1,\n 43\n ],\n [\n 0,\n 2,\n 21\n ]\n ]\n/user:\n type: item\n get:\n description: Get the authenticated user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"company\": {\n \"type\": \"string\"\n },\n \"blog\": {\n \"type\": \"string\"\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"hireable\": {\n \"type\": \"boolean\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"public_repos\": {\n \"type\": \"integer\"\n },\n \"public_gists\": {\n \"type\": \"integer\"\n },\n \"followers\": {\n \"type\": \"integer\"\n },\n \"following\": {\n \"type\": \"integer\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n },\n \"total_private_repos\": {\n \"type\": \"integer\"\n },\n \"owned_private_repos\": {\n \"type\": \"integer\"\n },\n \"private_gists\": {\n \"type\": \"integer\"\n },\n \"disk_usage\": {\n \"type\": \"integer\"\n },\n \"collaborators\": {\n \"type\": \"integer\"\n },\n \"plan\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"space\": {\n \"type\": \"integer\"\n },\n \"collaborators\": {\n \"type\": \"integer\"\n },\n \"private_repos\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"name\": \"monalisa octocat\",\n \"company\": \"GitHub\",\n \"blog\": \"https://github.com/blog\",\n \"location\": \"San Francisco\",\n \"email\": \"octocat@github.com\",\n \"hireable\": false,\n \"bio\": \"There once was...\",\n \"public_repos\": 2,\n \"public_gists\": 1,\n \"followers\": 20,\n \"following\": 0,\n \"html_url\": \"https://github.com/octocat\",\n \"created_at\": \"2008-01-14T04:33:35Z\",\n \"type\": \"User\",\n \"total_private_repos\": 100,\n \"owned_private_repos\": 100,\n \"private_gists\": 81,\n \"disk_usage\": 10000,\n \"collaborators\": 8,\n \"plan\": {\n \"name\": \"Medium\",\n \"space\": 400,\n \"collaborators\": 10,\n \"private_repos\": 20\n }\n }\n patch:\n description: Update the authenticated user.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"email\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"blog\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"company\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"location\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"hireable\": {\n \t\t\"type\": \"boolean\"\n \t},\n \t\"bio\": {\n \t\t\"type\": \"string\"\n \t}\n \t}\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"company\": {\n \"type\": \"string\"\n },\n \"blog\": {\n \"type\": \"string\"\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"type\": \"string\"\n },\n \"hireable\": {\n \"type\": \"boolean\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"public_repos\": {\n \"type\": \"integer\"\n },\n \"public_gists\": {\n \"type\": \"integer\"\n },\n \"followers\": {\n \"type\": \"integer\"\n },\n \"following\": {\n \"type\": \"integer\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n },\n \"total_private_repos\": {\n \"type\": \"integer\"\n },\n \"owned_private_repos\": {\n \"type\": \"integer\"\n },\n \"private_gists\": {\n \"type\": \"integer\"\n },\n \"disk_usage\": {\n \"type\": \"integer\"\n },\n \"collaborators\": {\n \"type\": \"integer\"\n },\n \"plan\": {\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"space\": {\n \"type\": \"integer\"\n },\n \"collaborators\": {\n \"type\": \"integer\"\n },\n \"private_repos\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n }\n }\n example: |\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"name\": \"monalisa octocat\",\n \"company\": \"GitHub\",\n \"blog\": \"https://github.com/blog\",\n \"location\": \"San Francisco\",\n \"email\": \"octocat@github.com\",\n \"hireable\": false,\n \"bio\": \"There once was...\",\n \"public_repos\": 2,\n \"public_gists\": 1,\n \"followers\": 20,\n \"following\": 0,\n \"html_url\": \"https://github.com/octocat\",\n \"created_at\": \"2008-01-14T04:33:35Z\",\n \"type\": \"User\",\n \"total_private_repos\": 100,\n \"owned_private_repos\": 100,\n \"private_gists\": 81,\n \"disk_usage\": 10000,\n \"collaborators\": 8,\n \"plan\": {\n \"name\": \"Medium\",\n \"space\": 400,\n \"collaborators\": 10,\n \"private_repos\": 20\n }\n }\n /orgs:\n type: collection\n get:\n description: List public and private organizations for the authenticated user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n }\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"github\",\n \"id\": 1,\n \"url\": \"https://api.github.com/orgs/github\",\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\"\n }\n ]\n # Other\n /{userId}:\n type: collection\n uriParameters:\n userId:\n type: integer\n get:\n securedBy: [ oauth_2_0, null ]\n description: Get a single user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"company\": {\n \"type\": \"string\"\n },\n \"blog\": {\n \"type\": \"string\"\n },\n \"location\": {\n \"type\": \"string\"\n },\n \"email\": {\n \"description\": \"Note: The returned email is the user's publicly visible email address (or null if the user has not specified a public email address in their profile).\",\n \"type\": \"string\"\n },\n \"hireable\": {\n \"type\": \"boolean\"\n },\n \"bio\": {\n \"type\": \"string\"\n },\n \"public_repos\": {\n \"type\": \"integer\"\n },\n \"public_gists\": {\n \"type\": \"integer\"\n },\n \"followers\": {\n \"type\": \"integer\"\n },\n \"following\": {\n \"type\": \"integer\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"type\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\",\n \"name\": \"monalisa octocat\",\n \"company\": \"GitHub\",\n \"blog\": \"https://github.com/blog\",\n \"location\": \"San Francisco\",\n \"email\": \"octocat@github.com\",\n \"hireable\": false,\n \"bio\": \"There once was...\",\n \"public_repos\": 2,\n \"public_gists\": 1,\n \"followers\": 20,\n \"following\": 0,\n \"html_url\": \"https://github.com/octocat\",\n \"created_at\": \"2008-01-14T04:33:35Z\",\n \"type\": \"User\"\n }\n # Received events\n /received_events:\n type: collection\n get:\n description: List events that a user has received.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n /public:\n type: collection\n get:\n description: List public events that a user has received.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n # Orgs\n /orgs:\n type: collection\n get:\n description: List all public organizations for a user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n }\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"github\",\n \"id\": 1,\n \"url\": \"https://api.github.com/orgs/github\",\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\"\n }\n ]\n /events:\n type: collection\n get:\n description: |\n List events performed by a user.\n If you are authenticated as the given user, you will see your private events.\n Otherwise, you'll only see public events.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n # Public\n /public:\n type: collection\n get:\n description: List public events performed by a user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n # Orgs events\n /orgs/{orgId}:\n uriParameters:\n orgId:\n type: integer\n type: collection\n get:\n description: List events for an organization.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n /starred:\n type: collection\n get:\n description: List repositories being starred.\n queryParameters:\n sort:\n enum:\n - created\n - updated\n default: created\n direction:\n enum:\n - asc\n - desc\n default: desc\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n /subscriptions:\n type: collection\n get:\n description: List repositories being watched by a user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"integer\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n /emails:\n type: collection\n get:\n description: |\n List email addresses for a user.\n In the final version of the API, this method will return an array of hashes\n with extended information for each email address indicating if the address\n has been verified and if it's the user's primary email address for GitHub.\n Until API v3 is finalized, use the application/vnd.github.v3 media type to\n get other response format.\n responses:\n 200:\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"type\": \"string\"\n }\n ]\n }\n example: |\n [\n \"octocat@github.com\",\n \"support@github.com\"\n ]\n application/vnd.github.v3:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"properties\": {\n \"email\": {\n \"type\": \"string\"\n },\n \"verified\": {\n \"type\": \"boolean\"\n },\n \"primary\": {\n \"type\": \"boolean\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"email\": \"octocat@github.com\",\n \"verified\": true,\n \"primary\": true\n }\n ]\n post:\n description: |\n Add email address(es).\n You can post a single email address or an array of addresses.\n delete:\n description: |\n Delete email address(es).\n You can include a single email address or an array of addresses.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"type\": \"string\"\n }\n ]\n }\n /following:\n type: collection\n get:\n description: List who the authenticated user is following.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n /{userId}:\n uriParameters:\n userId:\n type: integer\n type: base\n get:\n description: Check if you are following a user.\n responses:\n 204:\n description: Response if you are following this user.\n 404:\n description: Response if you are not following this user.\n put:\n description: |\n Follow a user.\n Following a user requires the user to be logged in and authenticated with\n basic auth or OAuth with the user:follow scope.\n responses:\n 204:\n description: You are now following the user.\n delete:\n description: |\n Unfollow a user.\n Unfollowing a user requires the user to be logged in and authenticated with\n basic auth or OAuth with the user:follow scope.\n responses:\n 204:\n description: User unfollowed.\n /keys:\n type: collection\n get:\n description: |\n List your public keys.\n Lists the current user's keys. Management of public keys via the API requires\n that you are authenticated through basic auth, or OAuth with the 'user' scope.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n ]\n post:\n description: Create a public key.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"title\": {\n \"type\": \"string\"\n },\n \"key\": {\n \"type\": \"string\"\n }\n }\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n /{keyId}:\n uriParameters:\n keyId:\n type: integer\n type: item\n get:\n description: Get a single public key.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n patch:\n description: Update a public key.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"title\": {\n \"type\": \"string\"\n },\n \"key\": {\n \"type\": \"string\"\n }\n }\n }\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\",\n \"url\": \"https://api.github.com/user/keys/1\",\n \"title\": \"octocat@octomac\"\n }\n delete:\n description: Delete a public key.\n /starred:\n type: collection\n get:\n description: List repositories being starred by the authenticated user.\n queryParameters:\n sort:\n enum:\n - created\n - updated\n default: created\n direction:\n enum:\n - asc\n - desc\n default: desc\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n /{ownerId}/{repoId}:\n type: base\n get:\n description: Check if you are starring a repository.\n responses:\n 204:\n description: This repository is starred by you.\n 404:\n description: This repository is not starred by you.\n put:\n description: Star a repository.\n responses:\n 204:\n description: Repository starred.\n delete:\n description: Unstar a repository\n responses:\n 204:\n description: Unstarred.\n /subscriptions:\n type: collection\n get:\n description: List repositories being watched by the authenticated user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"integer\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": false,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n /{ownerId}/{repoId}:\n type: base\n uriParameters:\n ownerId:\n description: Id of the owner.\n type: integer\n repoId:\n description: Id of repository.\n type: integer\n get:\n description: Check if you are watching a repository.\n responses:\n 204:\n description: Repository is watched by you.\n 404:\n description: Repository is not watched by you.\n put:\n description: Watch a repository.\n responses:\n 204:\n description: Repository is watched.\n delete:\n description: Stop watching a repository\n responses:\n 204:\n description: Unwatched.\n /issues:\n type: collection\n get:\n is: [ filterable ]\n description: |\n List issues.\n List all issues across owned and member repositories for the authenticated\n user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"issues\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"body\": {\n \"type\": \"string\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"labels\": [\n {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"color\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ],\n \"type\": \"array\",\n \"assignee\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"milestone\": {\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"number\": {\n \"type\": \"integer\"\n },\n \"state\": {\n \"enum\": [\n \"open\",\n \"closed\"\n ]\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"creator\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"closed_issues\": {\n \"type\": \"integer\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"due_on\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"pull_request\": {\n \"properties\": {\n \"html_url\": {\n \"type\": \"string\"\n },\n \"diff_url\": {\n \"type\": \"string\"\n },\n \"patch_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"closed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/issues/1347\",\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"number\": 1347,\n \"state\": \"open\",\n \"title\": \"Found a bug\",\n \"body\": \"I'm having a problem with this.\",\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"labels\": [\n {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/labels/bug\",\n \"name\": \"bug\",\n \"color\": \"f29513\"\n }\n ],\n \"assignee\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"milestone\": {\n \"url\": \"https://api.github.com/repos/octocat/Hello-World/milestones/1\",\n \"number\": 1,\n \"state\": \"open\",\n \"title\": \"v1.0\",\n \"description\": \"\",\n \"creator\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"open_issues\": 4,\n \"closed_issues\": 8,\n \"created_at\": \"2011-04-10T20:09:31Z\",\n \"due_on\": null\n },\n \"comments\": 0,\n \"pull_request\": {\n \"html_url\": \"https://github.com/octocat/Hello-World/issues/1347\",\n \"diff_url\": \"https://github.com/octocat/Hello-World/issues/1347.diff\",\n \"patch_url\": \"https://github.com/octocat/Hello-World/issues/1347.patch\"\n },\n \"closed_at\": null,\n \"created_at\": \"2011-04-22T13:33:48Z\",\n \"updated_at\": \"2011-04-22T13:33:48Z\"\n }\n ]\n /repos:\n type: collection\n get:\n description: |\n List repositories for the authenticated user. Note that this does not include\n repositories owned by organizations which the user can access. You can list\n user organizations and list organization repositories separately.\n queryParameters:\n type:\n enum:\n - all\n - public\n - private\n - forks\n - sources\n - member\n default: all\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n post:\n description: |\n Create a new repository for the authenticated user. OAuth users must supply\n repo scope.\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \t\"name\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"description\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"homepage\": {\n \t\t\"type\": \"string\"\n \t},\n \t\"private\": {\n \t\t\"description\": \"True to create a private repository, false to create a public one. Creating private repositories requires a paid GitHub account.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_issues\": {\n \t\t\"description\": \"True to enable issues for this repository, false to disable them. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_wiki\": {\n \t\t\"description\": \"True to enable the wiki for this repository, false to disable it. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"has_downloads\": {\n \t\t\"description\": \"True to enable downloads for this repository, false to disable them. Default is true.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"team_id\": {\n \t\t\"description\": \"The id of the team that will be granted access to this repository. This is only valid when creating a repo in an organization.\",\n \t\t\"type\": \"integer\"\n \t},\n \t\"auto_init\": {\n \t\t\"description\": \"True to create an initial commit with empty README. Default is false.\",\n \t\t\"type\": \"boolean\"\n \t},\n \t\"gitignore_template\": {\n \t\t\"description\": \"Desired language or platform .gitignore template to apply. Use the name of the template without the extension. For example, \\\"Haskell\\\" Ignored if auto_init parameter is not provided. \",\n \t\t\"type\": \"string\"\n \t}\n },\n \"required\": [ \"name\" ]\n }\n responses:\n 201:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n/users:\n type: collection\n get:\n description: |\n Get all users.\n This provides a dump of every user, in the order that they signed up for GitHub.\n Note: Pagination is powered exclusively by the since parameter. Use the Link\n header to get the URL for the next page of users.\n queryParameters:\n since:\n description: The integer ID of the last User that you've seen.\n type: integer\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n /{userId}:\n uriParameters:\n userId:\n type: integer\n type: collection\n get:\n description: List a user's followers.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"list\": [\n {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n }\n ]\n # Followers\n /following/{targetUserId}:\n uriParameters:\n targetUserId:\n type: integer\n type: base\n get:\n description: Check if one user follows another.\n responses:\n 204:\n description: Response if user follows target user.\n 404:\n description: Response if user does not follow target user.\n # Keys\n /keys:\n type: collection\n get:\n description: |\n List public keys for a user.\n Lists the verified public keys for a user. This is accessible by anyone.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"id\": {\n \"type\": \"integer\"\n },\n \"key\": {\n \"type\": \"string\"\n }\n }\n ]\n }\n example: |\n [\n {\n \"id\": 1,\n \"key\": \"ssh-rsa AAA...\"\n }\n ]\n # Gists\n /gists:\n type: collection\n get:\n securedBy: [ null, oauth_2_0 ]\n description: List a user's gists.\n queryParameters:\n since:\n description: |\n Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\n Only gists updated at or after this time are returned.\n type: string\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"gists\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"user\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"files\": {\n \"properties\": {\n \"ring.erl\": {\n \"properties\": {\n \"size\": {\n \"type\": \"integer\"\n },\n \"filename\": {\n \"type\": \"string\"\n },\n \"raw_url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n },\n \"type\": \"object\"\n },\n \"comments\": {\n \"type\": \"integer\"\n },\n \"comments_url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"git_pull_url\": {\n \"type\": \"string\"\n },\n \"git_push_url\": {\n \"type\": \"string\"\n },\n \"created_at\": {\n \"type\": \"string\"\n }\n }\n }\n ]\n }\n example: |\n [\n {\n \"url\": \"https://api.github.com/gists/20c98223d9b59e1d48e5\",\n \"id\": \"1\",\n \"description\": \"description of gist\",\n \"public\": true,\n \"user\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"files\": {\n \"ring.erl\": {\n \"size\": 932,\n \"filename\": \"ring.erl\",\n \"raw_url\": \"https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl\"\n }\n },\n \"comments\": 0,\n \"comments_url\": \"https://api.github.com/gists/19d18b30e8af75090307/comments/\",\n \"html_url\": \"https://gist.github.com/1\",\n \"git_pull_url\": \"git://gist.github.com/1.git\",\n \"git_push_url\": \"git@gist.github.com:1.git\",\n \"created_at\": \"2010-04-14T02:15:15Z\"\n }\n ]\n /orgs:\n type: collection\n get:\n description: List all public organizations for a user.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n }\n }\n ]\n }\n example: |\n [\n {\n \"login\": \"github\",\n \"id\": 1,\n \"url\": \"https://api.github.com/orgs/github\",\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\"\n }\n ]\n /repos:\n type: collection\n get:\n description: List public repositories for the specified user.\n queryParameters:\n type:\n enum:\n - all\n - public\n - private\n - forks\n - sources\n - member\n default: all\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"\": [\n {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"owner\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"full_name\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"private\": {\n \"type\": \"boolean\"\n },\n \"fork\": {\n \"type\": \"boolean\"\n },\n \"url\": {\n \"type\": \"string\"\n },\n \"html_url\": {\n \"type\": \"string\"\n },\n \"clone_url\": {\n \"type\": \"string\"\n },\n \"git_url\": {\n \"type\": \"string\"\n },\n \"ssh_url\": {\n \"type\": \"string\"\n },\n \"svn_url\": {\n \"type\": \"string\"\n },\n \"mirror_url\": {\n \"type\": \"string\"\n },\n \"homepage\": {\n \"type\": \"string\"\n },\n \"language\": {\n \"type\": \"string\"\n },\n \"forks\": {\n \"type\": \"integer\"\n },\n \"forks_count\": {\n \"type\": \"integer\"\n },\n \"watchers\": {\n \"type\": \"integer\"\n },\n \"watchers_count\": {\n \"type\": \"integer\"\n },\n \"size\": {\n \"type\": \"integer\"\n },\n \"master_branch\": {\n \"type\": \"string\"\n },\n \"open_issues\": {\n \"type\": \"integer\"\n },\n \"open_issues_count\": {\n \"type\": \"integer\"\n },\n \"pushed_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"created_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n },\n \"updated_at\": {\n \"description\": \"ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ\",\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n }\n example: |\n [\n {\n \"id\": 1296269,\n \"owner\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"name\": \"Hello-World\",\n \"full_name\": \"octocat/Hello-World\",\n \"description\": \"This your first repo!\",\n \"private\": false,\n \"fork\": true,\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\",\n \"html_url\": \"https://github.com/octocat/Hello-World\",\n \"clone_url\": \"https://github.com/octocat/Hello-World.git\",\n \"git_url\": \"git://github.com/octocat/Hello-World.git\",\n \"ssh_url\": \"git@github.com:octocat/Hello-World.git\",\n \"svn_url\": \"https://svn.github.com/octocat/Hello-World\",\n \"mirror_url\": \"git://git.example.com/octocat/Hello-World\",\n \"homepage\": \"https://github.com\",\n \"language\": null,\n \"forks\": 9,\n \"forks_count\": 9,\n \"watchers\": 80,\n \"watchers_count\": 80,\n \"size\": 108,\n \"master_branch\": \"master\",\n \"open_issues\": 0,\n \"open_issues_count\": 0,\n \"pushed_at\": \"2011-01-26T19:06:43Z\",\n \"created_at\": \"2011-01-26T19:01:12Z\",\n \"updated_at\": \"2011-01-26T19:14:43Z\"\n }\n ]\n/gitignore/templates:\n type: collection\n get:\n description: |\n Listing available templates.\n List all templates available to pass as an option when creating a repository.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"\": [\n \t{\n \t\t\"type\": \"string\"\n \t}\n ]\n }\n example: |\n [\n \"Actionscript\",\n \"Android\",\n \"AppceleratorTitanium\",\n \"Autotools\",\n \"Bancha\",\n \"C\",\n \"C \"\n ]\n /{language}:\n type: item\n uriParameters:\n language:\n type: string\n get:\n description: Get a single template.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"source\": {\n \"type\": \"string\"\n }\n }\n }\n example: |\n {\n \"name\": \"C\",\n \"source\": \"# Object files\\n*.o\\n\\n# Libraries\\n*.lib\\n*.a\\n\\n# Shared objects (inc. Windows DLLs)\\n*.dll\\n*.so\\n*.so.*\\n*.dylib\\n\\n# Executables\\n*.exe\\n*.out\\n*.app\\n\"\n }\n/markdown:\n type: base\n post:\n body:\n application/json:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"object\",\n \"properties\": {\n \"text\": {\n \"description\": \"The Markdown text to render\",\n \"type\": \"string\"\n },\n \"mode\": {\n \"enum\": [\n \"markdown\",\n \"gfm\"\n ]\n },\n \"context\": {\n \"description\": \"The repository context, only taken into account when rendering as gfm.\",\n \"type\": \"string\"\n }\n },\n \"required\": [\n \"text\"\n ]\n }\n responses:\n 200:\n body:\n text/html:\n example: |\n

Hello world github/linguist#1 cool, and #1!

\n /raw:\n type: base\n post:\n body:\n text/plain:\n example: |\n

Hello world github/linguist#1 cool, and #1!

\n responses:\n 200:\n body:\n text/html:\n example: |\n

Hello world github/linguist#1 cool, and #1!

\n/networks/{ownerId}/{repoId}/events:\n type: collection\n uriParameters:\n ownerId:\n description: Id of the owner.\n type: integer\n repoId:\n description: Id of repository.\n type: integer\n get:\n description: List public events for a network of repositories.\n responses:\n 200:\n body:\n schema: |\n {\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"type\": \"array\",\n \"properties\": [\n {\n \"properties\": {\n \"type\": {\n \"type\": \"string\"\n },\n \"public\": {\n \"type\": \"boolean\"\n },\n \"payload\": {\n \"properties\": {},\n \"type\": \"object\"\n },\n \"repo\": {\n \"properties\": {\n \"id\": {\n \"type\": \"integer\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"actor\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"org\": {\n \"properties\": {\n \"login\": {\n \"type\": \"string\"\n },\n \"id\": {\n \"type\": \"integer\"\n },\n \"avatar_url\": {\n \"type\": \"string\"\n },\n \"gravatar_id\": {\n \"type\": \"string\"\n },\n \"url\": {\n \"type\": \"string\"\n }\n },\n \"type\": \"object\"\n },\n \"created_at\": {\n \"type\": \"timestamp\"\n },\n \"id\": {\n \"type\": \"integer\"\n }\n },\n \"type\": \"object\"\n }\n ]\n }\n example: |\n [\n {\n \"type\": \"Event\",\n \"public\": true,\n \"payload\": {\n\n },\n \"repo\": {\n \"id\": 3,\n \"name\": \"octocat/Hello-World\",\n \"url\": \"https://api.github.com/repos/octocat/Hello-World\"\n },\n \"actor\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"org\": {\n \"login\": \"octocat\",\n \"id\": 1,\n \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\",\n \"gravatar_id\": \"somehexcode\",\n \"url\": \"https://api.github.com/users/octocat\"\n },\n \"created_at\": \"2011-09-06T17:26:27Z\",\n \"id\": \"12345\"\n }\n ]\n" }, { "path": "samples/notes/api.raml", "content": "#%RAML 0.8\ntitle: Notes Example API\nversion: v2\nmediaType: application/json\ndocumentation:\n - title: Overview\n content: This is an example of a simple API for a \"notes\" service\n/notes:\n description: A collection of notes\n get:\n description: List all notes, optionally filtered by a query string\n queryParameters:\n q:\n description: An optional search query to filter the results\n example: shopping\n responses:\n 200:\n body:\n text/json:\n example: |\n [ { \"id\": 1, \"title\": \"Buy some milk\", \"status\": \"done\" },\n { \"id\": 2, \"title\": \"Return sweater\", \"status\": \"overdue\", \"dueInDays\": -2 },\n { \"id\": 3, \"title\": \"Renew license\", \"status\": \"not done\", \"dueInDays\": 1 },\n { \"id\": 4, \"title\": \"Join gym\", \"status\": \"not done\", \"dueInDays\": 3 } ]\n post:\n description: Create a new note in the collection\n body:\n example: |\n { \"title\": \"Return sweater\", \"dueInDays\": -2 }\n headers:\n X-Tracking-Example:\n description: You can specify request headers like this\n enum: [ accounting, payroll, finance ]\n required: false # require it by changing this to true\n example: accounting\n responses:\n 201:\n headers:\n X-Powered-By:\n description: You can describe response headers like this\n example: RAML\n body:\n text/json:\n example: |\n {\n \"id\": 2,\n \"title\": \"Return sweater\",\n \"status\": \"overdue\",\n \"dueInDays\": -2\n }\n /{id}:\n description: A specific note, identified by its id\n uriParameters:\n id:\n description: The `id` of the specific note\n type: number\n example: 2\n get:\n description: Retrieve the specified note\n responses:\n 200:\n text/json:\n body:\n example: |\n {\n \"id\": 2,\n \"title\": \"Return sweater\",\n \"status\": \"overdue\",\n \"dueInDays\": -2\n }\n patch:\n description: Update the specified note (allowing partial information)\n body:\n text/json:\n example: |\n {\n \"title\": \"Exchange sweater\",\n \"dueInDays: 3\n }\n responses:\n 200:\n text/json:\n body:\n example: |\n {\n \"id\": 2,\n \"title\": \"Exchange sweater\",\n \"status\": \"not done\",\n \"dueInDays\": 3\n }\n delete:\n description: Remove the specified note\n responses:\n 204:\n" }, { "path": "samples/other_example.raml", "content": "#%RAML 0.8\ntitle: Notes Example API\nmediaType: application/json\ndocumentation:\n - title: Overview\n content: This is an example of a simple API for a \"notes\" service\n - title: Explanation In Depth\n content: Enjoy this\nbaseUri: /lala\nprotocols: [HTTP, HTTPS]\nschemas:\n - schema1: \"jsonStuff\"\n schema2: \"\"\n - schema3: \"another value\"\nuriParameters:\n communityDomain:\n displayName: Community Domain\n type: string\n communityPath:\n displayName: Community Path\n type: string\n pattern: ^[a-zA-Z0-9][-a-zA-Z0-9]*$\n minLength: 1\nbaseUriParameters:\n test:\n displayName: TEST PARAM\n description: a crazy description\n type: paramType\n pattern: regexpCRAZYNESS\n minLength: 10\n maxLength: 20\n minimum: 0.3\n maximum: 0.5\n repeat: true\n required: false\n default: \"default string\"\n example: 50\n enum: [ example, 4, 0.3 ]\n apiDomain:\n description: |\n The sub-domain at which the API is accessible. Most API calls are sent to https://api.dropbox.com\n enum: [ \"api\" ]\ntraits:\n - anothertrait:\n usage: any way you want it\n description: why\n yetanothertrait:\n usage: don't use it\n description: honestly, don't\n - testtrait:\n usage: use this trait so happilly\n description: Traits RULE\n queryParameters:\n test:\n displayName: TEST PARAM\n description: a crazy description\n type: paramType\n pattern: regexpCRAZYNESS\n minLength: 10\n maxLength: 20\n minimum: 0.3\n maximum: 0.5\n repeat: true\n required: false\n default: \"default string\"\n example: 50\n enum: [ example, 4, 0.3 ]\n apiDomain:\n description: |\n The sub-domain at which the API is accessible. Most API calls are sent to https://api.dropbox.com\n enum: [ \"api\" ]\n body:\n application/json:\n schema: responseExampleJSON\n description: SDFSDF\n example: DFGD\n headers:\n header5:\n displayName: HEADER ONE\n header9:\n displayName: HEADER tWOOOOTWOTW\n application/xml:\n schema: responseExampleXML\n description: SDFSDF\n example: DFGD\n formParameters:\n formParam234:\n displayName: SO WORKS\n headers:\n header10:\n displayName: HEADER ONE\n header20:\n displayName: HEADER tWOOOOTWOTW\n headers:\n header1:\n displayName: HEADER ONE\n header2:\n displayName: HEADER tWOOOOTWOTW\n responses:\n 200:\n description: response200\n headers:\n header1:\n displayName: HEADER ONE\n header2:\n displayName: HEADER tWOOOOTWOTW\n body:\n application/json:\n schema: responseExampleJSON\n description: SDFSDF\n example: DFGD\n headers:\n header5:\n displayName: HEADER ONE\n header9:\n displayName: HEADER tWOOOOTWOTW\n application/xml:\n schema: responseExampleXML\n description: SDFSDF\n example: DFGD\n formParameters:\n formParam234:\n displayName: SO WORKS\n headers:\n header10:\n displayName: HEADER ONE\n header20:\n displayName: HEADER tWOOOOTWOTW\n 404:\n description: response404\n headers:\n header1:\n displayName: HEADER ONE\n header2:\n displayName: HEADER tWOOOOTWOTW\n body:\n application/json:\n schema: responseExampleJSON\n description: SDFSDF\n example: DFGD\n headers:\n header5:\n displayName: HEADER ONE\n header9:\n displayName: HEADER tWOOOOTWOTW\n application/xml:\n schema: responseExampleXML\n description: SDFSDF\n example: DFGD\n formParameters:\n formParam234:\n displayName: SO WORKS\n headers:\n header10:\n displayName: HEADER ONE\n header20:\n displayName: HEADER tWOOOOTWOTW\nresourceTypes:\n - rttest:\n description: test\n - one:\n description: hi\n two:\n description: bye\n get:\n description: test\n - collection:\n description: collectme\n get:\n responses:\n 200:\n body:\n application/json:\n schema:\n <> # e.g. users\n post:\n responses:\n 200:\n body:\n schema:\n <> # e.g. user\n image/jpeg:\n example: <> # e.g. user\n - member:\n description: memme\n get:\n responses:\n 200:\n body:\n schema:\n <> # e.g. user\n/jobs:\n displayName: Jobs\n post:\n description: Create a job\n body:\n text/xml:\n schema:\n schema1 # using a name from the root schemas\n" }, { "path": "samples/raml-tutorial-200/README.md", "content": "raml-tutorial-200\n=================\n\nStep by step 200 raml tutorial code\n" }, { "path": "samples/raml-tutorial-200/jukebox-api.raml", "content": "#%RAML 0.8\n---\ntitle: Jukebox API\nbaseUri: http://jukebox.api.com\nversion: v1\n\nschemas:\n - song: !include jukebox-include-song.schema\n - artist: !include jukebox-include-artist.schema\n - album: !include jukebox-include-album.schema\n\n\nresourceTypes:\n - readOnlyCollection:\n description: Collection of available <> in Jukebox.\n get:\n description: Get a list of <>.\n responses:\n 200:\n body:\n application/json:\n example: |\n <>\n - collection:\n description: Collection of available <> in Jukebox.\n get:\n description: Get a list of <>.\n responses:\n 200:\n body:\n application/json:\n example: |\n <>\n post:\n description: |\n Add a new <> to Jukebox.\n queryParameters:\n access_token:\n description: \"The access token provided by the authentication application\"\n example: AABBCCDD\n required: true\n type: string\n body:\n application/json:\n schema: <>\n example: |\n <>\n responses:\n 200:\n body:\n application/json:\n example: |\n { \"message\": \"The <> has been properly entered\" }\n - collection-item:\n description: Entity representing a <>\n get:\n description: |\n Get the <>\n with <>Id =\n {<>Id}\n responses:\n 200:\n body:\n application/json:\n example: |\n <>\n 404:\n body:\n application/json:\n example: |\n {\"message\": \"<> not found\" }\ntraits:\n - searchable:\n queryParameters:\n query:\n description: |\n JSON array [{\"field1\",\"value1\",\"operator1\"},{\"field2\",\"value2\",\"operator2\"},...,{\"fieldN\",\"valueN\",\"operatorN\"}] <>\n example: |\n <>\n - orderable:\n queryParameters:\n orderBy:\n description: |\n Order by field: <>\n type: string\n required: false\n order:\n description: Order\n enum: [desc, asc]\n default: desc\n required: false\n - pageable:\n queryParameters:\n offset:\n description: Skip over a number of elements by specifying an offset value for the query\n type: integer\n required: false\n example: 20\n default: 0\n limit:\n description: Limit the number of elements on the response\n type: integer\n required: false\n example: 80\n default: 10\n\n/songs:\n type:\n collection:\n exampleCollection: !include jukebox-include-songs.sample\n exampleItem: !include jukebox-include-song-new.sample\n get:\n is: [\n searchable: {description: \"with valid searchable fields: songTitle\", example: \"[\\\"songTitle\\\", \\\"Get L\\\", \\\"like\\\"]\"},\n orderable: {fieldsList: \"songTitle\"},\n pageable\n ]\n /{songId}:\n type:\n collection-item:\n exampleItem: !include jukebox-include-song-retrieve.sample\n /file-content:\n description: The file to be reproduced by the client\n get:\n description: Get the file content\n responses:\n 200:\n body:\n binary/octet-stream:\n example:\n !include heybulldog.mp3\n post:\n description: |\n Enters the file content for an existing song entity.\n\n The song needs to be created for the `/songs/{songId}/file-content` to exist.\n You can use this second resource to get and post the file to reproduce.\n\n Use the \"binary/octet-stream\" content type to specify the content from any consumer (excepting web-browsers).\n Use the \"multipart-form/data\" content type to upload a file which content will become the file-content\n body:\n binary/octet-stream:\n multipart/form-data:\n formParameters:\n file:\n description: The file to be uploaded\n required: true\n type: file\n/artists:\n type:\n collection:\n exampleCollection: !include jukebox-include-artists.sample\n exampleItem: !include jukebox-include-artist-new.sample\n get:\n is: [\n searchable: {description: \"with valid searchable fields: countryCode\", example: \"[\\\"countryCode\\\", \\\"FRA\\\", \\\"equals\\\"]\"},\n orderable: {fieldsList: \"artistName, nationality\"},\n pageable\n ]\n /{artistId}:\n type:\n collection-item:\n exampleItem: !include jukebox-include-artist-retrieve.sample\n /albums:\n type:\n readOnlyCollection:\n exampleCollection: !include jukebox-include-artist-albums.sample\n description: Collection of albulms belonging to the artist\n get:\n description: Get a specific artist's albums list\n is: [orderable: {fieldsList: \"albumName\"}, pageable]\n/albums:\n type:\n collection:\n exampleCollection: !include jukebox-include-albums.sample\n exampleItem: !include jukebox-include-album-new.sample\n get:\n is: [\n searchable: {description: \"with valid searchable fields: genreCode\", example: \"[\\\"genreCode\\\", \\\"ELE\\\", \\\"equals\\\"]\"},\n orderable: {fieldsList: \"albumName, genre\"},\n pageable\n ]\n /{albumId}:\n type:\n collection-item:\n exampleItem: !include jukebox-include-album-retrieve.sample\n /songs:\n type:\n readOnlyCollection:\n exampleCollection: |\n !include jukebox-include-album-songs.sample\n get:\n is: [orderable: {fieldsList: \"songTitle\"}]\n description: Get the list of songs for the album with `albumId = {albumId}`\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-album-new.sample", "content": "'{\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\",\n \"albumName\": \"Random Access Memories\",\n \"year\": \"2013\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/a7/Random_Access_Memories.jpg\",\n \"genreCode\": \"ELE\",\n \"artistId\": \"110e8300-e32b-41d4-a716-664400445500\"\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-album-retrieve.sample", "content": "'{\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\",\n \"albumName\": \"Random Access Memories\",\n \"year\": \"2013\",\n \"genre\": \"Electric Funk\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/a7/Random_Access_Memories.jpg\",\n \"genre\": {\n \"countryCode\": \"ELE\",\n \"countryName\": \"Electronict\"\n },\n \"songs\": [\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"songTitle\": \"Get Lucky\"\n },\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440111\",\n \"songTitle\": \"Loose yourself to dance\"\n },\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440222\",\n \"songTitle\": \"Gio sorgio by Moroder\"\n }\n ],\n \"artist\": {\n \"artistId\": \"110e8300-e32b-41d4-a716-664400445500\",\n \"artistName\": \"Daft Punk\",\n \"imageURL\": \"http://travelhymns.com/wp-content/uploads/2013/06/random-access-memories1.jpg\"\n }\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-album-songs.sample", "content": "[\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"songTitle\": \"Get Lucky\"\n },\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440111\",\n \"songTitle\": \"Loose yourself to dance\"\n },\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440222\",\n \"songTitle\": \"Gio sorgio by Moroder\"\n }\n]\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-album.schema", "content": "'{\n \"type\": \"object\",\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"id\": \"http://jsonschema.net\",\n \"required\":false,\n \"properties\": {\n \"albumId\": {\n \"type\": \"string\",\n \"required\":true,\n \"minLength\": 36,\n \"maxLength\": 36\n },\n \"albumName\": {\n \"type\": \"string\",\n \"required\": true\n },\n \"year\": {\n \"type\": \"string\",\n \"required\": false\n },\n \"iamgeURL\": {\n \"type\": \"string\",\n \"required\": false\n },\n \"genreCode\": {\n \"type\": \"string\",\n \"required\": true\n },\n \"artistId\": {\n \"type\": \"string\",\n \"required\":true,\n \"minLength\": 36,\n \"maxLength\": 36\n }\n }\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-albums.sample", "content": "'[\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\",\n \"albumName\": \"Random Access Memories\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/a7/Random_Access_Memories.jpg\",\n \"artistId\": \"110e8300-e32b-41d4-a716-664400445500\",\n \"genre\": {\n \"countryCode\": \"ELE\",\n \"countryName\": \"Electronict\"\n }\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-3123-66111d4de520\",\n \"albumName\": \"OK Computer\",\n \"imageURL\": \"http://www.greenplastic.com/dev/wp-content/uploads/2010/12/ok-computer.jpg\",\n \"artistId\": \"11032be3-41d4-4455-a716-664400a71600\",\n \"genre\": {\n \"countryCode\": \"ALT\",\n \"countryName\": \"Alternative Rock\"\n }\n },\n {\n \"albumId\": \"183100e3-cccc-4404-1111-63204d64coda\",\n \"albumName\": \"The Dark Side of the Moon\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/3/3b/Dark_Side_of_the_Moon.png\",\n \"artistId\": \"110e8300-e32b-41d4-a716-229932554400\",\n \"genre\": {\n \"countryCode\": \"PRO\",\n \"countryName\": \"Progressive Rock\"\n }\n }\n]'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-artist-albums.sample", "content": "'[\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\",\n \"albumName\": \"Random Access Memories\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/a7/Random_Access_Memories.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440551\",\n \"albumName\": \"TRON: Legacy R3CONF1GUR3D\",\n \"imageURL\": \"http://ecx.images-amazon.com/images/I/51Tvo-iArBL.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440552\",\n \"albumName\": \"TRON: Legacy\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/3/39/Tron_Legacy_Soundtrack.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440553\",\n \"albumName\": \"Alive\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/4/49/Daft_Punk_Alive_2007.JPG\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440554\",\n \"albumName\": \"Musique Vol. 1\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/ab/Musique_Vol._1_1993%E2%80%932005.png\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440555\",\n \"albumName\": \"Human After All\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/0/0d/Humanafterall.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440556\",\n \"albumName\": \"Daft Club\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/f/fc/Daftclub.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440557\",\n \"albumName\": \"Discovery\",\n \"imageURL\": \"http://ecx.images-amazon.com/images/I/71bsHTr6idL._SL1500_.jpg\"\n }\n]'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-artist-new.sample", "content": "'{\n \"artistName\": \"Daft Punk\",\n \"description\": \"French electronic music duo consisting of musicians Guy-Manuel de Homem-Christo and Thomas Bangalter\",\n \"imageURL\": \"http://travelhymns.com/wp-content/uploads/2013/06/random-access-memories1.jpg\"\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-artist-retrieve.sample", "content": "'{\n \"artistId\": \"110e8300-e32b-41d4-a716-664400445500\",\n \"artistName\": \"Daft Punk\",\n \"description\": \"French electronic music duo consisting of musicians Guy-Manuel de Homem-Christo and Thomas Bangalter\",\n \"imageURL\": \"http://travelhymns.com/wp-content/uploads/2013/06/random-access-memories1.jpg\",\n \"nationality\": {\n \"countryCode\": \"FRA\",\n \"countryName\": \"France\"\n },\n \"albums\": [\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\",\n \"albumName\": \"Random Access Memories\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/a7/Random_Access_Memories.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440551\",\n \"albumName\": \"TRON: Legacy R3CONF1GUR3D\",\n \"imageURL\": \"http://ecx.images-amazon.com/images/I/51Tvo-iArBL.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440552\",\n \"albumName\": \"TRON: Legacy\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/3/39/Tron_Legacy_Soundtrack.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440553\",\n \"albumName\": \"Alive\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/4/49/Daft_Punk_Alive_2007.JPG\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440554\",\n \"albumName\": \"Musique Vol. 1\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/ab/Musique_Vol._1_1993%E2%80%932005.png\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440555\",\n \"albumName\": \"Human After All\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/0/0d/Humanafterall.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440556\",\n \"albumName\": \"Daft Club\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/f/fc/Daftclub.jpg\"\n },\n {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440557\",\n \"albumName\": \"Discovery\",\n \"imageURL\": \"http://ecx.images-amazon.com/images/I/71bsHTr6idL._SL1500_.jpg\"\n }]\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-artist.schema", "content": "'{\n \"type\": \"object\",\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"id\": \"http://jsonschema.net\",\n \"required\":false,\n \"properties\": {\n \"artistName\": {\n \"type\": \"string\",\n \"required\":true\n },\n \"description\": {\n \"type\": \"string\",\n \"required\": false\n },\n \"imageURL\": {\n \"type\": \"string\",\n \"required\": false\n }\n }\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-artists.sample", "content": "'[{\n \"artistId\": \"110e8300-e32b-41d4-a716-664400445500\",\n \"artistName\": \"Daft Punk\",\n \"description\": \"French electronic music duo consisting of musicians Guy-Manuel de Homem-Christo and Thomas Bangalter\",\n \"imageURL\": \"http://travelhymns.com/wp-content/uploads/2013/06/random-access-memories1.jpg\",\n \"nationality\": {\n \"countryCode\": \"FRA\",\n \"countryName\": \"France\"\n }\n},\n{\n \"artistId\": \"110e8300-e32b-41d4-a716-229932554400\",\n \"artistName\": \"Pink Floyd\",\n \"description\": \"English rock band that achieved international acclaim with their progressive and psychedelic music.\",\n \"imageURL\": \"http://www.billboard.com/files/styles/promo_650/public/stylus/1251869-pink-floyd-reunions-617-409.jpg\",\n \"nationality\": {\n \"countryCode\": \"ENG\",\n \"countryName\": \"England\"\n }\n},\n{\n \"artistId\": \"11032be3-41d4-4455-a716-664400a71600\",\n \"artistName\": \"Radiohead\",\n \"description\": \" English rock band from Abingdon, Oxfordshire, formed in 1985\",\n \"imageURL\": \"http://www.wired.com/images_blogs/photos/uncategorized/2007/10/01/radiohead.jpg\",\n \"nationality\": {\n \"countryCode\": \"ENG\",\n \"countryName\": \"England\"\n }\n},\n]'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-song-new.sample", "content": "'{\n \"songId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"songTitle\": \"Get Lucky\",\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\"\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-song-retrieve.sample", "content": "'{\n \"songId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"songTitle\": \"Get Lucky\",\n \"duration\": \"6:07\",\n \"artist\": {\n \"artistId\": \"110e8300-e32b-41d4-a716-664400445500\",\n \"artistName\": \"Daft Punk\",\n \"imageURL\": \"http://travelhymns.com/wp-content/uploads/2013/06/random-access-memories1.jpg\"\n },\n \"album\": {\n \"albumId\": \"183100e3-0e2b-4404-a716-66104d440550\",\n \"albumName\": \"Random Access Memories\",\n \"imageURL\": \"http://upload.wikimedia.org/wikipedia/en/a/a7/Random_Access_Memories.jpg\"\n }\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-song.schema", "content": "'{\n \"type\": \"object\",\n \"$schema\": \"http://json-schema.org/draft-03/schema\",\n \"id\": \"http://jsonschema.net\",\n \"required\": true,\n \"properties\": {\n \"songId\": {\n \"type\": \"string\",\n \"required\": true,\n \"minLength\": 36,\n \"maxLength\": 36\n },\n \"songTitle\": {\n \"type\": \"string\",\n \"required\": true\n },\n \"albumId\": {\n \"type\": \"string\",\n \"required\": true,\n \"minLength\": 36,\n \"maxLength\": 36\n }\n }\n}'\n" }, { "path": "samples/raml-tutorial-200/jukebox-include-songs.sample", "content": "'[\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"songTitle\": \"Get Lucky\"\n },\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440111\",\n \"songTitle\": \"Loose yourself to dance\"\n },\n {\n \"songId\": \"550e8400-e29b-41d4-a716-446655440222\",\n \"songTitle\": \"Gio sorgio by Morodera\"\n }\n]'\n" }, { "path": "samples/sample_documentation.yaml", "content": "- title: Overview\n content: This is an example of a simple API for a \"notes\" service\n" }, { "path": "samples/simple_example.raml", "content": "#%RAML 0.8\ntitle: Notes Example API\n/jobs:\n displayName: Jobs\n post:\n description: Create a job\n/projects:\n displayName: Projects\n post:\n description: Create a project\n/resources:\n displayName: Resources\n type:\n searchableCollection:\n queryParamName: title\n fallbackParamName: digest_all_fields\n get:\n description: Get a resource\n is:\n - secured:\n tokenName: access_token\n paged:\n maxPages: 10\n post:\n description: Post a resource\n /{resourceId}:\n get:\n description: Get a resource ID\n put:\n description: Put resource ID\n delete:\n description: Delete a resource ID\n /yet_another:\n get:\n description: Yet another\nuriParameters:\n communityDomain:\n displayName: Community Domain\n type: string\n communityPath:\n displayName: Community Path\n type: string\n pattern: ^[a-zA-Z0-9][-a-zA-Z0-9]*$\n minLength: 1\nbaseUri: /lala\nprotocols: [HTTP, HTTPS]\ntraits:\n - secured:\n queryParameters:\n <>:\n description: A valid <> is required\n paged:\n queryParameters:\n numPages:\n description: The number of pages to return, not to exceed <>\nresourceTypes:\n - rttest:\n description: test\n - one:\n description: hi\n - auditableResource:\n post?:\n body:\n application/x-www-form-urlencoded:\n formParameters:\n createAuthority:\n description: |\n If the resource has a post method defined, expect a createAuthority\n property in its body\n delete?:\n body:\n multipart/form-data:\n formParameters:\n deleteAuthority:\n description: |\n If the resource has a delete method defined, expect a deleteAuthority\n property in its body\n - searchableCollection:\n get:\n queryParameters:\n <>:\n description: Return <> that have their <> matching the given value\n <>:\n description: If no values match the value given for <>, use <> instead\nsecuritySchemes:\n - oauth_2_0:\n description: |\n Dropbox supports OAuth 2.0 for authenticating all API requests.\n type: OAuth 2.0\n describedBy:\n headers:\n Authorization:\n description: |\n Used to send a valid OAuth 2 access token. Do not use\n with the \"access_token\" query string parameter.\n type: string\n queryParameters:\n access_token:\n description: |\n Used to send a valid OAuth 2 access token. Do not use together with\n the \"Authorization\" header\n type: string\n responses:\n 401:\n description: |\n Bad or expired token. This can happen if the user or Dropbox\n revoked or expired an access token. To fix, you should re-\n authenticate the user.\n 403:\n description: |\n Bad OAuth request (wrong consumer key, bad nonce, expired\n timestamp...). Unfortunately, re-authenticating the user won't help here.\n settings:\n authorizationUri: https://www.dropbox.com/1/oauth2/authorize\n accessTokenUri: https://api.dropbox.com/1/oauth2/token\n authorizationGrants: [ code, token ]\n - oauth_1_0:\n description: |\n OAuth 1.0 continues to be supported for all API requests, but OAuth 2.0 is now preferred.\n type: OAuth 1.0\n settings:\n requestTokenUri: https://api.dropbox.com/1/oauth/request_token\n authorizationUri: https://www.dropbox.com/1/oauth/authorize\n tokenCredentialsUri: https://api.dropbox.com/1/oauth/access_token\n - customHeader:\n description: |\n A custom\n" }, { "path": "types.go", "content": "// Copyright 2014 DoAT. All rights reserved.\n//\n// Redistribution and use in source and binary forms, with or without modification,\n// are permitted provided that the following conditions are met:\n//\n// 1. Redistributions of source code must retain the above copyright notice,\n// this list of conditions and the following disclaimer.\n//\n// 2. Redistributions in binary form must reproduce the above copyright notice,\n// this list of conditions and the following disclaimer in the documentation and/or\n// other materials provided with the distribution.\n//\n// THIS SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTIES WHATSOEVER.\n// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\n// THE IMPLIED WARRANTIES OF NON INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n// PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL DoAT OR CONTRIBUTORS\n// BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n// // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\n// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n//\n// The views and conclusions contained in the software and documentation are those of\n// the authors and should not be interpreted as representing official policies,\n// either expressed or implied, of DoAT.\n\n// This package contains the parser, validator and types that implement the\n// RAML specification, as documented here:\n// http://raml.org/spec.html\npackage raml\n\n// This file contains all of the RAML types.\n\n// TODO: We don't support !include of non-text files. RAML supports including\n// of many file types.\n\n// \"Any\" type, for our convenience\ntype Any interface{}\n\n// For extra clarity\ntype HTTPCode int // e.g. 200\ntype HTTPHeader string // e.g. Content-Length\n\n// The RAML Specification uses collections of named parameters for the\n// following properties: URI parameters, query string parameters, form\n// parameters, request bodies (depending on the media type), and request\n// and response headers.\n//\n// Some fields are pointers to distinguish Zero values and no values\ntype NamedParameter struct {\n\n\t// NOTE: We currently do not support Named Parameters With Multiple Types.\n\t// TODO: Add support for Named Parameters With Multiple Types. Should be\n\t// done sort of like the DefinitionChoice type.\n\n\t// The name of the Parameter, as defined by the type containing it.\n\tName string\n\t// TODO: Fill this during the post-processing phase\n\n\t// A friendly name used only for display or documentation purposes.\n\t// If displayName is not specified, it defaults to the property's key\n\tDisplayName string `yaml:\"displayName\"` // TODO: Auto-fill this\n\n\t// The intended use or meaning of the parameter\n\tDescription string\n\n\t// The primitive type of the parameter's resolved value. Can be:\n\t//\n\t// Type\tDescription\n\t// string\t- Value MUST be a string.\n\t// number\t- Value MUST be a number. Indicate floating point numbers as defined by YAML.\n\t// integer\t- Value MUST be an integer. Floating point numbers are not allowed. The integer type is a subset of the number type.\n\t// date\t\t- Value MUST be a string representation of a date as defined in RFC2616 Section 3.3 [RFC2616]. See Date Representations.\n\t// boolean\t- Value MUST be either the string \"true\" or \"false\" (without the quotes).\n\t// file\t\t- (Applicable only to Form properties) Value is a file. Client generators SHOULD use this type to handle file uploads correctly.\n\tType string\n\t// TODO: Verify the enum options\n\n\t// If the enum attribute is defined, API clients and servers MUST verify\n\t// that a parameter's value matches a value in the enum array\n\tEnum []Any `yaml:\",flow\"`\n\n\t// The pattern attribute is a regular expression that a parameter of type\n\t// string MUST match. Regular expressions MUST follow the regular\n\t// expression specification from ECMA 262/Perl 5. (string only)\n\tPattern *string\n\n\t// The minLength attribute specifies the parameter value's minimum number\n\t// of characters (string only)\n\tMinLength *int `yaml:\"minLength\"`\n\t// TODO: go-yaml doesn't raise an error when the minLength isn't an integer!\n\t// find out why and fix it.\n\n\t// The maxLength attribute specifies the parameter value's maximum number\n\t// of characters (string only)\n\tMaxLength *int `yaml:\"maxLength\"`\n\n\t// The minimum attribute specifies the parameter's minimum value. (numbers\n\t// only)\n\tMinimum *float64\n\n\t// The maximum attribute specifies the parameter's maximum value. (numbers\n\t// only)\n\tMaximum *float64\n\n\t// An example value for the property. This can be used, e.g., by\n\t// documentation generators to generate sample values for the property.\n\tExample string\n\n\t// The repeat attribute specifies that the parameter can be repeated,\n\t// i.e. the parameter can be used multiple times\n\tRepeat *bool // TODO: What does this mean?\n\n\t// Whether the parameter and its value MUST be present when a call is made.\n\t// In general, parameters are optional unless the required attribute is\n\t// included and its value set to 'true'.\n\t// For a URI parameter, its default value is 'true'.\n\tRequired bool\n\n\t// The default value to use for the property if the property is omitted or\n\t// its value is not specified\n\tDefault Any\n\n\tformat Any `ramlFormat:\"Named parameters must be mappings. Example: userId: {displayName: 'User ID', description: 'Used to identify the user.', type: 'integer', minimum: 1, example: 5}\"`\n}\n\n// Headers used in Methods and other types\ntype Header NamedParameter\n\n// All documentation of the API is of this format.\ntype Documentation struct {\n\tTitle string `yaml:\"title\"`\n\tContent string `yaml:\"content\"`\n}\n\n// Some method verbs expect the resource to be sent as a request body.\n// For example, to create a resource, the request must include the details of\n// the resource to create.\n// Resources CAN have alternate representations. For example, an API might\n// support both JSON and XML representations.\ntype Body struct {\n\tmediaType string `yaml:\"mediaType\"`\n\t// TODO: Fill this during the post-processing phase\n\n\t// The structure of a request or response body MAY be further specified\n\t// by the schema property under the appropriate media type.\n\t// The schema key CANNOT be specified if a body's media type is\n\t// application/x-www-form-urlencoded or multipart/form-data.\n\t// All parsers of RAML MUST be able to interpret JSON Schema [JSON_SCHEMA]\n\t// and XML Schema [XML_SCHEMA].\n\t// Alternatively, the value of the schema field MAY be the name of a schema\n\t// specified in the root-level schemas property\n\tSchema string `yaml:\"schema\"`\n\n\t// Brief description\n\tDescription string `yaml:\"description\"`\n\n\t// Example attribute to generate example invocations\n\tExample string `yaml:\"example\"`\n\n\t// Web forms REQUIRE special encoding and custom declaration.\n\t// If the API's media type is either application/x-www-form-urlencoded or\n\t// multipart/form-data, the formParameters property MUST specify the\n\t// name-value pairs that the API is expecting.\n\t// The formParameters property is a map in which the key is the name of\n\t// the web form parameter, and the value is itself a map the specifies\n\t// the web form parameter's attributes\n\tFormParameters map[string]NamedParameter `yaml:\"formParameters\"`\n\t// TODO: This doesn't make sense in response bodies.. separate types for\n\t// request and response body?\n\n\tHeaders map[HTTPHeader]Header `yaml:\"headers\"`\n}\n\n// Container of Body types, necessary because of technical reasons.\ntype Bodies struct {\n\n\t// Instead of using a simple map[HTTPHeader]Body for the body\n\t// property of the Response and Method, we use the Bodies struct. Why?\n\t// Because some RAML APIs don't use the MIMEType part, instead relying\n\t// on the mediaType property in the APIDefinition.\n\t// So, you might see:\n\t//\n\t// responses:\n\t// 200:\n\t// body:\n\t// example: \"some_example\" : \"123\"\n\t//\n\t// and also:\n\t//\n\t// responses:\n\t// 200:\n\t// body:\n\t// application/json:\n\t// example: |\n\t// {\n\t// \"some_example\" : \"123\"\n\t// }\n\n\t// As in the Body type.\n\tDefaultSchema string `yaml:\"schema\"`\n\n\t// As in the Body type.\n\tDefaultDescription string `yaml:\"description\"`\n\n\t// As in the Body type.\n\tDefaultExample string `yaml:\"example\"`\n\n\t// As in the Body type.\n\tDefaultFormParameters map[string]NamedParameter `yaml:\"formParameters\"`\n\n\t// TODO: Is this ever used? I think I put it here by mistake.\n\t//Headers map[HTTPHeader]Header `yaml:\"headers\"`\n\n\t// Resources CAN have alternate representations. For example, an API\n\t// might support both JSON and XML representations. This is the map\n\t// between MIME-type and the body definition related to it.\n\tForMIMEType map[string]Body `yaml:\",regexp:.*\"`\n\n\t// TODO: For APIs without a priori knowledge of the response types for\n\t// their responses, \"*/*\" MAY be used to indicate that responses that do\n\t// not matching other defined data types MUST be accepted. Processing\n\t// applications MUST match the most descriptive media type first if\n\t// \"*/*\" is used.\n}\n\n// Resource methods MAY have one or more responses.\ntype Response struct {\n\n\t// HTTP status code of the response\n\tHTTPCode HTTPCode\n\t// TODO: Fill this during the post-processing phase\n\n\t// Clarifies why the response was emitted. Response descriptions are\n\t// particularly useful for describing error conditions.\n\tDescription string\n\n\t// An API's methods may support custom header values in responses\n\tHeaders map[HTTPHeader]Header `yaml:\"headers\"`\n\n\t// TODO: API's may include the the placeholder token {?} in a header name\n\t// to indicate that any number of headers that conform to the specified\n\t// format can be sent in responses. This is particularly useful for\n\t// APIs that allow HTTP headers that conform to some naming convention\n\t// to send arbitrary, custom data.\n\n\t// Each response MAY contain a body property. Responses that can return\n\t// more than one response code MAY therefore have multiple bodies defined.\n\tBodies Bodies `yaml:\"body\"`\n}\n\n// A ResourceType/Trait/SecurityScheme choice contains the name of a\n// ResourceType/Trait/SecurityScheme as well as the parameters used to create\n// an instance of it.\n// Parameters MUST be of type string.\ntype DefinitionParameters map[string]string\ntype DefinitionChoice struct {\n\tName string\n\n\t// The definitions of resource types and traits MAY contain parameters,\n\t// whose values MUST be specified when applying the resource type or trait,\n\t// UNLESS the parameter corresponds to a reserved parameter name, in which\n\t// case its value is provided by the processing application.\n\t// Same goes for security schemes.\n\tParameters DefinitionParameters\n}\n\n// Unmarshal a node which MIGHT be a simple string or a\n// map[string]DefinitionParameters\nfunc (dc *DefinitionChoice) UnmarshalYAML(unmarshaler func(interface{}) error) error {\n\n\tsimpleDefinition := new(string)\n\tparameterizedDefinition := make(map[string]DefinitionParameters)\n\n\tvar err error\n\n\t// Unmarshal into a string\n\tif err = unmarshaler(simpleDefinition); err == nil {\n\t\tdc.Name = *simpleDefinition\n\t\tdc.Parameters = nil\n\t} else if err = unmarshaler(parameterizedDefinition); err == nil {\n\t\t// Didn't work? Now unmarshal into a map\n\t\tfor choice, params := range parameterizedDefinition {\n\t\t\tdc.Name = choice\n\t\t\tdc.Parameters = params\n\t\t}\n\t}\n\n\t// Still didn't work? Panic\n\n\treturn err\n}\n\n// A trait is a partial method definition that, like a method, can provide\n// method-level properties such as description, headers, query string\n// parameters, and responses. Methods that use one or more traits inherit\n// those traits' properties.\ntype Trait struct {\n\n\t// TODO: Parameters MUST be indicated in resource type and trait definitions\n\t// by double angle brackets (double chevrons) enclosing the parameter name;\n\t// for example, \"<>\".\n\n\t// TODO: Auto-fill the methodName parameter\n\n\t// TODO: In trait definitions, there is one reserved parameter name,\n\t// methodName, in addition to the resourcePath and resourcePathName. The\n\t// processing application MUST set the value of the methodName parameter\n\t// to the inheriting method's name. The processing application MUST set\n\t// the values of the resourcePath and resourcePathName parameters the same\n\t// as in resource type definitions.\n\n\t// TODO: Parameter values MAY further be transformed by applying one of\n\t// the following functions:\n\t// * The !singularize function MUST act on the value of the parameter\n\t// by a locale-specific singularization of its original value. The only\n\t// locale supported by this version of RAML is United States English.\n\t// * The !pluralize function MUST act on the value of the parameter by a\n\t// locale-specific pluralization of its original value. The only locale\n\t// supported by this version of RAML is United States English.\n\n\tName string\n\t// TODO: Fill this during the post-processing phase\n\n\t// The usage property of a resource type or trait is used to describe how\n\t// the resource type or trait should be used\n\tUsage string\n\n\t// Briefly describes what the method does to the resource\n\tDescription string\n\n\t// As in Method.\n\tBodies Bodies `yaml:\"body\"`\n\n\t// As in Method.\n\tHeaders map[HTTPHeader]Header `yaml:\"headers\"`\n\n\t// As in Method.\n\tResponses map[HTTPCode]Response `yaml:\"responses\"`\n\n\t// As in Method.\n\tQueryParameters map[string]NamedParameter `yaml:\"queryParameters\"`\n\n\t// As in Method.\n\tProtocols []string `yaml:\"protocols\"`\n\n\t// When defining resource types and traits, it can be useful to capture\n\t// patterns that manifest several levels below the inheriting resource or\n\t// method, without requiring the creation of the intermediate levels.\n\t// For example, a resource type definition may describe a body parameter\n\t// that will be used if the API defines a post method for that resource,\n\t// but the processing application should not create the post method itself.\n\t//\n\t// This optional structure key indicates that the value of the property\n\t// should be applied if the property name itself (without the question\n\t// mark) is already defined (whether explicitly or implicitly) at the\n\t// corresponding level in that resource or method.\n\tOptionalBodies Bodies `yaml:\"body?\"`\n\tOptionalHeaders map[HTTPHeader]Header `yaml:\"headers?\"`\n\tOptionalResponses map[HTTPCode]Response `yaml:\"responses?\"`\n\tOptionalQueryParameters map[string]NamedParameter `yaml:\"queryParameters?\"`\n}\n\n// Method that is part of a ResourceType. DIfferentiated from Traits since it\n// doesn't contain Usage, optional fields etc.\ntype ResourceTypeMethod struct {\n\tName string\n\t// TODO: Fill this during the post-processing phase\n\n\t// Briefly describes what the method does to the resource\n\tDescription string\n\n\t// As in Method.\n\tBodies Bodies `yaml:\"body\"`\n\t// TODO: Check - how does the mediaType play play here? What it do?\n\n\t// As in Method.\n\tHeaders map[HTTPHeader]Header `yaml:\"headers\"`\n\n\t// As in Method.\n\tResponses map[HTTPCode]Response `yaml:\"responses\"`\n\n\t// As in Method.\n\tQueryParameters map[string]NamedParameter `yaml:\"queryParameters\"`\n\n\t// As in Method.\n\tProtocols []string `yaml:\"protocols\"`\n}\n\n// Resource and method declarations are frequently repetitive. For example, if\n// an API requires OAuth authentication, the API definition must include the\n// access_token query string parameter (which is defined by the queryParameters\n// property) in all the API's resource method declarations.\n//\n// Moreover, there are many advantages to reusing patterns across multiple\n// resources and methods. For example, after defining a collection-type\n// resource's characteristics, that definition can be applied to multiple\n// resources. This use of patterns encouraging consistency and reduces\n// complexity for both servers and clients.\n//\n// A resource type is a partial resource definition that, like a resource, can\n// specify a description and methods and their properties. Resources that use\n// a resource type inherit its properties, such as its methods.\ntype ResourceType struct {\n\n\t// TODO: Auto-fill the resourcePath and resourcePathName parameters\n\t// Remove mediaTypeExtension.\n\n\t// TODO: Parameters MUST be indicated in resource type and trait definitions\n\t// by double angle brackets (double chevrons) enclosing the parameter name;\n\t// for example, \"<>\".\n\n\t// TODO: In resource type definitions, there are two reserved parameter\n\t// names: resourcePath and resourcePathName. The processing application\n\t// MUST set the values of these reserved parameters to the inheriting\n\t// resource's path (for example, \"/users\") and the part of the path\n\t// following the rightmost \"/\" (for example, \"users\"), respectively.\n\t// Processing applications MUST also omit the value of any\n\t// mediaTypeExtension found in the resource's URI when setting\n\t// resourcePath and resourcePathName.\n\n\t// TODO: Parameter values MAY further be transformed by applying one of\n\t// the following functions:\n\t// * The !singularize function MUST act on the value of the parameter\n\t// by a locale-specific singularization of its original value. The only\n\t// locale supported by this version of RAML is United States English.\n\t// * The !pluralize function MUST act on the value of the parameter by a\n\t// locale-specific pluralization of its original value. The only locale\n\t// supported by this version of RAML is United States English.\n\n\t// Name of the resource type\n\tName string\n\t// TODO: Fill this during the post-processing phase\n\n\t// The usage property of a resource type or trait is used to describe how\n\t// the resource type or trait should be used\n\tUsage string\n\n\t// Briefly describes what the resource type\n\tDescription string\n\n\t// As in Resource.\n\tUriParameters map[string]NamedParameter `yaml:\"uriParameters\"`\n\n\t// As in Resource.\n\tBaseUriParameters map[string]NamedParameter `yaml:\"baseUriParameters\"`\n\n\t// In a RESTful API, methods are operations that are performed on a\n\t// resource. A method MUST be one of the HTTP methods defined in the\n\t// HTTP version 1.1 specification [RFC2616] and its extension,\n\t// RFC5789 [RFC5789].\n\tGet *ResourceTypeMethod `yaml:\"get\"`\n\tHead *ResourceTypeMethod `yaml:\"head\"`\n\tPost *ResourceTypeMethod `yaml:\"post\"`\n\tPut *ResourceTypeMethod `yaml:\"put\"`\n\tDelete *ResourceTypeMethod `yaml:\"delete\"`\n\tPatch *ResourceTypeMethod `yaml:\"patch\"`\n\n\t// When defining resource types and traits, it can be useful to capture\n\t// patterns that manifest several levels below the inheriting resource or\n\t// method, without requiring the creation of the intermediate levels.\n\t// For example, a resource type definition may describe a body parameter\n\t// that will be used if the API defines a post method for that resource,\n\t// but the processing application should not create the post method itself.\n\t//\n\t// This optional structure key indicates that the value of the property\n\t// should be applied if the property name itself (without the question\n\t// mark) is already defined (whether explicitly or implicitly) at the\n\t// corresponding level in that resource or method.\n\tOptionalUriParameters map[string]NamedParameter `yaml:\"uriParameters?\"`\n\tOptionalBaseUriParameters map[string]NamedParameter `yaml:\"baseUriParameters?\"`\n\tOptionalGet *ResourceTypeMethod `yaml:\"get?\"`\n\tOptionalHead *ResourceTypeMethod `yaml:\"head?\"`\n\tOptionalPost *ResourceTypeMethod `yaml:\"post?\"`\n\tOptionalPut *ResourceTypeMethod `yaml:\"put?\"`\n\tOptionalDelete *ResourceTypeMethod `yaml:\"delete?\"`\n\tOptionalPatch *ResourceTypeMethod `yaml:\"patch?\"`\n}\n\n// A trait-like structure to a security scheme mechanism so as to extend\n// the mechanism, such as specifying response codes, HTTP headers or custom\n// documentation.\ntype SecuritySchemeMethod struct {\n\tBodies Bodies `yaml:\"body\"`\n\tHeaders map[HTTPHeader]Header `yaml:\"headers\"`\n\tResponses map[HTTPCode]Response `yaml:\"responses\"`\n\tQueryParameters map[string]NamedParameter `yaml:\"queryParameters\"`\n}\n\n// Most REST APIs have one or more mechanisms to secure data access, identify\n// requests, and determine access level and data visibility.\ntype SecurityScheme struct {\n\tName string\n\t// TODO: Fill this during the post-processing phase\n\n\t// Briefly describes the security scheme\n\tDescription string\n\n\t// The type attribute MAY be used to convey information about\n\t// authentication flows and mechanisms to processing applications\n\t// such as Documentation Generators and Client generators.\n\tType string\n\t// TODO: Verify that it is of the values accepted: \"OAuth 1.0\",\n\t// \"OAuth 2.0\", \"Basic Authentication\", \"Digest Authentication\",\n\t// \"x-{other}\"\n\n\t// The describedBy attribute MAY be used to apply a trait-like structure\n\t// to a security scheme mechanism so as to extend the mechanism, such as\n\t// specifying response codes, HTTP headers or custom documentation.\n\t// This extension allows API designers to describe security schemes.\n\t// As a best practice, even for standard security schemes, API designers\n\t// SHOULD describe the security schemes' required artifacts, such as\n\t// headers, URI parameters, and so on.\n\t// Including the security schemes' description completes an API's documentation.\n\tDescribedBy SecuritySchemeMethod\n\n\t// The settings attribute MAY be used to provide security schema-specific\n\t// information. Depending on the value of the type parameter, its attributes\n\t// can vary.\n\tSettings map[string]Any\n\t// TODO: Verify OAuth 1.0, 2.0 settings\n\t// TODO: Add to documentaiotn\n\n\t// If the scheme's type is x-other, API designers can use the properties\n\t// in this mapping to provide extra information to clients that understand\n\t// the x-other type.\n\tOther map[string]string\n}\n\n// Methods are operations that are performed on a resource\ntype Method struct {\n\tName string\n\t// TODO: Fill this during the post-processing phase\n\n\t// Briefly describes what the method does to the resource\n\tDescription string\n\n\t// Applying a securityScheme definition to a method overrides whichever\n\t// securityScheme has been defined at the root level. To indicate that\n\t// the method is protected using a specific security scheme, the method\n\t// MUST be defined by using the securedBy attribute\n\t// Custom parameters can be provided to the security scheme.\n\tSecuredBy []DefinitionChoice `yaml:\"securedBy\"`\n\t// TODO: To indicate that the method may be called without applying any\n\t// securityScheme, the method may be annotated with the null securityScheme.\n\n\t// The method's non-standard HTTP headers. The headers property is a map\n\t// in which the key is the name of the header, and the value is itself a\n\t// map specifying the header attributes.\n\tHeaders map[HTTPHeader]Header `yaml:\"headers\"`\n\t// TODO: Examples for headers are REQUIRED.\n\t// TODO: If the header name contains the placeholder token {*}, processing\n\t// applications MUST allow requests to send any number of headers that\n\t// conform to the format specified, with {*} replaced by 0 or more valid\n\t// header characters, and offer a way for implementations to add an\n\t// arbitrary number of such headers. This is particularly useful for APIs\n\t// that allow HTTP headers that conform to custom naming conventions to\n\t// send arbitrary, custom data.\n\n\t// A RESTful API method can be reached HTTP, HTTPS, or both.\n\t// A method can override an API's protocols value for that single method\n\t// by setting a different value for the fields.\n\tProtocols []string `yaml:\"protocols\"`\n\n\t// The queryParameters property is a map in which the key is the query\n\t// parameter's name, and the value is itself a map specifying the query\n\t// parameter's attributes\n\tQueryParameters map[string]NamedParameter `yaml:\"queryParameters\"`\n\n\t// Some method verbs expect the resource to be sent as a request body.\n\t// A method's body is defined in the body property as a hashmap, in which\n\t// the key MUST be a valid media type.\n\tBodies Bodies `yaml:\"body\"`\n\t// TODO: Check - how does the mediaType play play here? What it do?\n\n\t// Resource methods MAY have one or more responses. Responses MAY be\n\t// described using the description property, and MAY include example\n\t// attributes or schema properties.\n\t// Responses MUST be a map of one or more HTTP status codes, where each\n\t// status code itself is a map that describes that status code.\n\tResponses map[HTTPCode]Response `yaml:\"responses\"`\n\n\t// Methods may specify one or more traits from which they inherit using the\n\t// is property\n\tIs []DefinitionChoice `yaml:\"is\"`\n\t// TODO: Add support for inline traits?\n}\n\n// A resource is the conceptual mapping to an entity or set of entities.\ntype Resource struct {\n\n\t// Resources are identified by their relative URI, which MUST begin with\n\t// a slash (/).\n\tURI string\n\t// TODO: Fill this during the post-processing phase\n\n\t// A resource defined as a child property of another resource is called a\n\t// nested resource, and its property's key is its URI relative to its\n\t// parent resource's URI. If this is not nil, then this resource is a\n\t// child resource.\n\tParent *Resource\n\t// TODO: Fill this during the post-processing phase\n\n\t// A friendly name to the resource\n\tDisplayName string\n\n\t// Briefly describes the resource\n\tDescription string\n\n\t// A securityScheme may also be applied to a resource by using the\n\t// securedBy key, which is equivalent to applying the securityScheme to\n\t// all methods of this Resource.\n\t// Custom parameters can be provided to the security scheme.\n\tSecuredBy []DefinitionChoice `yaml:\"securedBy\"`\n\t// TODO: To indicate that the method may be called without applying any\n\t// securityScheme, the method may be annotated with the null securityScheme.\n\n\t// A resource or a method can override a base URI template's values.\n\t// This is useful to restrict or change the default or parameter selection\n\t// in the base URI. The baseUriParameters property MAY be used to override\n\t// any or all parameters defined at the root level baseUriParameters\n\t// property, as well as base URI parameters not specified at the root level.\n\t// In a resource structure of resources and nested resources with their\n\t// methods, the most specific baseUriParameter fully overrides any\n\t// baseUriParameter definition made before\n\tBaseUriParameters map[string]NamedParameter `yaml:\"baseUriParameters\"`\n\n\t// Template URIs containing URI parameters can be used to define a\n\t// resource's relative URI when it contains variable elements.\n\t// The values matched by URI parameters cannot contain slash (/) characters\n\tUriParameters map[string]NamedParameter `yaml:\"uriParameters\"`\n\n\t// TODO: If a URI parameter in a resource's relative URI is not explicitly\n\t// described in a uriParameters property for that resource, it MUST still\n\t// be treated as a URI parameter with defaults as specified in the Named\n\t// Parameters section of this specification. Its type is \"string\", it is\n\t// required, and its displayName is its name (i.e. without the surrounding\n\t// curly brackets [{] and [}]). In the example below, the top-level\n\t// resource has two URI parameters, \"folderId\" and \"fileId\n\n\t// TOOD: A special uriParameter, mediaTypeExtension, is a reserved\n\t// parameter. It may be specified explicitly in a uriParameters property\n\t// or not specified explicitly, but its meaning is reserved: it is used\n\t// by a client to specify that the body of the request or response be of\n\t// the associated media type. By convention, a value of .json is\n\t// equivalent to an Accept header of application/json and .xml is\n\t// equivalent to an Accept header of text/xml.\n\n\t// Resources may specify the resource type from which they inherit using\n\t// the type property. The resource type may be defined inline as the value\n\t// of the type property (directly or via an !include), or the value of\n\t// the type property may be the name of a resource type defined within\n\t// the root-level resourceTypes property.\n\t// NOTE: inline not currently supported.\n\tType *DefinitionChoice `yaml:\"type\"`\n\t// TODO: Add support for inline ResourceTypes\n\n\t// A resource may use the is property to apply the list of traits to all\n\t// its methods.\n\tIs []DefinitionChoice `yaml:\"is\"`\n\t// TODO: Add support for inline traits?\n\n\t// In a RESTful API, methods are operations that are performed on a\n\t// resource. A method MUST be one of the HTTP methods defined in the\n\t// HTTP version 1.1 specification [RFC2616] and its extension,\n\t// RFC5789 [RFC5789].\n\tGet *Method `yaml:\"get\"`\n\tHead *Method `yaml:\"head\"`\n\tPost *Method `yaml:\"post\"`\n\tPut *Method `yaml:\"put\"`\n\tDelete *Method `yaml:\"delete\"`\n\tPatch *Method `yaml:\"patch\"`\n\n\t// A resource defined as a child property of another resource is called a\n\t// nested resource, and its property's key is its URI relative to its\n\t// parent resource's URI.\n\tNested map[string]*Resource `yaml:\",regexp:/.*\"`\n}\n\n// TODO: Resource.GetBaseURIParameter --> includeds APIDefinition BURIParams..\n// TODO: Resource.GetAbsoluteURI\n\n// The API Definition describes the basic information of an API, such as its\n// title and base URI, and describes how to define common schema references.\ntype APIDefinition struct {\n\n\t// RAML 0.8\n\tRAMLVersion string `yaml:\"raml_version\"`\n\n\t// The title property is a short plain text description of the RESTful API.\n\t// The title property's value SHOULD be suitable for use as a title for the\n\t// contained user documentation\n\tTitle string `yaml:\"title\"`\n\n\t// If RAML API definition is targeted to a specific API version, it should\n\t// be noted here\n\tVersion string `yaml:\"version\"`\n\n\t// A RESTful API's resources are defined relative to the API's base URI.\n\t// If the baseUri value is a Level 1 Template URI, the following reserved\n\t// base URI parameters are available for replacement:\n\t//\n\t// version - The content of the version field.\n\tBaseUri string\n\t// TODO: If a URI template variable in the base URI is not explicitly\n\t// described in a baseUriParameters property, and is not specified in a\n\t// resource-level baseUriParameters property, it MUST still be treated as\n\t// a base URI parameter with defaults as specified in the Named Parameters\n\t// section of this specification. Its type is \"string\", it is required,\n\t// and its displayName is its name (i.e. without the surrounding curly\n\t// brackets [{] and [}]).\n\n\t// A resource or a method can override a base URI template's values.\n\t// This is useful to restrict or change the default or parameter selection\n\t// in the base URI. The baseUriParameters property MAY be used to override\n\t// any or all parameters defined at the root level baseUriParameters\n\t// property, as well as base URI parameters not specified at the root level.\n\t// In a resource structure of resources and nested resources with their\n\t// methods, the most specific baseUriParameter fully overrides any\n\t// baseUriParameter definition made before\n\tBaseUriParameters map[string]NamedParameter `yaml:\"baseUriParameters\"`\n\t// TODO: Generate these also from the baseUri\n\n\t// Level 1 URI custom parameters, which are useful in a variety of scenario.\n\t// URI parameters can be further defined by using the uriParameters\n\t// property. The use of uriParameters is OPTIONAL. The uriParameters\n\t// property MUST be a map in which each key MUST be the name of the URI\n\t// parameter as defined in the baseUri property. The uriParameters CANNOT\n\t// contain a key named version because it is a reserved URI parameter name.\n\tUriParameters map[string]NamedParameter `yaml:\"uriParameters\"`\n\n\t// A RESTful API can be reached HTTP, HTTPS, or both\n\tProtocols []string `yaml:\"protocols\"`\n\n\t// The media types returned by API responses, and expected from API\n\t// requests that accept a body, MAY be defaulted by specifying the\n\t// mediaType property.\n\t// The property's value MAY be a single string with a valid media type:\n\t//\n\t// One of the following YAML media types:\n\t// * text/yaml\n\t// * text/x-yaml\n\t// * application/yaml\n\t// * application/x-yaml*\n\t//\n\t// Any type from the list of IANA MIME Media Types,\n\t// http://www.iana.org/assignments/media-types\n\t// A custom type that conforms to the regular expression:\n\t// * \"application\\/[A-Za-z.-0-1]*+?(json|xml)\"\n\tMediaType string `yaml:\"mediaType\"`\n\n\t// The schemas property specifies collections of schemas that could be\n\t// used anywhere in the API definition.\n\t// The value of the schemas property is an array of maps; in each map,\n\t// the keys are the schema name, and the values are schema definitions:\n\t// []map[SchemaName]SchemaString\n\tSchemas []map[string]string\n\t// TODO: Flatten the arrays of maps here.\n\n\t// The securitySchemes property MUST be used to specify an API's security\n\t// mechanisms, including the required settings and the authentication\n\t// methods that the API supports.\n\t// []map[SchemeName]SecurityScheme\n\tSecuritySchemes []map[string]SecurityScheme `yaml:\"securitySchemes\"`\n\t// TODO: Flatten the arrays of maps here.\n\n\t// To apply a securityScheme definition to every method in an API, the\n\t// API MAY be defined using the securedBy attribute. This specifies that\n\t// all methods in the API are protected using that security scheme.\n\t// Custom parameters can be provided to the security scheme.\n\tSecuredBy []DefinitionChoice `yaml:\"securedBy\"`\n\n\t// The API definition can include a variety of documents that serve as a\n\t// user guides and reference documentation for the API. Such documents can\n\t// clarify how the API works or provide business context.\n\t// All the sections are in the order in which the documentation is declared.\n\tDocumentation []Documentation `yaml:\"documentation\"`\n\n\t// To apply a trait definition to a method, so that the method inherits the\n\t// trait's characteristics, the method MUST be defined by using the is\n\t// attribute. The value of the is attribute MUST be an array of any number\n\t// of elements, each of which MUST be a) one or more trait keys (names)\n\t// included in the traits declaration, or b) one or more trait definition\n\t// maps.\n\t// []map[TraitName]Trait\n\tTraits []map[string]Trait `yaml:\"traits\"`\n\t// TODO: Flatten the arrays of maps here.\n\n\t// The resourceTypes and traits properties are declared at the API\n\t// definition's root level with the resourceTypes and traits property keys,\n\t// respectively. The value of each of these properties is an array of maps;\n\t// in each map, the keys are resourceType or trait names, and the values\n\t// are resourceType or trait definitions, respectively.\n\t// []map[ResourceTypeName]ResourceType\n\tResourceTypes []map[string]ResourceType `yaml:\"resourceTypes\"`\n\t// TODO: Flatten the arrays of maps here.\n\n\t// Resources are identified by their relative URI, which MUST begin with a\n\t// slash (/). A resource defined as a root-level property is called a\n\t// top-level resource. Its property's key is the resource's URI relative\n\t// to the baseUri. A resource defined as a child property of another\n\t// resource is called a nested resource, and its property's key is its\n\t// URI relative to its parent resource's URI.\n\tResources map[string]Resource `yaml:\",regexp:/.*\"`\n}\n\n// This function receives a path, splits it and traverses the resource\n// tree to find the appropriate resource\nfunc (r *APIDefinition) GetResource(path string) *Resource {\n\treturn nil\n}\n" }, { "path": "validator.go", "content": "// Copyright 2014 DoAT. All rights reserved.\n//\n// Redistribution and use in source and binary forms, with or without modification,\n// are permitted provided that the following conditions are met:\n//\n// 1. Redistributions of source code must retain the above copyright notice,\n// this list of conditions and the following disclaimer.\n//\n// 2. Redistributions in binary form must reproduce the above copyright notice,\n// this list of conditions and the following disclaimer in the documentation and/or\n// other materials provided with the distribution.\n//\n// THIS SOFTWARE IS PROVIDED “AS IS” WITHOUT ANY WARRANTIES WHATSOEVER.\n// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\n// THE IMPLIED WARRANTIES OF NON INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n// PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL DoAT OR CONTRIBUTORS\n// BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n// // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\n// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n//\n// The views and conclusions contained in the software and documentation are those of\n// the authors and should not be interpreted as representing official policies,\n// either expressed or implied, of DoAT.\n\npackage raml\n\n// This file contains all of the RAML schema validator related code.\n\n// TODO: Inspirations:\n// \t\thttps://www.npmjs.com/package/raml-validate\n//\t\thttps://github.com/go-validator/validator\n//\t\thttps://github.com/asaskevich/govalidator\n\n// And of course:\n// \t\thttps://github.com/raml-org/raml-java-parser/tree/master/src/main/java/org/raml/parser/rule\n" } ]