github.com/rzurga/go-swagger@v0.28.1-0.20211109195225-5d1f453ffa3a/fixtures/bugs/1614/gitea.json (about) 1 { 2 "consumes": [ 3 "application/json", 4 "text/plain" 5 ], 6 "produces": [ 7 "application/json", 8 "text/html" 9 ], 10 "schemes": [ 11 "http", 12 "https" 13 ], 14 "swagger": "2.0", 15 "info": { 16 "description": "This documentation describes the Gitea API.", 17 "title": "Gitea API.", 18 "license": { 19 "name": "MIT", 20 "url": "http://opensource.org/licenses/MIT" 21 }, 22 "version": "1.1.1" 23 }, 24 "basePath": "/api/v1", 25 "paths": { 26 "/admin/users": { 27 "post": { 28 "consumes": [ 29 "application/json" 30 ], 31 "produces": [ 32 "application/json" 33 ], 34 "tags": [ 35 "admin" 36 ], 37 "summary": "Create a user", 38 "operationId": "adminCreateUser", 39 "parameters": [ 40 { 41 "name": "body", 42 "in": "body", 43 "schema": { 44 "$ref": "#/definitions/CreateUserOption" 45 } 46 } 47 ], 48 "responses": { 49 "201": { 50 "$ref": "#/responses/User" 51 }, 52 "403": { 53 "$ref": "#/responses/forbidden" 54 }, 55 "422": { 56 "$ref": "#/responses/validationError" 57 } 58 } 59 } 60 }, 61 "/admin/users/{username}": { 62 "delete": { 63 "produces": [ 64 "application/json" 65 ], 66 "tags": [ 67 "admin" 68 ], 69 "summary": "Delete a user", 70 "operationId": "adminDeleteUser", 71 "parameters": [ 72 { 73 "type": "string", 74 "description": "username of user to delete", 75 "name": "username", 76 "in": "path", 77 "required": true 78 } 79 ], 80 "responses": { 81 "204": { 82 "$ref": "#/responses/empty" 83 }, 84 "403": { 85 "$ref": "#/responses/forbidden" 86 }, 87 "422": { 88 "$ref": "#/responses/validationError" 89 } 90 } 91 }, 92 "patch": { 93 "consumes": [ 94 "application/json" 95 ], 96 "produces": [ 97 "application/json" 98 ], 99 "tags": [ 100 "admin" 101 ], 102 "summary": "Edit an existing user", 103 "operationId": "adminEditUser", 104 "parameters": [ 105 { 106 "type": "string", 107 "description": "username of user to edit", 108 "name": "username", 109 "in": "path", 110 "required": true 111 }, 112 { 113 "name": "body", 114 "in": "body", 115 "schema": { 116 "$ref": "#/definitions/EditUserOption" 117 } 118 } 119 ], 120 "responses": { 121 "200": { 122 "$ref": "#/responses/User" 123 }, 124 "403": { 125 "$ref": "#/responses/forbidden" 126 }, 127 "422": { 128 "$ref": "#/responses/validationError" 129 } 130 } 131 } 132 }, 133 "/admin/users/{username}/keys": { 134 "post": { 135 "consumes": [ 136 "application/json" 137 ], 138 "produces": [ 139 "application/json" 140 ], 141 "tags": [ 142 "admin" 143 ], 144 "summary": "Add a public key on behalf of a user", 145 "operationId": "adminCreatePublicKey", 146 "parameters": [ 147 { 148 "type": "string", 149 "description": "username of the user", 150 "name": "username", 151 "in": "path", 152 "required": true 153 } 154 ], 155 "responses": { 156 "201": { 157 "$ref": "#/responses/PublicKey" 158 }, 159 "403": { 160 "$ref": "#/responses/forbidden" 161 }, 162 "422": { 163 "$ref": "#/responses/validationError" 164 } 165 } 166 } 167 }, 168 "/admin/users/{username}/keys/{id}": { 169 "delete": { 170 "produces": [ 171 "application/json" 172 ], 173 "tags": [ 174 "admin" 175 ], 176 "summary": "Delete a user's public key", 177 "operationId": "adminDeleteUserPublicKey", 178 "parameters": [ 179 { 180 "type": "string", 181 "description": "username of user", 182 "name": "username", 183 "in": "path", 184 "required": true 185 }, 186 { 187 "type": "integer", 188 "description": "id of the key to delete", 189 "name": "id", 190 "in": "path", 191 "required": true 192 } 193 ], 194 "responses": { 195 "204": { 196 "$ref": "#/responses/empty" 197 }, 198 "403": { 199 "$ref": "#/responses/forbidden" 200 }, 201 "404": { 202 "$ref": "#/responses/notFound" 203 } 204 } 205 } 206 }, 207 "/admin/users/{username}/orgs": { 208 "post": { 209 "consumes": [ 210 "application/json" 211 ], 212 "produces": [ 213 "application/json" 214 ], 215 "tags": [ 216 "admin" 217 ], 218 "summary": "Create an organization", 219 "operationId": "adminCreateOrg", 220 "parameters": [ 221 { 222 "type": "string", 223 "description": "username of the user that will own the created organization", 224 "name": "username", 225 "in": "path", 226 "required": true 227 } 228 ], 229 "responses": { 230 "201": { 231 "$ref": "#/responses/Organization" 232 }, 233 "403": { 234 "$ref": "#/responses/forbidden" 235 }, 236 "422": { 237 "$ref": "#/responses/validationError" 238 } 239 } 240 } 241 }, 242 "/admin/users/{username}/repos": { 243 "post": { 244 "consumes": [ 245 "application/json" 246 ], 247 "produces": [ 248 "application/json" 249 ], 250 "tags": [ 251 "admin" 252 ], 253 "summary": "Create a repository on behalf a user", 254 "operationId": "adminCreateRepo", 255 "parameters": [ 256 { 257 "type": "string", 258 "description": "username of the user. This user will own the created repository", 259 "name": "username", 260 "in": "path", 261 "required": true 262 } 263 ], 264 "responses": { 265 "201": { 266 "$ref": "#/responses/Repository" 267 }, 268 "403": { 269 "$ref": "#/responses/forbidden" 270 }, 271 "422": { 272 "$ref": "#/responses/validationError" 273 } 274 } 275 } 276 }, 277 "/markdown": { 278 "post": { 279 "consumes": [ 280 "application/json" 281 ], 282 "produces": [ 283 "text/html" 284 ], 285 "tags": [ 286 "miscellaneous" 287 ], 288 "summary": "Render a markdown document as HTML", 289 "operationId": "renderMarkdown", 290 "parameters": [ 291 { 292 "name": "body", 293 "in": "body", 294 "schema": { 295 "$ref": "#/definitions/MarkdownOption" 296 } 297 } 298 ], 299 "responses": { 300 "200": { 301 "$ref": "#/responses/MarkdownRender" 302 }, 303 "422": { 304 "$ref": "#/responses/validationError" 305 } 306 } 307 } 308 }, 309 "/markdown/raw": { 310 "post": { 311 "consumes": [ 312 "text/plain" 313 ], 314 "produces": [ 315 "text/html" 316 ], 317 "tags": [ 318 "miscellaneous" 319 ], 320 "summary": "Render raw markdown as HTML", 321 "operationId": "renderMarkdownRaw", 322 "parameters": [ 323 { 324 "description": "Request body to render", 325 "name": "body", 326 "in": "body", 327 "required": true, 328 "schema": { 329 "type": "string" 330 } 331 } 332 ], 333 "responses": { 334 "200": { 335 "$ref": "#/responses/MarkdownRender" 336 }, 337 "422": { 338 "$ref": "#/responses/validationError" 339 } 340 } 341 } 342 }, 343 "/org/{org}/repos": { 344 "post": { 345 "consumes": [ 346 "application/json" 347 ], 348 "produces": [ 349 "application/json" 350 ], 351 "tags": [ 352 "organization" 353 ], 354 "summary": "Create a repository in an organization", 355 "operationId": "createOrgRepo", 356 "parameters": [ 357 { 358 "type": "string", 359 "description": "name of organization", 360 "name": "org", 361 "in": "path", 362 "required": true 363 }, 364 { 365 "name": "body", 366 "in": "body", 367 "schema": { 368 "$ref": "#/definitions/CreateRepoOption" 369 } 370 } 371 ], 372 "responses": { 373 "201": { 374 "$ref": "#/responses/Repository" 375 }, 376 "403": { 377 "$ref": "#/responses/forbidden" 378 }, 379 "422": { 380 "$ref": "#/responses/validationError" 381 } 382 } 383 } 384 }, 385 "/orgs/{org}": { 386 "get": { 387 "produces": [ 388 "application/json" 389 ], 390 "tags": [ 391 "organization" 392 ], 393 "summary": "Get an organization", 394 "operationId": "orgGet", 395 "parameters": [ 396 { 397 "type": "string", 398 "description": "name of the organization to get", 399 "name": "org", 400 "in": "path", 401 "required": true 402 } 403 ], 404 "responses": { 405 "200": { 406 "$ref": "#/responses/Organization" 407 } 408 } 409 }, 410 "patch": { 411 "consumes": [ 412 "application/json" 413 ], 414 "produces": [ 415 "application/json" 416 ], 417 "tags": [ 418 "organization" 419 ], 420 "summary": "Edit an organization", 421 "operationId": "orgEdit", 422 "parameters": [ 423 { 424 "type": "string", 425 "description": "name of the organization to edit", 426 "name": "org", 427 "in": "path", 428 "required": true 429 }, 430 { 431 "name": "body", 432 "in": "body", 433 "schema": { 434 "$ref": "#/definitions/EditOrgOption" 435 } 436 } 437 ], 438 "responses": { 439 "200": { 440 "$ref": "#/responses/Organization" 441 } 442 } 443 } 444 }, 445 "/orgs/{org}/hooks": { 446 "get": { 447 "produces": [ 448 "application/json" 449 ], 450 "tags": [ 451 "organization" 452 ], 453 "summary": "List an organization's webhooks", 454 "operationId": "orgListHooks", 455 "parameters": [ 456 { 457 "type": "string", 458 "description": "name of the organization", 459 "name": "org", 460 "in": "path", 461 "required": true 462 } 463 ], 464 "responses": { 465 "200": { 466 "$ref": "#/responses/HookList" 467 } 468 } 469 } 470 }, 471 "/orgs/{org}/hooks/": { 472 "post": { 473 "consumes": [ 474 "application/json" 475 ], 476 "produces": [ 477 "application/json" 478 ], 479 "tags": [ 480 "organization" 481 ], 482 "summary": "Create a hook", 483 "operationId": "orgCreateHook", 484 "parameters": [ 485 { 486 "type": "string", 487 "description": "name of the organization", 488 "name": "org", 489 "in": "path", 490 "required": true 491 } 492 ], 493 "responses": { 494 "201": { 495 "$ref": "#/responses/Hook" 496 } 497 } 498 } 499 }, 500 "/orgs/{org}/hooks/{id}": { 501 "get": { 502 "produces": [ 503 "application/json" 504 ], 505 "tags": [ 506 "organization" 507 ], 508 "summary": "Get a hook", 509 "operationId": "orgGetHook", 510 "parameters": [ 511 { 512 "type": "string", 513 "description": "name of the organization", 514 "name": "org", 515 "in": "path", 516 "required": true 517 }, 518 { 519 "type": "integer", 520 "description": "id of the hook to get", 521 "name": "id", 522 "in": "path", 523 "required": true 524 } 525 ], 526 "responses": { 527 "200": { 528 "$ref": "#/responses/Hook" 529 } 530 } 531 }, 532 "delete": { 533 "produces": [ 534 "application/json" 535 ], 536 "tags": [ 537 "organization" 538 ], 539 "summary": "Delete a hook", 540 "operationId": "orgDeleteHook", 541 "parameters": [ 542 { 543 "type": "string", 544 "description": "name of the organization", 545 "name": "org", 546 "in": "path", 547 "required": true 548 }, 549 { 550 "type": "integer", 551 "description": "id of the hook to delete", 552 "name": "id", 553 "in": "path", 554 "required": true 555 } 556 ], 557 "responses": { 558 "204": { 559 "$ref": "#/responses/empty" 560 } 561 } 562 }, 563 "patch": { 564 "consumes": [ 565 "application/json" 566 ], 567 "produces": [ 568 "application/json" 569 ], 570 "tags": [ 571 "organization" 572 ], 573 "summary": "Update a hook", 574 "operationId": "orgEditHook", 575 "parameters": [ 576 { 577 "type": "string", 578 "description": "name of the organization", 579 "name": "org", 580 "in": "path", 581 "required": true 582 }, 583 { 584 "type": "integer", 585 "description": "id of the hook to update", 586 "name": "id", 587 "in": "path", 588 "required": true 589 } 590 ], 591 "responses": { 592 "200": { 593 "$ref": "#/responses/Hook" 594 } 595 } 596 } 597 }, 598 "/orgs/{org}/members": { 599 "get": { 600 "produces": [ 601 "application/json" 602 ], 603 "tags": [ 604 "organization" 605 ], 606 "summary": "List an organization's members", 607 "operationId": "orgListMembers", 608 "parameters": [ 609 { 610 "type": "string", 611 "description": "name of the organization", 612 "name": "org", 613 "in": "path", 614 "required": true 615 } 616 ], 617 "responses": { 618 "200": { 619 "$ref": "#/responses/UserList" 620 } 621 } 622 } 623 }, 624 "/orgs/{org}/members/{username}": { 625 "get": { 626 "tags": [ 627 "organization" 628 ], 629 "summary": "Check if a user is a member of an organization", 630 "operationId": "orgIsMember", 631 "parameters": [ 632 { 633 "type": "string", 634 "description": "name of the organization", 635 "name": "org", 636 "in": "path", 637 "required": true 638 }, 639 { 640 "type": "string", 641 "description": "username of the user", 642 "name": "username", 643 "in": "path", 644 "required": true 645 } 646 ], 647 "responses": { 648 "204": { 649 "description": "user is a member", 650 "schema": { 651 "$ref": "#/responses/empty" 652 } 653 }, 654 "404": { 655 "description": "user is not a member", 656 "schema": { 657 "$ref": "#/responses/empty" 658 } 659 } 660 } 661 }, 662 "delete": { 663 "produces": [ 664 "application/json" 665 ], 666 "tags": [ 667 "organization" 668 ], 669 "summary": "Remove a member from an organization", 670 "operationId": "orgDeleteMember", 671 "parameters": [ 672 { 673 "type": "string", 674 "description": "name of the organization", 675 "name": "org", 676 "in": "path", 677 "required": true 678 }, 679 { 680 "type": "string", 681 "description": "username of the user", 682 "name": "username", 683 "in": "path", 684 "required": true 685 } 686 ], 687 "responses": { 688 "204": { 689 "description": "member removed", 690 "schema": { 691 "$ref": "#/responses/empty" 692 } 693 } 694 } 695 } 696 }, 697 "/orgs/{org}/public_members": { 698 "get": { 699 "produces": [ 700 "application/json" 701 ], 702 "tags": [ 703 "organization" 704 ], 705 "summary": "List an organization's public members", 706 "operationId": "orgListPublicMembers", 707 "parameters": [ 708 { 709 "type": "string", 710 "description": "name of the organization", 711 "name": "org", 712 "in": "path", 713 "required": true 714 } 715 ], 716 "responses": { 717 "200": { 718 "$ref": "#/responses/UserList" 719 } 720 } 721 } 722 }, 723 "/orgs/{org}/public_members/{username}": { 724 "get": { 725 "tags": [ 726 "organization" 727 ], 728 "summary": "Check if a user is a public member of an organization", 729 "operationId": "orgIsPublicMember", 730 "parameters": [ 731 { 732 "type": "string", 733 "description": "name of the organization", 734 "name": "org", 735 "in": "path", 736 "required": true 737 }, 738 { 739 "type": "string", 740 "description": "username of the user", 741 "name": "username", 742 "in": "path", 743 "required": true 744 } 745 ], 746 "responses": { 747 "204": { 748 "description": "user is a public member", 749 "schema": { 750 "$ref": "#/responses/empty" 751 } 752 }, 753 "404": { 754 "description": "user is not a public member", 755 "schema": { 756 "$ref": "#/responses/empty" 757 } 758 } 759 } 760 }, 761 "put": { 762 "produces": [ 763 "application/json" 764 ], 765 "tags": [ 766 "organization" 767 ], 768 "summary": "Publicize a user's membership", 769 "operationId": "orgPublicizeMember", 770 "parameters": [ 771 { 772 "type": "string", 773 "description": "name of the organization", 774 "name": "org", 775 "in": "path", 776 "required": true 777 }, 778 { 779 "type": "string", 780 "description": "username of the user", 781 "name": "username", 782 "in": "path", 783 "required": true 784 } 785 ], 786 "responses": { 787 "204": { 788 "description": "membership publicized", 789 "schema": { 790 "$ref": "#/responses/empty" 791 } 792 } 793 } 794 }, 795 "delete": { 796 "produces": [ 797 "application/json" 798 ], 799 "tags": [ 800 "organization" 801 ], 802 "summary": "Conceal a user's membership", 803 "operationId": "orgConcealMember", 804 "parameters": [ 805 { 806 "type": "string", 807 "description": "name of the organization", 808 "name": "org", 809 "in": "path", 810 "required": true 811 }, 812 { 813 "type": "string", 814 "description": "username of the user", 815 "name": "username", 816 "in": "path", 817 "required": true 818 } 819 ], 820 "responses": { 821 "204": { 822 "$ref": "#/responses/empty" 823 } 824 } 825 } 826 }, 827 "/orgs/{org}/repos": { 828 "get": { 829 "produces": [ 830 "application/json" 831 ], 832 "tags": [ 833 "organization" 834 ], 835 "summary": "List an organization's repos", 836 "operationId": "orgListRepos", 837 "parameters": [ 838 { 839 "type": "string", 840 "description": "name of the organization", 841 "name": "org", 842 "in": "path", 843 "required": true 844 } 845 ], 846 "responses": { 847 "200": { 848 "$ref": "#/responses/RepositoryList" 849 } 850 } 851 } 852 }, 853 "/orgs/{org}/teams": { 854 "get": { 855 "produces": [ 856 "application/json" 857 ], 858 "tags": [ 859 "organization" 860 ], 861 "summary": "List an organization's teams", 862 "operationId": "orgListTeams", 863 "parameters": [ 864 { 865 "type": "string", 866 "description": "name of the organization", 867 "name": "org", 868 "in": "path", 869 "required": true 870 } 871 ], 872 "responses": { 873 "200": { 874 "$ref": "#/responses/TeamList" 875 } 876 } 877 }, 878 "post": { 879 "consumes": [ 880 "application/json" 881 ], 882 "produces": [ 883 "application/json" 884 ], 885 "tags": [ 886 "organization" 887 ], 888 "summary": "Create a team", 889 "operationId": "orgCreateTeam", 890 "parameters": [ 891 { 892 "type": "string", 893 "description": "name of the organization", 894 "name": "org", 895 "in": "path", 896 "required": true 897 }, 898 { 899 "name": "body", 900 "in": "body", 901 "schema": { 902 "$ref": "#/definitions/CreateTeamOption" 903 } 904 } 905 ], 906 "responses": { 907 "201": { 908 "$ref": "#/responses/Team" 909 } 910 } 911 } 912 }, 913 "/repos/migrate": { 914 "post": { 915 "consumes": [ 916 "application/json" 917 ], 918 "produces": [ 919 "application/json" 920 ], 921 "tags": [ 922 "repository" 923 ], 924 "summary": "Migrate a remote git repository", 925 "operationId": "repoMigrate", 926 "parameters": [ 927 { 928 "name": "body", 929 "in": "body", 930 "schema": { 931 "$ref": "#/definitions/MigrateRepoForm" 932 } 933 } 934 ], 935 "responses": { 936 "201": { 937 "$ref": "#/responses/Repository" 938 } 939 } 940 } 941 }, 942 "/repos/search": { 943 "get": { 944 "produces": [ 945 "application/json" 946 ], 947 "tags": [ 948 "repository" 949 ], 950 "summary": "Search for repositories", 951 "operationId": "repoSearch", 952 "parameters": [ 953 { 954 "type": "string", 955 "description": "keyword", 956 "name": "q", 957 "in": "query" 958 }, 959 { 960 "type": "integer", 961 "description": "search only for repos that the user with the given id owns or contributes to", 962 "name": "uid", 963 "in": "query" 964 }, 965 { 966 "type": "integer", 967 "description": "page number of results to return (1-based)", 968 "name": "page", 969 "in": "query" 970 }, 971 { 972 "type": "integer", 973 "description": "page size of results, maximum page size is 50", 974 "name": "limit", 975 "in": "query" 976 }, 977 { 978 "type": "string", 979 "description": "type of repository to search for. Supported values are \"fork\", \"source\", \"mirror\" and \"collaborative\"", 980 "name": "mode", 981 "in": "query" 982 }, 983 { 984 "type": "boolean", 985 "description": "if `uid` is given, search only for repos that the user owns", 986 "name": "exclusive", 987 "in": "query" 988 } 989 ], 990 "responses": { 991 "200": { 992 "$ref": "#/responses/SearchResults" 993 }, 994 "422": { 995 "$ref": "#/responses/validationError" 996 } 997 } 998 } 999 }, 1000 "/repos/{owner}/{repo}": { 1001 "get": { 1002 "produces": [ 1003 "application/json" 1004 ], 1005 "tags": [ 1006 "repository" 1007 ], 1008 "summary": "Get a repository", 1009 "operationId": "repoGet", 1010 "parameters": [ 1011 { 1012 "type": "string", 1013 "description": "owner of the repo", 1014 "name": "owner", 1015 "in": "path", 1016 "required": true 1017 }, 1018 { 1019 "type": "string", 1020 "description": "name of the repo", 1021 "name": "repo", 1022 "in": "path", 1023 "required": true 1024 } 1025 ], 1026 "responses": { 1027 "200": { 1028 "$ref": "#/responses/Repository" 1029 } 1030 } 1031 }, 1032 "delete": { 1033 "produces": [ 1034 "application/json" 1035 ], 1036 "tags": [ 1037 "repository" 1038 ], 1039 "summary": "Delete a repository", 1040 "operationId": "repoDelete", 1041 "parameters": [ 1042 { 1043 "type": "string", 1044 "description": "owner of the repo to delete", 1045 "name": "owner", 1046 "in": "path", 1047 "required": true 1048 }, 1049 { 1050 "type": "string", 1051 "description": "name of the repo to delete", 1052 "name": "repo", 1053 "in": "path", 1054 "required": true 1055 } 1056 ], 1057 "responses": { 1058 "204": { 1059 "$ref": "#/responses/empty" 1060 }, 1061 "403": { 1062 "$ref": "#/responses/forbidden" 1063 } 1064 } 1065 } 1066 }, 1067 "/repos/{owner}/{repo}/archive/{archive}": { 1068 "get": { 1069 "produces": [ 1070 "application/json" 1071 ], 1072 "tags": [ 1073 "repository" 1074 ], 1075 "summary": "Get an archive of a repository", 1076 "operationId": "repoGetArchive", 1077 "parameters": [ 1078 { 1079 "type": "string", 1080 "description": "owner of the repo", 1081 "name": "owner", 1082 "in": "path", 1083 "required": true 1084 }, 1085 { 1086 "type": "string", 1087 "description": "name of the repo", 1088 "name": "repo", 1089 "in": "path", 1090 "required": true 1091 }, 1092 { 1093 "type": "string", 1094 "description": "archive to download, consisting of a git reference and archive", 1095 "name": "archive", 1096 "in": "path", 1097 "required": true 1098 } 1099 ], 1100 "responses": { 1101 "200": { 1102 "description": "success" 1103 } 1104 } 1105 } 1106 }, 1107 "/repos/{owner}/{repo}/branches": { 1108 "get": { 1109 "produces": [ 1110 "application/json" 1111 ], 1112 "tags": [ 1113 "repository" 1114 ], 1115 "summary": "List a repository's branches", 1116 "operationId": "repoListBranches", 1117 "parameters": [ 1118 { 1119 "type": "string", 1120 "description": "owner of the repo", 1121 "name": "owner", 1122 "in": "path", 1123 "required": true 1124 }, 1125 { 1126 "type": "string", 1127 "description": "name of the repo", 1128 "name": "repo", 1129 "in": "path", 1130 "required": true 1131 } 1132 ], 1133 "responses": { 1134 "200": { 1135 "$ref": "#/responses/BranchList" 1136 } 1137 } 1138 } 1139 }, 1140 "/repos/{owner}/{repo}/branches/{branch}": { 1141 "get": { 1142 "produces": [ 1143 "application/json" 1144 ], 1145 "tags": [ 1146 "repository" 1147 ], 1148 "summary": "List a repository's branches", 1149 "operationId": "repoGetBranch", 1150 "parameters": [ 1151 { 1152 "type": "string", 1153 "description": "owner of the repo", 1154 "name": "owner", 1155 "in": "path", 1156 "required": true 1157 }, 1158 { 1159 "type": "string", 1160 "description": "name of the repo", 1161 "name": "repo", 1162 "in": "path", 1163 "required": true 1164 }, 1165 { 1166 "type": "string", 1167 "description": "branch to get", 1168 "name": "branch", 1169 "in": "path", 1170 "required": true 1171 } 1172 ], 1173 "responses": { 1174 "200": { 1175 "$ref": "#/responses/Branch" 1176 } 1177 } 1178 } 1179 }, 1180 "/repos/{owner}/{repo}/collaborators": { 1181 "get": { 1182 "produces": [ 1183 "application/json" 1184 ], 1185 "tags": [ 1186 "repository" 1187 ], 1188 "summary": "List a repository's collaborators", 1189 "operationId": "repoListCollaborators", 1190 "parameters": [ 1191 { 1192 "type": "string", 1193 "description": "owner of the repo", 1194 "name": "owner", 1195 "in": "path", 1196 "required": true 1197 }, 1198 { 1199 "type": "string", 1200 "description": "name of the repo", 1201 "name": "repo", 1202 "in": "path", 1203 "required": true 1204 } 1205 ], 1206 "responses": { 1207 "200": { 1208 "$ref": "#/responses/UserList" 1209 } 1210 } 1211 } 1212 }, 1213 "/repos/{owner}/{repo}/collaborators/{collaborator}": { 1214 "get": { 1215 "produces": [ 1216 "application/json" 1217 ], 1218 "tags": [ 1219 "repository" 1220 ], 1221 "summary": "Check if a user is a collaborator of a repository", 1222 "operationId": "repoCheckCollaborator", 1223 "parameters": [ 1224 { 1225 "type": "string", 1226 "description": "owner of the repo", 1227 "name": "owner", 1228 "in": "path", 1229 "required": true 1230 }, 1231 { 1232 "type": "string", 1233 "description": "name of the repo", 1234 "name": "repo", 1235 "in": "path", 1236 "required": true 1237 }, 1238 { 1239 "type": "string", 1240 "description": "username of the collaborator", 1241 "name": "collaborator", 1242 "in": "path", 1243 "required": true 1244 } 1245 ], 1246 "responses": { 1247 "204": { 1248 "$ref": "#/responses/empty" 1249 }, 1250 "404": { 1251 "$ref": "#/responses/empty" 1252 } 1253 } 1254 }, 1255 "put": { 1256 "produces": [ 1257 "application/json" 1258 ], 1259 "tags": [ 1260 "repository" 1261 ], 1262 "summary": "Add a collaborator to a repository", 1263 "operationId": "repoAddCollaborator", 1264 "parameters": [ 1265 { 1266 "type": "string", 1267 "description": "owner of the repo", 1268 "name": "owner", 1269 "in": "path", 1270 "required": true 1271 }, 1272 { 1273 "type": "string", 1274 "description": "name of the repo", 1275 "name": "repo", 1276 "in": "path", 1277 "required": true 1278 }, 1279 { 1280 "type": "string", 1281 "description": "username of the collaborator to add", 1282 "name": "collaborator", 1283 "in": "path", 1284 "required": true 1285 }, 1286 { 1287 "name": "body", 1288 "in": "body", 1289 "schema": { 1290 "$ref": "#/definitions/AddCollaboratorOption" 1291 } 1292 } 1293 ], 1294 "responses": { 1295 "204": { 1296 "$ref": "#/responses/empty" 1297 } 1298 } 1299 }, 1300 "delete": { 1301 "produces": [ 1302 "application/json" 1303 ], 1304 "tags": [ 1305 "repository" 1306 ], 1307 "summary": "Delete a collaborator from a repository", 1308 "operationId": "repoDeleteCollaborator", 1309 "parameters": [ 1310 { 1311 "type": "string", 1312 "description": "owner of the repo", 1313 "name": "owner", 1314 "in": "path", 1315 "required": true 1316 }, 1317 { 1318 "type": "string", 1319 "description": "name of the repo", 1320 "name": "repo", 1321 "in": "path", 1322 "required": true 1323 }, 1324 { 1325 "type": "string", 1326 "description": "username of the collaborator to delete", 1327 "name": "collaborator", 1328 "in": "path", 1329 "required": true 1330 } 1331 ], 1332 "responses": { 1333 "204": { 1334 "$ref": "#/responses/empty" 1335 } 1336 } 1337 } 1338 }, 1339 "/repos/{owner}/{repo}/commits/{ref}/statuses": { 1340 "get": { 1341 "produces": [ 1342 "application/json" 1343 ], 1344 "tags": [ 1345 "repository" 1346 ], 1347 "summary": "Get a commit's combined status, by branch/tag/commit reference", 1348 "operationId": "repoGetCombinedStatusByRef", 1349 "parameters": [ 1350 { 1351 "type": "string", 1352 "description": "owner of the repo", 1353 "name": "owner", 1354 "in": "path", 1355 "required": true 1356 }, 1357 { 1358 "type": "string", 1359 "description": "name of the repo", 1360 "name": "repo", 1361 "in": "path", 1362 "required": true 1363 }, 1364 { 1365 "type": "string", 1366 "description": "name of branch/tag/commit", 1367 "name": "ref", 1368 "in": "path", 1369 "required": true 1370 } 1371 ], 1372 "responses": { 1373 "200": { 1374 "$ref": "#/responses/Status" 1375 } 1376 } 1377 } 1378 }, 1379 "/repos/{owner}/{repo}/editorconfig/{filepath}": { 1380 "get": { 1381 "produces": [ 1382 "application/json" 1383 ], 1384 "tags": [ 1385 "repository" 1386 ], 1387 "summary": "Get the EditorConfig definitions of a file in a repository", 1388 "operationId": "repoGetEditorConfig", 1389 "parameters": [ 1390 { 1391 "type": "string", 1392 "description": "owner of the repo", 1393 "name": "owner", 1394 "in": "path", 1395 "required": true 1396 }, 1397 { 1398 "type": "string", 1399 "description": "name of the repo", 1400 "name": "repo", 1401 "in": "path", 1402 "required": true 1403 }, 1404 { 1405 "type": "string", 1406 "description": "filepath of file to get", 1407 "name": "filepath", 1408 "in": "path", 1409 "required": true 1410 } 1411 ], 1412 "responses": { 1413 "200": { 1414 "description": "success" 1415 } 1416 } 1417 } 1418 }, 1419 "/repos/{owner}/{repo}/forks": { 1420 "get": { 1421 "produces": [ 1422 "application/json" 1423 ], 1424 "tags": [ 1425 "repository" 1426 ], 1427 "summary": "List a repository's forks", 1428 "operationId": "listForks", 1429 "parameters": [ 1430 { 1431 "type": "string", 1432 "description": "owner of the repo", 1433 "name": "owner", 1434 "in": "path", 1435 "required": true 1436 }, 1437 { 1438 "type": "string", 1439 "description": "name of the repo", 1440 "name": "repo", 1441 "in": "path", 1442 "required": true 1443 } 1444 ], 1445 "responses": { 1446 "200": { 1447 "$ref": "#/responses/RepositoryList" 1448 } 1449 } 1450 }, 1451 "post": { 1452 "produces": [ 1453 "application/json" 1454 ], 1455 "tags": [ 1456 "repository" 1457 ], 1458 "summary": "Fork a repository", 1459 "operationId": "createFork", 1460 "parameters": [ 1461 { 1462 "type": "string", 1463 "description": "owner of the repo to fork", 1464 "name": "owner", 1465 "in": "path", 1466 "required": true 1467 }, 1468 { 1469 "type": "string", 1470 "description": "name of the repo to fork", 1471 "name": "repo", 1472 "in": "path", 1473 "required": true 1474 }, 1475 { 1476 "name": "body", 1477 "in": "body", 1478 "schema": { 1479 "$ref": "#/definitions/CreateForkOption" 1480 } 1481 } 1482 ], 1483 "responses": { 1484 "202": { 1485 "$ref": "#/responses/Repository" 1486 } 1487 } 1488 } 1489 }, 1490 "/repos/{owner}/{repo}/hooks": { 1491 "get": { 1492 "produces": [ 1493 "application/json" 1494 ], 1495 "tags": [ 1496 "repository" 1497 ], 1498 "summary": "List the hooks in a repository", 1499 "operationId": "repoListHooks", 1500 "parameters": [ 1501 { 1502 "type": "string", 1503 "description": "owner of the repo", 1504 "name": "owner", 1505 "in": "path", 1506 "required": true 1507 }, 1508 { 1509 "type": "string", 1510 "description": "name of the repo", 1511 "name": "repo", 1512 "in": "path", 1513 "required": true 1514 } 1515 ], 1516 "responses": { 1517 "200": { 1518 "$ref": "#/responses/HookList" 1519 } 1520 } 1521 }, 1522 "post": { 1523 "consumes": [ 1524 "application/json" 1525 ], 1526 "produces": [ 1527 "application/json" 1528 ], 1529 "tags": [ 1530 "repository" 1531 ], 1532 "summary": "Create a hook", 1533 "operationId": "repoCreateHook", 1534 "parameters": [ 1535 { 1536 "type": "string", 1537 "description": "owner of the repo", 1538 "name": "owner", 1539 "in": "path", 1540 "required": true 1541 }, 1542 { 1543 "type": "string", 1544 "description": "name of the repo", 1545 "name": "repo", 1546 "in": "path", 1547 "required": true 1548 }, 1549 { 1550 "name": "body", 1551 "in": "body", 1552 "schema": { 1553 "$ref": "#/definitions/CreateHookOption" 1554 } 1555 } 1556 ], 1557 "responses": { 1558 "201": { 1559 "$ref": "#/responses/Hook" 1560 } 1561 } 1562 } 1563 }, 1564 "/repos/{owner}/{repo}/hooks/{id}": { 1565 "get": { 1566 "produces": [ 1567 "application/json" 1568 ], 1569 "tags": [ 1570 "repository" 1571 ], 1572 "summary": "Get a hook", 1573 "operationId": "repoGetHook", 1574 "parameters": [ 1575 { 1576 "type": "string", 1577 "description": "owner of the repo", 1578 "name": "owner", 1579 "in": "path", 1580 "required": true 1581 }, 1582 { 1583 "type": "string", 1584 "description": "name of the repo", 1585 "name": "repo", 1586 "in": "path", 1587 "required": true 1588 }, 1589 { 1590 "type": "integer", 1591 "description": "id of the hook to get", 1592 "name": "id", 1593 "in": "path", 1594 "required": true 1595 } 1596 ], 1597 "responses": { 1598 "200": { 1599 "$ref": "#/responses/Hook" 1600 } 1601 } 1602 }, 1603 "delete": { 1604 "produces": [ 1605 "application/json" 1606 ], 1607 "tags": [ 1608 "repository" 1609 ], 1610 "summary": "Delete a hook in a repository", 1611 "operationId": "repoDeleteHook", 1612 "parameters": [ 1613 { 1614 "type": "string", 1615 "description": "owner of the repo", 1616 "name": "owner", 1617 "in": "path", 1618 "required": true 1619 }, 1620 { 1621 "type": "string", 1622 "description": "name of the repo", 1623 "name": "repo", 1624 "in": "path", 1625 "required": true 1626 }, 1627 { 1628 "type": "integer", 1629 "description": "id of the hook to delete", 1630 "name": "id", 1631 "in": "path", 1632 "required": true 1633 } 1634 ], 1635 "responses": { 1636 "204": { 1637 "$ref": "#/responses/empty" 1638 }, 1639 "404": { 1640 "$ref": "#/responses/notFound" 1641 } 1642 } 1643 }, 1644 "patch": { 1645 "produces": [ 1646 "application/json" 1647 ], 1648 "tags": [ 1649 "repository" 1650 ], 1651 "summary": "Edit a hook in a repository", 1652 "operationId": "repoEditHook", 1653 "parameters": [ 1654 { 1655 "type": "string", 1656 "description": "owner of the repo", 1657 "name": "owner", 1658 "in": "path", 1659 "required": true 1660 }, 1661 { 1662 "type": "string", 1663 "description": "name of the repo", 1664 "name": "repo", 1665 "in": "path", 1666 "required": true 1667 }, 1668 { 1669 "type": "integer", 1670 "description": "index of the hook", 1671 "name": "id", 1672 "in": "path", 1673 "required": true 1674 }, 1675 { 1676 "name": "body", 1677 "in": "body", 1678 "schema": { 1679 "$ref": "#/definitions/EditHookOption" 1680 } 1681 } 1682 ], 1683 "responses": { 1684 "200": { 1685 "$ref": "#/responses/Hook" 1686 } 1687 } 1688 } 1689 }, 1690 "/repos/{owner}/{repo}/hooks/{id}/tests": { 1691 "post": { 1692 "produces": [ 1693 "application/json" 1694 ], 1695 "tags": [ 1696 "repository" 1697 ], 1698 "summary": "Test a push webhook", 1699 "operationId": "repoTestHook", 1700 "parameters": [ 1701 { 1702 "type": "string", 1703 "description": "owner of the repo", 1704 "name": "owner", 1705 "in": "path", 1706 "required": true 1707 }, 1708 { 1709 "type": "string", 1710 "description": "name of the repo", 1711 "name": "repo", 1712 "in": "path", 1713 "required": true 1714 }, 1715 { 1716 "type": "integer", 1717 "description": "id of the hook to test", 1718 "name": "id", 1719 "in": "path", 1720 "required": true 1721 } 1722 ], 1723 "responses": { 1724 "204": { 1725 "$ref": "#/responses/empty" 1726 } 1727 } 1728 } 1729 }, 1730 "/repos/{owner}/{repo}/issues": { 1731 "get": { 1732 "produces": [ 1733 "application/json" 1734 ], 1735 "tags": [ 1736 "issue" 1737 ], 1738 "summary": "List a repository's issues", 1739 "operationId": "issueListIssues", 1740 "parameters": [ 1741 { 1742 "type": "string", 1743 "description": "owner of the repo", 1744 "name": "owner", 1745 "in": "path", 1746 "required": true 1747 }, 1748 { 1749 "type": "string", 1750 "description": "name of the repo", 1751 "name": "repo", 1752 "in": "path", 1753 "required": true 1754 }, 1755 { 1756 "type": "string", 1757 "description": "whether issue is open or closed", 1758 "name": "state", 1759 "in": "query" 1760 }, 1761 { 1762 "type": "integer", 1763 "description": "page number of requested issues", 1764 "name": "page", 1765 "in": "query" 1766 }, 1767 { 1768 "type": "string", 1769 "description": "search string", 1770 "name": "q", 1771 "in": "query" 1772 } 1773 ], 1774 "responses": { 1775 "200": { 1776 "$ref": "#/responses/IssueList" 1777 } 1778 } 1779 }, 1780 "post": { 1781 "consumes": [ 1782 "application/json" 1783 ], 1784 "produces": [ 1785 "application/json" 1786 ], 1787 "tags": [ 1788 "issue" 1789 ], 1790 "summary": "Create an issue", 1791 "operationId": "issueCreateIssue", 1792 "parameters": [ 1793 { 1794 "type": "string", 1795 "description": "owner of the repo", 1796 "name": "owner", 1797 "in": "path", 1798 "required": true 1799 }, 1800 { 1801 "type": "string", 1802 "description": "name of the repo", 1803 "name": "repo", 1804 "in": "path", 1805 "required": true 1806 }, 1807 { 1808 "name": "body", 1809 "in": "body", 1810 "schema": { 1811 "$ref": "#/definitions/CreateIssueOption" 1812 } 1813 } 1814 ], 1815 "responses": { 1816 "201": { 1817 "$ref": "#/responses/Issue" 1818 } 1819 } 1820 } 1821 }, 1822 "/repos/{owner}/{repo}/issues/comments": { 1823 "get": { 1824 "produces": [ 1825 "application/json" 1826 ], 1827 "tags": [ 1828 "issue" 1829 ], 1830 "summary": "List all comments in a repository", 1831 "operationId": "issueGetRepoComments", 1832 "parameters": [ 1833 { 1834 "type": "string", 1835 "description": "owner of the repo", 1836 "name": "owner", 1837 "in": "path", 1838 "required": true 1839 }, 1840 { 1841 "type": "string", 1842 "description": "name of the repo", 1843 "name": "repo", 1844 "in": "path", 1845 "required": true 1846 }, 1847 { 1848 "type": "string", 1849 "description": "if provided, only comments updated since the provided time are returned.", 1850 "name": "since", 1851 "in": "query" 1852 } 1853 ], 1854 "responses": { 1855 "200": { 1856 "$ref": "#/responses/CommentList" 1857 } 1858 } 1859 } 1860 }, 1861 "/repos/{owner}/{repo}/issues/comments/{id}": { 1862 "delete": { 1863 "tags": [ 1864 "issue" 1865 ], 1866 "summary": "Delete a comment", 1867 "operationId": "issueDeleteComment", 1868 "parameters": [ 1869 { 1870 "type": "string", 1871 "description": "owner of the repo", 1872 "name": "owner", 1873 "in": "path", 1874 "required": true 1875 }, 1876 { 1877 "type": "string", 1878 "description": "name of the repo", 1879 "name": "repo", 1880 "in": "path", 1881 "required": true 1882 }, 1883 { 1884 "type": "integer", 1885 "description": "id of comment to delete", 1886 "name": "id", 1887 "in": "path", 1888 "required": true 1889 } 1890 ], 1891 "responses": { 1892 "204": { 1893 "$ref": "#/responses/empty" 1894 } 1895 } 1896 }, 1897 "patch": { 1898 "consumes": [ 1899 "application/json" 1900 ], 1901 "produces": [ 1902 "application/json" 1903 ], 1904 "tags": [ 1905 "issue" 1906 ], 1907 "summary": "Edit a comment", 1908 "operationId": "issueEditComment", 1909 "parameters": [ 1910 { 1911 "type": "string", 1912 "description": "owner of the repo", 1913 "name": "owner", 1914 "in": "path", 1915 "required": true 1916 }, 1917 { 1918 "type": "string", 1919 "description": "name of the repo", 1920 "name": "repo", 1921 "in": "path", 1922 "required": true 1923 }, 1924 { 1925 "type": "integer", 1926 "description": "id of the comment to edit", 1927 "name": "id", 1928 "in": "path", 1929 "required": true 1930 }, 1931 { 1932 "name": "body", 1933 "in": "body", 1934 "schema": { 1935 "$ref": "#/definitions/EditIssueCommentOption" 1936 } 1937 } 1938 ], 1939 "responses": { 1940 "200": { 1941 "$ref": "#/responses/Comment" 1942 } 1943 } 1944 } 1945 }, 1946 "/repos/{owner}/{repo}/issues/{id}/times": { 1947 "get": { 1948 "produces": [ 1949 "application/json" 1950 ], 1951 "tags": [ 1952 "issue" 1953 ], 1954 "summary": "List an issue's tracked times", 1955 "operationId": "issueTrackedTimes", 1956 "parameters": [ 1957 { 1958 "type": "string", 1959 "description": "owner of the repo", 1960 "name": "owner", 1961 "in": "path", 1962 "required": true 1963 }, 1964 { 1965 "type": "string", 1966 "description": "name of the repo", 1967 "name": "repo", 1968 "in": "path", 1969 "required": true 1970 }, 1971 { 1972 "type": "integer", 1973 "description": "index of the issue", 1974 "name": "id", 1975 "in": "path", 1976 "required": true 1977 } 1978 ], 1979 "responses": { 1980 "200": { 1981 "$ref": "#/responses/TrackedTimeList" 1982 } 1983 } 1984 }, 1985 "post": { 1986 "consumes": [ 1987 "application/json" 1988 ], 1989 "produces": [ 1990 "application/json" 1991 ], 1992 "tags": [ 1993 "issue" 1994 ], 1995 "summary": "Add a tracked time to a issue", 1996 "operationId": "issueAddTime", 1997 "parameters": [ 1998 { 1999 "type": "string", 2000 "description": "owner of the repo", 2001 "name": "owner", 2002 "in": "path", 2003 "required": true 2004 }, 2005 { 2006 "type": "string", 2007 "description": "name of the repo", 2008 "name": "repo", 2009 "in": "path", 2010 "required": true 2011 }, 2012 { 2013 "type": "integer", 2014 "description": "index of the issue to add tracked time to", 2015 "name": "id", 2016 "in": "path", 2017 "required": true 2018 }, 2019 { 2020 "name": "body", 2021 "in": "body", 2022 "schema": { 2023 "$ref": "#/definitions/AddTimeOption" 2024 } 2025 } 2026 ], 2027 "responses": { 2028 "200": { 2029 "$ref": "#/responses/TrackedTime" 2030 }, 2031 "400": { 2032 "$ref": "#/responses/error" 2033 }, 2034 "403": { 2035 "$ref": "#/responses/error" 2036 } 2037 } 2038 } 2039 }, 2040 "/repos/{owner}/{repo}/issues/{index}": { 2041 "get": { 2042 "produces": [ 2043 "application/json" 2044 ], 2045 "tags": [ 2046 "issue" 2047 ], 2048 "summary": "Get an issue", 2049 "operationId": "issueGetIssue", 2050 "parameters": [ 2051 { 2052 "type": "string", 2053 "description": "owner of the repo", 2054 "name": "owner", 2055 "in": "path", 2056 "required": true 2057 }, 2058 { 2059 "type": "string", 2060 "description": "name of the repo", 2061 "name": "repo", 2062 "in": "path", 2063 "required": true 2064 }, 2065 { 2066 "type": "integer", 2067 "description": "index of the issue to get", 2068 "name": "index", 2069 "in": "path", 2070 "required": true 2071 } 2072 ], 2073 "responses": { 2074 "200": { 2075 "$ref": "#/responses/Issue" 2076 } 2077 } 2078 }, 2079 "patch": { 2080 "consumes": [ 2081 "application/json" 2082 ], 2083 "produces": [ 2084 "application/json" 2085 ], 2086 "tags": [ 2087 "issue" 2088 ], 2089 "summary": "Edit an issue", 2090 "operationId": "issueEditIssue", 2091 "parameters": [ 2092 { 2093 "type": "string", 2094 "description": "owner of the repo", 2095 "name": "owner", 2096 "in": "path", 2097 "required": true 2098 }, 2099 { 2100 "type": "string", 2101 "description": "name of the repo", 2102 "name": "repo", 2103 "in": "path", 2104 "required": true 2105 }, 2106 { 2107 "type": "integer", 2108 "description": "index of the issue to edit", 2109 "name": "index", 2110 "in": "path", 2111 "required": true 2112 }, 2113 { 2114 "name": "body", 2115 "in": "body", 2116 "schema": { 2117 "$ref": "#/definitions/EditIssueOption" 2118 } 2119 } 2120 ], 2121 "responses": { 2122 "201": { 2123 "$ref": "#/responses/Issue" 2124 } 2125 } 2126 } 2127 }, 2128 "/repos/{owner}/{repo}/issues/{index}/comments": { 2129 "get": { 2130 "produces": [ 2131 "application/json" 2132 ], 2133 "tags": [ 2134 "issue" 2135 ], 2136 "summary": "List all comments on an issue", 2137 "operationId": "issueGetComments", 2138 "parameters": [ 2139 { 2140 "type": "string", 2141 "description": "owner of the repo", 2142 "name": "owner", 2143 "in": "path", 2144 "required": true 2145 }, 2146 { 2147 "type": "string", 2148 "description": "name of the repo", 2149 "name": "repo", 2150 "in": "path", 2151 "required": true 2152 }, 2153 { 2154 "type": "integer", 2155 "description": "index of the issue", 2156 "name": "index", 2157 "in": "path", 2158 "required": true 2159 }, 2160 { 2161 "type": "string", 2162 "description": "if provided, only comments updated since the specified time are returned.", 2163 "name": "since", 2164 "in": "query" 2165 } 2166 ], 2167 "responses": { 2168 "200": { 2169 "$ref": "#/responses/CommentList" 2170 } 2171 } 2172 }, 2173 "post": { 2174 "consumes": [ 2175 "application/json" 2176 ], 2177 "produces": [ 2178 "application/json" 2179 ], 2180 "tags": [ 2181 "issue" 2182 ], 2183 "summary": "Add a comment to an issue", 2184 "operationId": "issueCreateComment", 2185 "parameters": [ 2186 { 2187 "type": "string", 2188 "description": "owner of the repo", 2189 "name": "owner", 2190 "in": "path", 2191 "required": true 2192 }, 2193 { 2194 "type": "string", 2195 "description": "name of the repo", 2196 "name": "repo", 2197 "in": "path", 2198 "required": true 2199 }, 2200 { 2201 "type": "integer", 2202 "description": "index of the issue", 2203 "name": "index", 2204 "in": "path", 2205 "required": true 2206 }, 2207 { 2208 "name": "body", 2209 "in": "body", 2210 "schema": { 2211 "$ref": "#/definitions/CreateIssueCommentOption" 2212 } 2213 } 2214 ], 2215 "responses": { 2216 "201": { 2217 "$ref": "#/responses/Comment" 2218 } 2219 } 2220 } 2221 }, 2222 "/repos/{owner}/{repo}/issues/{index}/comments/{id}": { 2223 "delete": { 2224 "tags": [ 2225 "issue" 2226 ], 2227 "summary": "Delete a comment", 2228 "operationId": "issueDeleteCommentDeprecated", 2229 "deprecated": true, 2230 "parameters": [ 2231 { 2232 "type": "string", 2233 "description": "owner of the repo", 2234 "name": "owner", 2235 "in": "path", 2236 "required": true 2237 }, 2238 { 2239 "type": "string", 2240 "description": "name of the repo", 2241 "name": "repo", 2242 "in": "path", 2243 "required": true 2244 }, 2245 { 2246 "type": "integer", 2247 "description": "this parameter is ignored", 2248 "name": "index", 2249 "in": "path", 2250 "required": true 2251 }, 2252 { 2253 "type": "integer", 2254 "description": "id of comment to delete", 2255 "name": "id", 2256 "in": "path", 2257 "required": true 2258 } 2259 ], 2260 "responses": { 2261 "204": { 2262 "$ref": "#/responses/empty" 2263 } 2264 } 2265 }, 2266 "patch": { 2267 "consumes": [ 2268 "application/json" 2269 ], 2270 "produces": [ 2271 "application/json" 2272 ], 2273 "tags": [ 2274 "issue" 2275 ], 2276 "summary": "Edit a comment", 2277 "operationId": "issueEditCommentDeprecated", 2278 "deprecated": true, 2279 "parameters": [ 2280 { 2281 "type": "string", 2282 "description": "owner of the repo", 2283 "name": "owner", 2284 "in": "path", 2285 "required": true 2286 }, 2287 { 2288 "type": "string", 2289 "description": "name of the repo", 2290 "name": "repo", 2291 "in": "path", 2292 "required": true 2293 }, 2294 { 2295 "type": "integer", 2296 "description": "this parameter is ignored", 2297 "name": "index", 2298 "in": "path", 2299 "required": true 2300 }, 2301 { 2302 "type": "integer", 2303 "description": "id of the comment to edit", 2304 "name": "id", 2305 "in": "path", 2306 "required": true 2307 }, 2308 { 2309 "name": "body", 2310 "in": "body", 2311 "schema": { 2312 "$ref": "#/definitions/EditIssueCommentOption" 2313 } 2314 } 2315 ], 2316 "responses": { 2317 "200": { 2318 "$ref": "#/responses/Comment" 2319 } 2320 } 2321 } 2322 }, 2323 "/repos/{owner}/{repo}/issues/{index}/deadline": { 2324 "post": { 2325 "consumes": [ 2326 "application/json" 2327 ], 2328 "produces": [ 2329 "application/json" 2330 ], 2331 "tags": [ 2332 "issue" 2333 ], 2334 "summary": "Set an issue deadline. If set to null, the deadline is deleted.", 2335 "operationId": "issueEditIssueDeadline", 2336 "parameters": [ 2337 { 2338 "type": "string", 2339 "description": "owner of the repo", 2340 "name": "owner", 2341 "in": "path", 2342 "required": true 2343 }, 2344 { 2345 "type": "string", 2346 "description": "name of the repo", 2347 "name": "repo", 2348 "in": "path", 2349 "required": true 2350 }, 2351 { 2352 "type": "integer", 2353 "description": "index of the issue to create or update a deadline on", 2354 "name": "index", 2355 "in": "path", 2356 "required": true 2357 }, 2358 { 2359 "name": "body", 2360 "in": "body", 2361 "schema": { 2362 "$ref": "#/definitions/EditDeadlineOption" 2363 } 2364 } 2365 ], 2366 "responses": { 2367 "201": { 2368 "$ref": "#/responses/IssueDeadline" 2369 }, 2370 "403": { 2371 "description": "Not repo writer", 2372 "schema": { 2373 "$ref": "#/responses/forbidden" 2374 } 2375 }, 2376 "404": { 2377 "description": "Issue not found", 2378 "schema": { 2379 "$ref": "#/responses/empty" 2380 } 2381 } 2382 } 2383 } 2384 }, 2385 "/repos/{owner}/{repo}/issues/{index}/labels": { 2386 "get": { 2387 "produces": [ 2388 "application/json" 2389 ], 2390 "tags": [ 2391 "issue" 2392 ], 2393 "summary": "Get an issue's labels", 2394 "operationId": "issueGetLabels", 2395 "parameters": [ 2396 { 2397 "type": "string", 2398 "description": "owner of the repo", 2399 "name": "owner", 2400 "in": "path", 2401 "required": true 2402 }, 2403 { 2404 "type": "string", 2405 "description": "name of the repo", 2406 "name": "repo", 2407 "in": "path", 2408 "required": true 2409 }, 2410 { 2411 "type": "integer", 2412 "description": "index of the issue", 2413 "name": "index", 2414 "in": "path", 2415 "required": true 2416 } 2417 ], 2418 "responses": { 2419 "200": { 2420 "$ref": "#/responses/LabelList" 2421 }, 2422 "404": { 2423 "$ref": "#/responses/notFound" 2424 } 2425 } 2426 }, 2427 "put": { 2428 "consumes": [ 2429 "application/json" 2430 ], 2431 "produces": [ 2432 "application/json" 2433 ], 2434 "tags": [ 2435 "issue" 2436 ], 2437 "summary": "Replace an issue's labels", 2438 "operationId": "issueReplaceLabels", 2439 "parameters": [ 2440 { 2441 "type": "string", 2442 "description": "owner of the repo", 2443 "name": "owner", 2444 "in": "path", 2445 "required": true 2446 }, 2447 { 2448 "type": "string", 2449 "description": "name of the repo", 2450 "name": "repo", 2451 "in": "path", 2452 "required": true 2453 }, 2454 { 2455 "type": "integer", 2456 "description": "index of the issue", 2457 "name": "index", 2458 "in": "path", 2459 "required": true 2460 }, 2461 { 2462 "name": "body", 2463 "in": "body", 2464 "schema": { 2465 "$ref": "#/definitions/IssueLabelsOption" 2466 } 2467 } 2468 ], 2469 "responses": { 2470 "200": { 2471 "$ref": "#/responses/LabelList" 2472 } 2473 } 2474 }, 2475 "post": { 2476 "consumes": [ 2477 "application/json" 2478 ], 2479 "produces": [ 2480 "application/json" 2481 ], 2482 "tags": [ 2483 "issue" 2484 ], 2485 "summary": "Add a label to an issue", 2486 "operationId": "issueAddLabel", 2487 "parameters": [ 2488 { 2489 "type": "string", 2490 "description": "owner of the repo", 2491 "name": "owner", 2492 "in": "path", 2493 "required": true 2494 }, 2495 { 2496 "type": "string", 2497 "description": "name of the repo", 2498 "name": "repo", 2499 "in": "path", 2500 "required": true 2501 }, 2502 { 2503 "type": "integer", 2504 "description": "index of the issue", 2505 "name": "index", 2506 "in": "path", 2507 "required": true 2508 }, 2509 { 2510 "name": "body", 2511 "in": "body", 2512 "schema": { 2513 "$ref": "#/definitions/IssueLabelsOption" 2514 } 2515 } 2516 ], 2517 "responses": { 2518 "200": { 2519 "$ref": "#/responses/LabelList" 2520 } 2521 } 2522 }, 2523 "delete": { 2524 "produces": [ 2525 "application/json" 2526 ], 2527 "tags": [ 2528 "issue" 2529 ], 2530 "summary": "Remove all labels from an issue", 2531 "operationId": "issueClearLabels", 2532 "parameters": [ 2533 { 2534 "type": "string", 2535 "description": "owner of the repo", 2536 "name": "owner", 2537 "in": "path", 2538 "required": true 2539 }, 2540 { 2541 "type": "string", 2542 "description": "name of the repo", 2543 "name": "repo", 2544 "in": "path", 2545 "required": true 2546 }, 2547 { 2548 "type": "integer", 2549 "description": "index of the issue", 2550 "name": "index", 2551 "in": "path", 2552 "required": true 2553 } 2554 ], 2555 "responses": { 2556 "204": { 2557 "$ref": "#/responses/empty" 2558 } 2559 } 2560 } 2561 }, 2562 "/repos/{owner}/{repo}/issues/{index}/labels/{id}": { 2563 "delete": { 2564 "produces": [ 2565 "application/json" 2566 ], 2567 "tags": [ 2568 "issue" 2569 ], 2570 "summary": "Remove a label from an issue", 2571 "operationId": "issueRemoveLabel", 2572 "parameters": [ 2573 { 2574 "type": "string", 2575 "description": "owner of the repo", 2576 "name": "owner", 2577 "in": "path", 2578 "required": true 2579 }, 2580 { 2581 "type": "string", 2582 "description": "name of the repo", 2583 "name": "repo", 2584 "in": "path", 2585 "required": true 2586 }, 2587 { 2588 "type": "integer", 2589 "description": "index of the issue", 2590 "name": "index", 2591 "in": "path", 2592 "required": true 2593 }, 2594 { 2595 "type": "integer", 2596 "description": "id of the label to remove", 2597 "name": "id", 2598 "in": "path", 2599 "required": true 2600 } 2601 ], 2602 "responses": { 2603 "204": { 2604 "$ref": "#/responses/empty" 2605 } 2606 } 2607 } 2608 }, 2609 "/repos/{owner}/{repo}/keys": { 2610 "get": { 2611 "produces": [ 2612 "application/json" 2613 ], 2614 "tags": [ 2615 "repository" 2616 ], 2617 "summary": "List a repository's keys", 2618 "operationId": "repoListKeys", 2619 "parameters": [ 2620 { 2621 "type": "string", 2622 "description": "owner of the repo", 2623 "name": "owner", 2624 "in": "path", 2625 "required": true 2626 }, 2627 { 2628 "type": "string", 2629 "description": "name of the repo", 2630 "name": "repo", 2631 "in": "path", 2632 "required": true 2633 } 2634 ], 2635 "responses": { 2636 "200": { 2637 "$ref": "#/responses/DeployKeyList" 2638 } 2639 } 2640 }, 2641 "post": { 2642 "consumes": [ 2643 "application/json" 2644 ], 2645 "produces": [ 2646 "application/json" 2647 ], 2648 "tags": [ 2649 "repository" 2650 ], 2651 "summary": "Add a key to a repository", 2652 "operationId": "repoCreateKey", 2653 "parameters": [ 2654 { 2655 "type": "string", 2656 "description": "owner of the repo", 2657 "name": "owner", 2658 "in": "path", 2659 "required": true 2660 }, 2661 { 2662 "type": "string", 2663 "description": "name of the repo", 2664 "name": "repo", 2665 "in": "path", 2666 "required": true 2667 }, 2668 { 2669 "name": "body", 2670 "in": "body", 2671 "schema": { 2672 "$ref": "#/definitions/CreateKeyOption" 2673 } 2674 } 2675 ], 2676 "responses": { 2677 "201": { 2678 "$ref": "#/responses/DeployKey" 2679 } 2680 } 2681 } 2682 }, 2683 "/repos/{owner}/{repo}/keys/{id}": { 2684 "get": { 2685 "produces": [ 2686 "application/json" 2687 ], 2688 "tags": [ 2689 "repository" 2690 ], 2691 "summary": "Get a repository's key by id", 2692 "operationId": "repoGetKey", 2693 "parameters": [ 2694 { 2695 "type": "string", 2696 "description": "owner of the repo", 2697 "name": "owner", 2698 "in": "path", 2699 "required": true 2700 }, 2701 { 2702 "type": "string", 2703 "description": "name of the repo", 2704 "name": "repo", 2705 "in": "path", 2706 "required": true 2707 }, 2708 { 2709 "type": "integer", 2710 "description": "id of the key to get", 2711 "name": "id", 2712 "in": "path", 2713 "required": true 2714 } 2715 ], 2716 "responses": { 2717 "200": { 2718 "$ref": "#/responses/DeployKey" 2719 } 2720 } 2721 }, 2722 "delete": { 2723 "tags": [ 2724 "repository" 2725 ], 2726 "summary": "Delete a key from a repository", 2727 "operationId": "repoDeleteKey", 2728 "parameters": [ 2729 { 2730 "type": "string", 2731 "description": "owner of the repo", 2732 "name": "owner", 2733 "in": "path", 2734 "required": true 2735 }, 2736 { 2737 "type": "string", 2738 "description": "name of the repo", 2739 "name": "repo", 2740 "in": "path", 2741 "required": true 2742 }, 2743 { 2744 "type": "integer", 2745 "description": "id of the key to delete", 2746 "name": "id", 2747 "in": "path", 2748 "required": true 2749 } 2750 ], 2751 "responses": { 2752 "204": { 2753 "$ref": "#/responses/empty" 2754 } 2755 } 2756 } 2757 }, 2758 "/repos/{owner}/{repo}/labels": { 2759 "get": { 2760 "produces": [ 2761 "application/json" 2762 ], 2763 "tags": [ 2764 "issue" 2765 ], 2766 "summary": "Get all of a repository's labels", 2767 "operationId": "issueListLabels", 2768 "parameters": [ 2769 { 2770 "type": "string", 2771 "description": "owner of the repo", 2772 "name": "owner", 2773 "in": "path", 2774 "required": true 2775 }, 2776 { 2777 "type": "string", 2778 "description": "name of the repo", 2779 "name": "repo", 2780 "in": "path", 2781 "required": true 2782 } 2783 ], 2784 "responses": { 2785 "200": { 2786 "$ref": "#/responses/LabelList" 2787 } 2788 } 2789 }, 2790 "post": { 2791 "consumes": [ 2792 "application/json" 2793 ], 2794 "produces": [ 2795 "application/json" 2796 ], 2797 "tags": [ 2798 "issue" 2799 ], 2800 "summary": "Create a label", 2801 "operationId": "issueCreateLabel", 2802 "parameters": [ 2803 { 2804 "type": "string", 2805 "description": "owner of the repo", 2806 "name": "owner", 2807 "in": "path", 2808 "required": true 2809 }, 2810 { 2811 "type": "string", 2812 "description": "name of the repo", 2813 "name": "repo", 2814 "in": "path", 2815 "required": true 2816 }, 2817 { 2818 "name": "body", 2819 "in": "body", 2820 "schema": { 2821 "$ref": "#/definitions/CreateLabelOption" 2822 } 2823 } 2824 ], 2825 "responses": { 2826 "201": { 2827 "$ref": "#/responses/Label" 2828 } 2829 } 2830 } 2831 }, 2832 "/repos/{owner}/{repo}/labels/{id}": { 2833 "get": { 2834 "produces": [ 2835 "application/json" 2836 ], 2837 "tags": [ 2838 "issue" 2839 ], 2840 "summary": "Get a single label", 2841 "operationId": "issueGetLabel", 2842 "parameters": [ 2843 { 2844 "type": "string", 2845 "description": "owner of the repo", 2846 "name": "owner", 2847 "in": "path", 2848 "required": true 2849 }, 2850 { 2851 "type": "string", 2852 "description": "name of the repo", 2853 "name": "repo", 2854 "in": "path", 2855 "required": true 2856 }, 2857 { 2858 "type": "integer", 2859 "description": "id of the label to get", 2860 "name": "id", 2861 "in": "path", 2862 "required": true 2863 } 2864 ], 2865 "responses": { 2866 "200": { 2867 "$ref": "#/responses/Label" 2868 } 2869 } 2870 }, 2871 "delete": { 2872 "tags": [ 2873 "issue" 2874 ], 2875 "summary": "Delete a label", 2876 "operationId": "issueDeleteLabel", 2877 "parameters": [ 2878 { 2879 "type": "string", 2880 "description": "owner of the repo", 2881 "name": "owner", 2882 "in": "path", 2883 "required": true 2884 }, 2885 { 2886 "type": "string", 2887 "description": "name of the repo", 2888 "name": "repo", 2889 "in": "path", 2890 "required": true 2891 }, 2892 { 2893 "type": "integer", 2894 "description": "id of the label to delete", 2895 "name": "id", 2896 "in": "path", 2897 "required": true 2898 } 2899 ], 2900 "responses": { 2901 "204": { 2902 "$ref": "#/responses/empty" 2903 } 2904 } 2905 }, 2906 "patch": { 2907 "consumes": [ 2908 "application/json" 2909 ], 2910 "produces": [ 2911 "application/json" 2912 ], 2913 "tags": [ 2914 "issue" 2915 ], 2916 "summary": "Update a label", 2917 "operationId": "issueEditLabel", 2918 "parameters": [ 2919 { 2920 "type": "string", 2921 "description": "owner of the repo", 2922 "name": "owner", 2923 "in": "path", 2924 "required": true 2925 }, 2926 { 2927 "type": "string", 2928 "description": "name of the repo", 2929 "name": "repo", 2930 "in": "path", 2931 "required": true 2932 }, 2933 { 2934 "type": "integer", 2935 "description": "id of the label to edit", 2936 "name": "id", 2937 "in": "path", 2938 "required": true 2939 }, 2940 { 2941 "name": "body", 2942 "in": "body", 2943 "schema": { 2944 "$ref": "#/definitions/EditLabelOption" 2945 } 2946 } 2947 ], 2948 "responses": { 2949 "200": { 2950 "$ref": "#/responses/Label" 2951 } 2952 } 2953 } 2954 }, 2955 "/repos/{owner}/{repo}/milestones": { 2956 "get": { 2957 "produces": [ 2958 "application/json" 2959 ], 2960 "tags": [ 2961 "issue" 2962 ], 2963 "summary": "Get all of a repository's milestones", 2964 "operationId": "issueGetMilestonesList", 2965 "parameters": [ 2966 { 2967 "type": "string", 2968 "description": "owner of the repo", 2969 "name": "owner", 2970 "in": "path", 2971 "required": true 2972 }, 2973 { 2974 "type": "string", 2975 "description": "name of the repo", 2976 "name": "repo", 2977 "in": "path", 2978 "required": true 2979 } 2980 ], 2981 "responses": { 2982 "200": { 2983 "$ref": "#/responses/MilestoneList" 2984 } 2985 } 2986 }, 2987 "post": { 2988 "consumes": [ 2989 "application/json" 2990 ], 2991 "produces": [ 2992 "application/json" 2993 ], 2994 "tags": [ 2995 "issue" 2996 ], 2997 "summary": "Create a milestone", 2998 "operationId": "issueCreateMilestone", 2999 "parameters": [ 3000 { 3001 "type": "string", 3002 "description": "owner of the repo", 3003 "name": "owner", 3004 "in": "path", 3005 "required": true 3006 }, 3007 { 3008 "type": "string", 3009 "description": "name of the repo", 3010 "name": "repo", 3011 "in": "path", 3012 "required": true 3013 }, 3014 { 3015 "name": "body", 3016 "in": "body", 3017 "schema": { 3018 "$ref": "#/definitions/CreateMilestoneOption" 3019 } 3020 } 3021 ], 3022 "responses": { 3023 "201": { 3024 "$ref": "#/responses/Milestone" 3025 } 3026 } 3027 } 3028 }, 3029 "/repos/{owner}/{repo}/milestones/{id}": { 3030 "get": { 3031 "produces": [ 3032 "application/json" 3033 ], 3034 "tags": [ 3035 "issue" 3036 ], 3037 "summary": "Get a milestone", 3038 "operationId": "issueGetMilestone", 3039 "parameters": [ 3040 { 3041 "type": "string", 3042 "description": "owner of the repo", 3043 "name": "owner", 3044 "in": "path", 3045 "required": true 3046 }, 3047 { 3048 "type": "string", 3049 "description": "name of the repo", 3050 "name": "repo", 3051 "in": "path", 3052 "required": true 3053 }, 3054 { 3055 "type": "integer", 3056 "description": "id of the milestone", 3057 "name": "id", 3058 "in": "path", 3059 "required": true 3060 } 3061 ], 3062 "responses": { 3063 "200": { 3064 "$ref": "#/responses/Milestone" 3065 } 3066 } 3067 }, 3068 "delete": { 3069 "tags": [ 3070 "issue" 3071 ], 3072 "summary": "Delete a milestone", 3073 "operationId": "issueDeleteMilestone", 3074 "parameters": [ 3075 { 3076 "type": "string", 3077 "description": "owner of the repo", 3078 "name": "owner", 3079 "in": "path", 3080 "required": true 3081 }, 3082 { 3083 "type": "string", 3084 "description": "name of the repo", 3085 "name": "repo", 3086 "in": "path", 3087 "required": true 3088 }, 3089 { 3090 "type": "integer", 3091 "description": "id of the milestone to delete", 3092 "name": "id", 3093 "in": "path", 3094 "required": true 3095 } 3096 ], 3097 "responses": { 3098 "204": { 3099 "$ref": "#/responses/empty" 3100 } 3101 } 3102 }, 3103 "patch": { 3104 "consumes": [ 3105 "application/json" 3106 ], 3107 "produces": [ 3108 "application/json" 3109 ], 3110 "tags": [ 3111 "issue" 3112 ], 3113 "summary": "Update a milestone", 3114 "operationId": "issueEditMilestone", 3115 "parameters": [ 3116 { 3117 "type": "string", 3118 "description": "owner of the repo", 3119 "name": "owner", 3120 "in": "path", 3121 "required": true 3122 }, 3123 { 3124 "type": "string", 3125 "description": "name of the repo", 3126 "name": "repo", 3127 "in": "path", 3128 "required": true 3129 }, 3130 { 3131 "type": "integer", 3132 "description": "id of the milestone", 3133 "name": "id", 3134 "in": "path", 3135 "required": true 3136 }, 3137 { 3138 "name": "body", 3139 "in": "body", 3140 "schema": { 3141 "$ref": "#/definitions/EditMilestoneOption" 3142 } 3143 } 3144 ], 3145 "responses": { 3146 "200": { 3147 "$ref": "#/responses/Milestone" 3148 } 3149 } 3150 } 3151 }, 3152 "/repos/{owner}/{repo}/mirror-sync": { 3153 "post": { 3154 "produces": [ 3155 "application/json" 3156 ], 3157 "tags": [ 3158 "repository" 3159 ], 3160 "summary": "Sync a mirrored repository", 3161 "operationId": "repoMirrorSync", 3162 "parameters": [ 3163 { 3164 "type": "string", 3165 "description": "owner of the repo to sync", 3166 "name": "owner", 3167 "in": "path", 3168 "required": true 3169 }, 3170 { 3171 "type": "string", 3172 "description": "name of the repo to sync", 3173 "name": "repo", 3174 "in": "path", 3175 "required": true 3176 } 3177 ], 3178 "responses": { 3179 "200": { 3180 "$ref": "#/responses/empty" 3181 } 3182 } 3183 } 3184 }, 3185 "/repos/{owner}/{repo}/pulls": { 3186 "get": { 3187 "produces": [ 3188 "application/json" 3189 ], 3190 "tags": [ 3191 "repository" 3192 ], 3193 "summary": "List a repo's pull requests", 3194 "operationId": "repoListPullRequests", 3195 "parameters": [ 3196 { 3197 "type": "string", 3198 "description": "owner of the repo", 3199 "name": "owner", 3200 "in": "path", 3201 "required": true 3202 }, 3203 { 3204 "type": "string", 3205 "description": "name of the repo", 3206 "name": "repo", 3207 "in": "path", 3208 "required": true 3209 } 3210 ], 3211 "responses": { 3212 "200": { 3213 "$ref": "#/responses/PullRequestList" 3214 } 3215 } 3216 }, 3217 "post": { 3218 "consumes": [ 3219 "application/json" 3220 ], 3221 "produces": [ 3222 "application/json" 3223 ], 3224 "tags": [ 3225 "repository" 3226 ], 3227 "summary": "Create a pull request", 3228 "operationId": "repoCreatePullRequest", 3229 "parameters": [ 3230 { 3231 "type": "string", 3232 "description": "owner of the repo", 3233 "name": "owner", 3234 "in": "path", 3235 "required": true 3236 }, 3237 { 3238 "type": "string", 3239 "description": "name of the repo", 3240 "name": "repo", 3241 "in": "path", 3242 "required": true 3243 }, 3244 { 3245 "name": "body", 3246 "in": "body", 3247 "schema": { 3248 "$ref": "#/definitions/CreatePullRequestOption" 3249 } 3250 } 3251 ], 3252 "responses": { 3253 "201": { 3254 "$ref": "#/responses/PullRequest" 3255 } 3256 } 3257 } 3258 }, 3259 "/repos/{owner}/{repo}/pulls/{index}": { 3260 "get": { 3261 "produces": [ 3262 "application/json" 3263 ], 3264 "tags": [ 3265 "repository" 3266 ], 3267 "summary": "Get a pull request", 3268 "operationId": "repoGetPullRequest", 3269 "parameters": [ 3270 { 3271 "type": "string", 3272 "description": "owner of the repo", 3273 "name": "owner", 3274 "in": "path", 3275 "required": true 3276 }, 3277 { 3278 "type": "string", 3279 "description": "name of the repo", 3280 "name": "repo", 3281 "in": "path", 3282 "required": true 3283 }, 3284 { 3285 "type": "integer", 3286 "description": "index of the pull request to get", 3287 "name": "index", 3288 "in": "path", 3289 "required": true 3290 } 3291 ], 3292 "responses": { 3293 "200": { 3294 "$ref": "#/responses/PullRequest" 3295 } 3296 } 3297 }, 3298 "patch": { 3299 "consumes": [ 3300 "application/json" 3301 ], 3302 "produces": [ 3303 "application/json" 3304 ], 3305 "tags": [ 3306 "repository" 3307 ], 3308 "summary": "Update a pull request", 3309 "operationId": "repoEditPullRequest", 3310 "parameters": [ 3311 { 3312 "type": "string", 3313 "description": "owner of the repo", 3314 "name": "owner", 3315 "in": "path", 3316 "required": true 3317 }, 3318 { 3319 "type": "string", 3320 "description": "name of the repo", 3321 "name": "repo", 3322 "in": "path", 3323 "required": true 3324 }, 3325 { 3326 "type": "integer", 3327 "description": "index of the pull request to edit", 3328 "name": "index", 3329 "in": "path", 3330 "required": true 3331 }, 3332 { 3333 "name": "body", 3334 "in": "body", 3335 "schema": { 3336 "$ref": "#/definitions/EditPullRequestOption" 3337 } 3338 } 3339 ], 3340 "responses": { 3341 "201": { 3342 "$ref": "#/responses/PullRequest" 3343 } 3344 } 3345 } 3346 }, 3347 "/repos/{owner}/{repo}/pulls/{index}/merge": { 3348 "get": { 3349 "produces": [ 3350 "application/json" 3351 ], 3352 "tags": [ 3353 "repository" 3354 ], 3355 "summary": "Check if a pull request has been merged", 3356 "operationId": "repoPullRequestIsMerged", 3357 "parameters": [ 3358 { 3359 "type": "string", 3360 "description": "owner of the repo", 3361 "name": "owner", 3362 "in": "path", 3363 "required": true 3364 }, 3365 { 3366 "type": "string", 3367 "description": "name of the repo", 3368 "name": "repo", 3369 "in": "path", 3370 "required": true 3371 }, 3372 { 3373 "type": "integer", 3374 "description": "index of the pull request", 3375 "name": "index", 3376 "in": "path", 3377 "required": true 3378 } 3379 ], 3380 "responses": { 3381 "204": { 3382 "description": "pull request has been merged", 3383 "schema": { 3384 "$ref": "#/responses/empty" 3385 } 3386 }, 3387 "404": { 3388 "description": "pull request has not been merged", 3389 "schema": { 3390 "$ref": "#/responses/empty" 3391 } 3392 } 3393 } 3394 }, 3395 "post": { 3396 "produces": [ 3397 "application/json" 3398 ], 3399 "tags": [ 3400 "repository" 3401 ], 3402 "summary": "Merge a pull request", 3403 "operationId": "repoMergePullRequest", 3404 "parameters": [ 3405 { 3406 "type": "string", 3407 "description": "owner of the repo", 3408 "name": "owner", 3409 "in": "path", 3410 "required": true 3411 }, 3412 { 3413 "type": "string", 3414 "description": "name of the repo", 3415 "name": "repo", 3416 "in": "path", 3417 "required": true 3418 }, 3419 { 3420 "type": "integer", 3421 "description": "index of the pull request to merge", 3422 "name": "index", 3423 "in": "path", 3424 "required": true 3425 } 3426 ], 3427 "responses": { 3428 "200": { 3429 "$ref": "#/responses/empty" 3430 }, 3431 "405": { 3432 "$ref": "#/responses/empty" 3433 } 3434 } 3435 } 3436 }, 3437 "/repos/{owner}/{repo}/raw/{filepath}": { 3438 "get": { 3439 "produces": [ 3440 "application/json" 3441 ], 3442 "tags": [ 3443 "repository" 3444 ], 3445 "summary": "Get a file from a repository", 3446 "operationId": "repoGetRawFile", 3447 "parameters": [ 3448 { 3449 "type": "string", 3450 "description": "owner of the repo", 3451 "name": "owner", 3452 "in": "path", 3453 "required": true 3454 }, 3455 { 3456 "type": "string", 3457 "description": "name of the repo", 3458 "name": "repo", 3459 "in": "path", 3460 "required": true 3461 }, 3462 { 3463 "type": "string", 3464 "description": "filepath of the file to get", 3465 "name": "filepath", 3466 "in": "path", 3467 "required": true 3468 } 3469 ], 3470 "responses": { 3471 "200": { 3472 "description": "success" 3473 } 3474 } 3475 } 3476 }, 3477 "/repos/{owner}/{repo}/releases": { 3478 "get": { 3479 "produces": [ 3480 "application/json" 3481 ], 3482 "tags": [ 3483 "repository" 3484 ], 3485 "summary": "List a repo's releases", 3486 "operationId": "repoListReleases", 3487 "parameters": [ 3488 { 3489 "type": "string", 3490 "description": "owner of the repo", 3491 "name": "owner", 3492 "in": "path", 3493 "required": true 3494 }, 3495 { 3496 "type": "string", 3497 "description": "name of the repo", 3498 "name": "repo", 3499 "in": "path", 3500 "required": true 3501 } 3502 ], 3503 "responses": { 3504 "200": { 3505 "$ref": "#/responses/ReleaseList" 3506 } 3507 } 3508 }, 3509 "post": { 3510 "consumes": [ 3511 "application/json" 3512 ], 3513 "produces": [ 3514 "application/json" 3515 ], 3516 "tags": [ 3517 "repository" 3518 ], 3519 "summary": "Create a release", 3520 "operationId": "repoCreateRelease", 3521 "parameters": [ 3522 { 3523 "type": "string", 3524 "description": "owner of the repo", 3525 "name": "owner", 3526 "in": "path", 3527 "required": true 3528 }, 3529 { 3530 "type": "string", 3531 "description": "name of the repo", 3532 "name": "repo", 3533 "in": "path", 3534 "required": true 3535 }, 3536 { 3537 "name": "body", 3538 "in": "body", 3539 "schema": { 3540 "$ref": "#/definitions/CreateReleaseOption" 3541 } 3542 } 3543 ], 3544 "responses": { 3545 "201": { 3546 "$ref": "#/responses/Release" 3547 } 3548 } 3549 } 3550 }, 3551 "/repos/{owner}/{repo}/releases/{id}": { 3552 "get": { 3553 "produces": [ 3554 "application/json" 3555 ], 3556 "tags": [ 3557 "repository" 3558 ], 3559 "summary": "Get a release", 3560 "operationId": "repoGetRelease", 3561 "parameters": [ 3562 { 3563 "type": "string", 3564 "description": "owner of the repo", 3565 "name": "owner", 3566 "in": "path", 3567 "required": true 3568 }, 3569 { 3570 "type": "string", 3571 "description": "name of the repo", 3572 "name": "repo", 3573 "in": "path", 3574 "required": true 3575 }, 3576 { 3577 "type": "integer", 3578 "description": "id of the release to get", 3579 "name": "id", 3580 "in": "path", 3581 "required": true 3582 } 3583 ], 3584 "responses": { 3585 "200": { 3586 "$ref": "#/responses/Release" 3587 } 3588 } 3589 }, 3590 "delete": { 3591 "tags": [ 3592 "repository" 3593 ], 3594 "summary": "Delete a release", 3595 "operationId": "repoDeleteRelease", 3596 "parameters": [ 3597 { 3598 "type": "string", 3599 "description": "owner of the repo", 3600 "name": "owner", 3601 "in": "path", 3602 "required": true 3603 }, 3604 { 3605 "type": "string", 3606 "description": "name of the repo", 3607 "name": "repo", 3608 "in": "path", 3609 "required": true 3610 }, 3611 { 3612 "type": "integer", 3613 "description": "id of the release to delete", 3614 "name": "id", 3615 "in": "path", 3616 "required": true 3617 } 3618 ], 3619 "responses": { 3620 "204": { 3621 "$ref": "#/responses/empty" 3622 } 3623 } 3624 }, 3625 "patch": { 3626 "consumes": [ 3627 "application/json" 3628 ], 3629 "produces": [ 3630 "application/json" 3631 ], 3632 "tags": [ 3633 "repository" 3634 ], 3635 "summary": "Update a release", 3636 "operationId": "repoEditRelease", 3637 "parameters": [ 3638 { 3639 "type": "string", 3640 "description": "owner of the repo", 3641 "name": "owner", 3642 "in": "path", 3643 "required": true 3644 }, 3645 { 3646 "type": "string", 3647 "description": "name of the repo", 3648 "name": "repo", 3649 "in": "path", 3650 "required": true 3651 }, 3652 { 3653 "type": "integer", 3654 "description": "id of the release to edit", 3655 "name": "id", 3656 "in": "path", 3657 "required": true 3658 }, 3659 { 3660 "name": "body", 3661 "in": "body", 3662 "schema": { 3663 "$ref": "#/definitions/EditReleaseOption" 3664 } 3665 } 3666 ], 3667 "responses": { 3668 "200": { 3669 "$ref": "#/responses/Release" 3670 } 3671 } 3672 } 3673 }, 3674 "/repos/{owner}/{repo}/releases/{id}/assets": { 3675 "get": { 3676 "produces": [ 3677 "application/json" 3678 ], 3679 "tags": [ 3680 "repository" 3681 ], 3682 "summary": "List release's attachments", 3683 "operationId": "repoListReleaseAttachments", 3684 "parameters": [ 3685 { 3686 "type": "string", 3687 "description": "owner of the repo", 3688 "name": "owner", 3689 "in": "path", 3690 "required": true 3691 }, 3692 { 3693 "type": "string", 3694 "description": "name of the repo", 3695 "name": "repo", 3696 "in": "path", 3697 "required": true 3698 }, 3699 { 3700 "type": "integer", 3701 "description": "id of the release", 3702 "name": "id", 3703 "in": "path", 3704 "required": true 3705 } 3706 ], 3707 "responses": { 3708 "200": { 3709 "$ref": "#/responses/AttachmentList" 3710 } 3711 } 3712 }, 3713 "post": { 3714 "consumes": [ 3715 "multipart/form-data" 3716 ], 3717 "produces": [ 3718 "application/json" 3719 ], 3720 "tags": [ 3721 "repository" 3722 ], 3723 "summary": "Create a release attachment", 3724 "operationId": "repoCreateReleaseAttachment", 3725 "parameters": [ 3726 { 3727 "type": "string", 3728 "description": "owner of the repo", 3729 "name": "owner", 3730 "in": "path", 3731 "required": true 3732 }, 3733 { 3734 "type": "string", 3735 "description": "name of the repo", 3736 "name": "repo", 3737 "in": "path", 3738 "required": true 3739 }, 3740 { 3741 "type": "integer", 3742 "description": "id of the release", 3743 "name": "id", 3744 "in": "path", 3745 "required": true 3746 }, 3747 { 3748 "type": "string", 3749 "description": "name of the attachment", 3750 "name": "name", 3751 "in": "query" 3752 }, 3753 { 3754 "type": "file", 3755 "description": "attachment to upload", 3756 "name": "attachment", 3757 "in": "formData", 3758 "required": true 3759 } 3760 ], 3761 "responses": { 3762 "201": { 3763 "$ref": "#/responses/Attachment" 3764 } 3765 } 3766 } 3767 }, 3768 "/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}": { 3769 "get": { 3770 "produces": [ 3771 "application/json" 3772 ], 3773 "tags": [ 3774 "repository" 3775 ], 3776 "summary": "Get a release attachment", 3777 "operationId": "repoGetReleaseAttachment", 3778 "parameters": [ 3779 { 3780 "type": "string", 3781 "description": "owner of the repo", 3782 "name": "owner", 3783 "in": "path", 3784 "required": true 3785 }, 3786 { 3787 "type": "string", 3788 "description": "name of the repo", 3789 "name": "repo", 3790 "in": "path", 3791 "required": true 3792 }, 3793 { 3794 "type": "integer", 3795 "description": "id of the release", 3796 "name": "id", 3797 "in": "path", 3798 "required": true 3799 }, 3800 { 3801 "type": "integer", 3802 "description": "id of the attachment to get", 3803 "name": "attachment_id", 3804 "in": "path", 3805 "required": true 3806 } 3807 ], 3808 "responses": { 3809 "200": { 3810 "$ref": "#/responses/Attachment" 3811 } 3812 } 3813 }, 3814 "delete": { 3815 "produces": [ 3816 "application/json" 3817 ], 3818 "tags": [ 3819 "repository" 3820 ], 3821 "summary": "Delete a release attachment", 3822 "operationId": "repoDeleteReleaseAttachment", 3823 "parameters": [ 3824 { 3825 "type": "string", 3826 "description": "owner of the repo", 3827 "name": "owner", 3828 "in": "path", 3829 "required": true 3830 }, 3831 { 3832 "type": "string", 3833 "description": "name of the repo", 3834 "name": "repo", 3835 "in": "path", 3836 "required": true 3837 }, 3838 { 3839 "type": "integer", 3840 "description": "id of the release", 3841 "name": "id", 3842 "in": "path", 3843 "required": true 3844 }, 3845 { 3846 "type": "integer", 3847 "description": "id of the attachment to delete", 3848 "name": "attachment_id", 3849 "in": "path", 3850 "required": true 3851 } 3852 ], 3853 "responses": { 3854 "204": { 3855 "$ref": "#/responses/empty" 3856 } 3857 } 3858 }, 3859 "patch": { 3860 "consumes": [ 3861 "application/json" 3862 ], 3863 "produces": [ 3864 "application/json" 3865 ], 3866 "tags": [ 3867 "repository" 3868 ], 3869 "summary": "Edit a release attachment", 3870 "operationId": "repoEditReleaseAttachment", 3871 "parameters": [ 3872 { 3873 "type": "string", 3874 "description": "owner of the repo", 3875 "name": "owner", 3876 "in": "path", 3877 "required": true 3878 }, 3879 { 3880 "type": "string", 3881 "description": "name of the repo", 3882 "name": "repo", 3883 "in": "path", 3884 "required": true 3885 }, 3886 { 3887 "type": "integer", 3888 "description": "id of the release", 3889 "name": "id", 3890 "in": "path", 3891 "required": true 3892 }, 3893 { 3894 "type": "integer", 3895 "description": "id of the attachment to edit", 3896 "name": "attachment_id", 3897 "in": "path", 3898 "required": true 3899 }, 3900 { 3901 "name": "body", 3902 "in": "body", 3903 "schema": { 3904 "$ref": "#/definitions/EditAttachmentOptions" 3905 } 3906 } 3907 ], 3908 "responses": { 3909 "201": { 3910 "$ref": "#/responses/Attachment" 3911 } 3912 } 3913 } 3914 }, 3915 "/repos/{owner}/{repo}/stargazers": { 3916 "get": { 3917 "produces": [ 3918 "application/json" 3919 ], 3920 "tags": [ 3921 "repository" 3922 ], 3923 "summary": "List a repo's stargazers", 3924 "operationId": "repoListStargazers", 3925 "parameters": [ 3926 { 3927 "type": "string", 3928 "description": "owner of the repo", 3929 "name": "owner", 3930 "in": "path", 3931 "required": true 3932 }, 3933 { 3934 "type": "string", 3935 "description": "name of the repo", 3936 "name": "repo", 3937 "in": "path", 3938 "required": true 3939 } 3940 ], 3941 "responses": { 3942 "200": { 3943 "$ref": "#/responses/UserList" 3944 } 3945 } 3946 } 3947 }, 3948 "/repos/{owner}/{repo}/statuses/{sha}": { 3949 "get": { 3950 "produces": [ 3951 "application/json" 3952 ], 3953 "tags": [ 3954 "repository" 3955 ], 3956 "summary": "Get a commit's statuses", 3957 "operationId": "repoListStatuses", 3958 "parameters": [ 3959 { 3960 "type": "string", 3961 "description": "owner of the repo", 3962 "name": "owner", 3963 "in": "path", 3964 "required": true 3965 }, 3966 { 3967 "type": "string", 3968 "description": "name of the repo", 3969 "name": "repo", 3970 "in": "path", 3971 "required": true 3972 }, 3973 { 3974 "type": "string", 3975 "description": "sha of the commit", 3976 "name": "sha", 3977 "in": "path", 3978 "required": true 3979 } 3980 ], 3981 "responses": { 3982 "200": { 3983 "$ref": "#/responses/StatusList" 3984 } 3985 } 3986 }, 3987 "post": { 3988 "produces": [ 3989 "application/json" 3990 ], 3991 "tags": [ 3992 "repository" 3993 ], 3994 "summary": "Create a commit status", 3995 "operationId": "repoCreateStatus", 3996 "parameters": [ 3997 { 3998 "type": "string", 3999 "description": "owner of the repo", 4000 "name": "owner", 4001 "in": "path", 4002 "required": true 4003 }, 4004 { 4005 "type": "string", 4006 "description": "name of the repo", 4007 "name": "repo", 4008 "in": "path", 4009 "required": true 4010 }, 4011 { 4012 "type": "string", 4013 "description": "sha of the commit", 4014 "name": "sha", 4015 "in": "path", 4016 "required": true 4017 }, 4018 { 4019 "name": "body", 4020 "in": "body", 4021 "schema": { 4022 "$ref": "#/definitions/CreateStatusOption" 4023 } 4024 } 4025 ], 4026 "responses": { 4027 "200": { 4028 "$ref": "#/responses/StatusList" 4029 } 4030 } 4031 } 4032 }, 4033 "/repos/{owner}/{repo}/subscribers": { 4034 "get": { 4035 "produces": [ 4036 "application/json" 4037 ], 4038 "tags": [ 4039 "repository" 4040 ], 4041 "summary": "List a repo's watchers", 4042 "operationId": "repoListSubscribers", 4043 "parameters": [ 4044 { 4045 "type": "string", 4046 "description": "owner of the repo", 4047 "name": "owner", 4048 "in": "path", 4049 "required": true 4050 }, 4051 { 4052 "type": "string", 4053 "description": "name of the repo", 4054 "name": "repo", 4055 "in": "path", 4056 "required": true 4057 } 4058 ], 4059 "responses": { 4060 "200": { 4061 "$ref": "#/responses/UserList" 4062 } 4063 } 4064 } 4065 }, 4066 "/repos/{owner}/{repo}/subscription": { 4067 "get": { 4068 "tags": [ 4069 "repository" 4070 ], 4071 "summary": "Check if the current user is watching a repo", 4072 "operationId": "userCurrentCheckSubscription", 4073 "parameters": [ 4074 { 4075 "type": "string", 4076 "description": "owner of the repo", 4077 "name": "owner", 4078 "in": "path", 4079 "required": true 4080 }, 4081 { 4082 "type": "string", 4083 "description": "name of the repo", 4084 "name": "repo", 4085 "in": "path", 4086 "required": true 4087 } 4088 ], 4089 "responses": { 4090 "200": { 4091 "$ref": "#/responses/WatchInfo" 4092 } 4093 } 4094 }, 4095 "put": { 4096 "tags": [ 4097 "repository" 4098 ], 4099 "summary": "Watch a repo", 4100 "operationId": "userCurrentPutSubscription", 4101 "parameters": [ 4102 { 4103 "type": "string", 4104 "description": "owner of the repo", 4105 "name": "owner", 4106 "in": "path", 4107 "required": true 4108 }, 4109 { 4110 "type": "string", 4111 "description": "name of the repo", 4112 "name": "repo", 4113 "in": "path", 4114 "required": true 4115 } 4116 ], 4117 "responses": { 4118 "200": { 4119 "$ref": "#/responses/WatchInfo" 4120 } 4121 } 4122 }, 4123 "delete": { 4124 "tags": [ 4125 "repository" 4126 ], 4127 "summary": "Unwatch a repo", 4128 "operationId": "userCurrentDeleteSubscription", 4129 "parameters": [ 4130 { 4131 "type": "string", 4132 "description": "owner of the repo", 4133 "name": "owner", 4134 "in": "path", 4135 "required": true 4136 }, 4137 { 4138 "type": "string", 4139 "description": "name of the repo", 4140 "name": "repo", 4141 "in": "path", 4142 "required": true 4143 } 4144 ], 4145 "responses": { 4146 "204": { 4147 "$ref": "#/responses/empty" 4148 } 4149 } 4150 } 4151 }, 4152 "/repos/{owner}/{repo}/times": { 4153 "get": { 4154 "produces": [ 4155 "application/json" 4156 ], 4157 "tags": [ 4158 "repository" 4159 ], 4160 "summary": "List a repo's tracked times", 4161 "operationId": "repoTrackedTimes", 4162 "parameters": [ 4163 { 4164 "type": "string", 4165 "description": "owner of the repo", 4166 "name": "owner", 4167 "in": "path", 4168 "required": true 4169 }, 4170 { 4171 "type": "string", 4172 "description": "name of the repo", 4173 "name": "repo", 4174 "in": "path", 4175 "required": true 4176 } 4177 ], 4178 "responses": { 4179 "200": { 4180 "$ref": "#/responses/TrackedTimeList" 4181 } 4182 } 4183 } 4184 }, 4185 "/repos/{owner}/{repo}/times/{user}": { 4186 "get": { 4187 "produces": [ 4188 "application/json" 4189 ], 4190 "tags": [ 4191 "user" 4192 ], 4193 "summary": "List a user's tracked times in a repo", 4194 "operationId": "userTrackedTimes", 4195 "parameters": [ 4196 { 4197 "type": "string", 4198 "description": "owner of the repo", 4199 "name": "owner", 4200 "in": "path", 4201 "required": true 4202 }, 4203 { 4204 "type": "string", 4205 "description": "name of the repo", 4206 "name": "repo", 4207 "in": "path", 4208 "required": true 4209 }, 4210 { 4211 "type": "string", 4212 "description": "username of user", 4213 "name": "user", 4214 "in": "path", 4215 "required": true 4216 } 4217 ], 4218 "responses": { 4219 "200": { 4220 "$ref": "#/responses/TrackedTimeList" 4221 } 4222 } 4223 } 4224 }, 4225 "/repositories/{id}": { 4226 "get": { 4227 "produces": [ 4228 "application/json" 4229 ], 4230 "tags": [ 4231 "repository" 4232 ], 4233 "summary": "Get a repository by id", 4234 "operationId": "repoGetByID", 4235 "parameters": [ 4236 { 4237 "type": "integer", 4238 "description": "id of the repo to get", 4239 "name": "id", 4240 "in": "path", 4241 "required": true 4242 } 4243 ], 4244 "responses": { 4245 "200": { 4246 "$ref": "#/responses/Repository" 4247 } 4248 } 4249 } 4250 }, 4251 "/teams/{id}": { 4252 "get": { 4253 "produces": [ 4254 "application/json" 4255 ], 4256 "tags": [ 4257 "organization" 4258 ], 4259 "summary": "Get a team", 4260 "operationId": "orgGetTeam", 4261 "parameters": [ 4262 { 4263 "type": "integer", 4264 "description": "id of the team to get", 4265 "name": "id", 4266 "in": "path", 4267 "required": true 4268 } 4269 ], 4270 "responses": { 4271 "200": { 4272 "$ref": "#/responses/Team" 4273 } 4274 } 4275 }, 4276 "delete": { 4277 "tags": [ 4278 "organization" 4279 ], 4280 "summary": "Delete a team", 4281 "operationId": "orgDeleteTeam", 4282 "parameters": [ 4283 { 4284 "type": "integer", 4285 "description": "id of the team to delete", 4286 "name": "id", 4287 "in": "path", 4288 "required": true 4289 } 4290 ], 4291 "responses": { 4292 "204": { 4293 "description": "team deleted", 4294 "schema": { 4295 "$ref": "#/responses/empty" 4296 } 4297 } 4298 } 4299 }, 4300 "patch": { 4301 "consumes": [ 4302 "application/json" 4303 ], 4304 "produces": [ 4305 "application/json" 4306 ], 4307 "tags": [ 4308 "organization" 4309 ], 4310 "summary": "Edit a team", 4311 "operationId": "orgEditTeam", 4312 "parameters": [ 4313 { 4314 "type": "integer", 4315 "description": "id of the team to edit", 4316 "name": "id", 4317 "in": "path", 4318 "required": true 4319 }, 4320 { 4321 "name": "body", 4322 "in": "body", 4323 "schema": { 4324 "$ref": "#/definitions/EditTeamOption" 4325 } 4326 } 4327 ], 4328 "responses": { 4329 "200": { 4330 "$ref": "#/responses/Team" 4331 } 4332 } 4333 } 4334 }, 4335 "/teams/{id}/members": { 4336 "get": { 4337 "produces": [ 4338 "application/json" 4339 ], 4340 "tags": [ 4341 "organization" 4342 ], 4343 "summary": "List a team's members", 4344 "operationId": "orgListTeamMembers", 4345 "parameters": [ 4346 { 4347 "type": "integer", 4348 "description": "id of the team", 4349 "name": "id", 4350 "in": "path", 4351 "required": true 4352 } 4353 ], 4354 "responses": { 4355 "200": { 4356 "$ref": "#/responses/UserList" 4357 } 4358 } 4359 } 4360 }, 4361 "/teams/{id}/members/{username}": { 4362 "put": { 4363 "produces": [ 4364 "application/json" 4365 ], 4366 "tags": [ 4367 "organization" 4368 ], 4369 "summary": "Add a team member", 4370 "operationId": "orgAddTeamMember", 4371 "parameters": [ 4372 { 4373 "type": "integer", 4374 "description": "id of the team", 4375 "name": "id", 4376 "in": "path", 4377 "required": true 4378 }, 4379 { 4380 "type": "string", 4381 "description": "username of the user to add", 4382 "name": "username", 4383 "in": "path", 4384 "required": true 4385 } 4386 ], 4387 "responses": { 4388 "204": { 4389 "$ref": "#/responses/empty" 4390 } 4391 } 4392 }, 4393 "delete": { 4394 "produces": [ 4395 "application/json" 4396 ], 4397 "tags": [ 4398 "organization" 4399 ], 4400 "summary": "Remove a team member", 4401 "operationId": "orgRemoveTeamMember", 4402 "parameters": [ 4403 { 4404 "type": "integer", 4405 "description": "id of the team", 4406 "name": "id", 4407 "in": "path", 4408 "required": true 4409 }, 4410 { 4411 "type": "string", 4412 "description": "username of the user to remove", 4413 "name": "username", 4414 "in": "path", 4415 "required": true 4416 } 4417 ], 4418 "responses": { 4419 "204": { 4420 "$ref": "#/responses/empty" 4421 } 4422 } 4423 } 4424 }, 4425 "/teams/{id}/repos": { 4426 "get": { 4427 "produces": [ 4428 "application/json" 4429 ], 4430 "tags": [ 4431 "organization" 4432 ], 4433 "summary": "List a team's repos", 4434 "operationId": "orgListTeamRepos", 4435 "parameters": [ 4436 { 4437 "type": "integer", 4438 "description": "id of the team", 4439 "name": "id", 4440 "in": "path", 4441 "required": true 4442 } 4443 ], 4444 "responses": { 4445 "200": { 4446 "$ref": "#/responses/RepositoryList" 4447 } 4448 } 4449 } 4450 }, 4451 "/teams/{id}/repos/{org}/{repo}": { 4452 "put": { 4453 "produces": [ 4454 "application/json" 4455 ], 4456 "tags": [ 4457 "organization" 4458 ], 4459 "summary": "Add a repository to a team", 4460 "operationId": "orgAddTeamRepository", 4461 "parameters": [ 4462 { 4463 "type": "integer", 4464 "description": "id of the team", 4465 "name": "id", 4466 "in": "path", 4467 "required": true 4468 }, 4469 { 4470 "type": "string", 4471 "description": "organization that owns the repo to add", 4472 "name": "org", 4473 "in": "path", 4474 "required": true 4475 }, 4476 { 4477 "type": "string", 4478 "description": "name of the repo to add", 4479 "name": "repo", 4480 "in": "path", 4481 "required": true 4482 } 4483 ], 4484 "responses": { 4485 "204": { 4486 "$ref": "#/responses/empty" 4487 } 4488 } 4489 }, 4490 "delete": { 4491 "description": "This does not delete the repository, it only removes the repository from the team.", 4492 "produces": [ 4493 "application/json" 4494 ], 4495 "tags": [ 4496 "organization" 4497 ], 4498 "summary": "Remove a repository from a team", 4499 "operationId": "orgRemoveTeamRepository", 4500 "parameters": [ 4501 { 4502 "type": "integer", 4503 "description": "id of the team", 4504 "name": "id", 4505 "in": "path", 4506 "required": true 4507 }, 4508 { 4509 "type": "string", 4510 "description": "organization that owns the repo to remove", 4511 "name": "org", 4512 "in": "path", 4513 "required": true 4514 }, 4515 { 4516 "type": "string", 4517 "description": "name of the repo to remove", 4518 "name": "repo", 4519 "in": "path", 4520 "required": true 4521 } 4522 ], 4523 "responses": { 4524 "204": { 4525 "$ref": "#/responses/empty" 4526 } 4527 } 4528 } 4529 }, 4530 "/topics/search": { 4531 "get": { 4532 "produces": [ 4533 "application/json" 4534 ], 4535 "tags": [ 4536 "repository" 4537 ], 4538 "summary": "search topics via keyword", 4539 "operationId": "topicSearch", 4540 "parameters": [ 4541 { 4542 "type": "string", 4543 "description": "keywords to search", 4544 "name": "q", 4545 "in": "query", 4546 "required": true 4547 } 4548 ], 4549 "responses": { 4550 "200": { 4551 "$ref": "#/responses/Repository" 4552 } 4553 } 4554 } 4555 }, 4556 "/user": { 4557 "get": { 4558 "produces": [ 4559 "application/json" 4560 ], 4561 "tags": [ 4562 "user" 4563 ], 4564 "summary": "Get the authenticated user", 4565 "operationId": "userGetCurrent", 4566 "responses": { 4567 "200": { 4568 "$ref": "#/responses/User" 4569 } 4570 } 4571 } 4572 }, 4573 "/user/emails": { 4574 "get": { 4575 "produces": [ 4576 "application/json" 4577 ], 4578 "tags": [ 4579 "user" 4580 ], 4581 "summary": "List the authenticated user's email addresses", 4582 "operationId": "userListEmails", 4583 "responses": { 4584 "200": { 4585 "$ref": "#/responses/EmailList" 4586 } 4587 } 4588 }, 4589 "post": { 4590 "produces": [ 4591 "application/json" 4592 ], 4593 "tags": [ 4594 "user" 4595 ], 4596 "summary": "Add email addresses", 4597 "operationId": "userAddEmail", 4598 "parameters": [ 4599 { 4600 "name": "body", 4601 "in": "body", 4602 "schema": { 4603 "$ref": "#/definitions/CreateEmailOption" 4604 } 4605 } 4606 ], 4607 "responses": { 4608 "201": { 4609 "$ref": "#/responses/EmailList" 4610 } 4611 } 4612 }, 4613 "delete": { 4614 "produces": [ 4615 "application/json" 4616 ], 4617 "tags": [ 4618 "user" 4619 ], 4620 "summary": "Delete email addresses", 4621 "operationId": "userDeleteEmail", 4622 "parameters": [ 4623 { 4624 "name": "body", 4625 "in": "body", 4626 "schema": { 4627 "$ref": "#/definitions/DeleteEmailOption" 4628 } 4629 } 4630 ], 4631 "responses": { 4632 "204": { 4633 "$ref": "#/responses/empty" 4634 } 4635 } 4636 } 4637 }, 4638 "/user/followers": { 4639 "get": { 4640 "produces": [ 4641 "application/json" 4642 ], 4643 "tags": [ 4644 "user" 4645 ], 4646 "summary": "List the authenticated user's followers", 4647 "operationId": "userCurrentListFollowers", 4648 "responses": { 4649 "200": { 4650 "$ref": "#/responses/UserList" 4651 } 4652 } 4653 } 4654 }, 4655 "/user/following": { 4656 "get": { 4657 "produces": [ 4658 "application/json" 4659 ], 4660 "tags": [ 4661 "user" 4662 ], 4663 "summary": "List the users that the authenticated user is following", 4664 "operationId": "userCurrentListFollowing", 4665 "responses": { 4666 "200": { 4667 "$ref": "#/responses/UserList" 4668 } 4669 } 4670 } 4671 }, 4672 "/user/following/{username}": { 4673 "get": { 4674 "tags": [ 4675 "user" 4676 ], 4677 "summary": "Check whether a user is followed by the authenticated user", 4678 "operationId": "userCurrentCheckFollowing", 4679 "parameters": [ 4680 { 4681 "type": "string", 4682 "description": "username of followed user", 4683 "name": "username", 4684 "in": "path", 4685 "required": true 4686 } 4687 ], 4688 "responses": { 4689 "204": { 4690 "$ref": "#/responses/empty" 4691 }, 4692 "404": { 4693 "$ref": "#/responses/notFound" 4694 } 4695 } 4696 }, 4697 "put": { 4698 "tags": [ 4699 "user" 4700 ], 4701 "summary": "Follow a user", 4702 "operationId": "userCurrentPutFollow", 4703 "parameters": [ 4704 { 4705 "type": "string", 4706 "description": "username of user to follow", 4707 "name": "username", 4708 "in": "path", 4709 "required": true 4710 } 4711 ], 4712 "responses": { 4713 "204": { 4714 "$ref": "#/responses/empty" 4715 } 4716 } 4717 }, 4718 "delete": { 4719 "tags": [ 4720 "user" 4721 ], 4722 "summary": "Unfollow a user", 4723 "operationId": "userCurrentDeleteFollow", 4724 "parameters": [ 4725 { 4726 "type": "string", 4727 "description": "username of user to unfollow", 4728 "name": "username", 4729 "in": "path", 4730 "required": true 4731 } 4732 ], 4733 "responses": { 4734 "204": { 4735 "$ref": "#/responses/empty" 4736 } 4737 } 4738 } 4739 }, 4740 "/user/gpg_keys": { 4741 "get": { 4742 "produces": [ 4743 "application/json" 4744 ], 4745 "tags": [ 4746 "user" 4747 ], 4748 "summary": "List the authenticated user's GPG keys", 4749 "operationId": "userCurrentListGPGKeys", 4750 "responses": { 4751 "200": { 4752 "$ref": "#/responses/GPGKeyList" 4753 } 4754 } 4755 }, 4756 "post": { 4757 "consumes": [ 4758 "application/json" 4759 ], 4760 "produces": [ 4761 "application/json" 4762 ], 4763 "tags": [ 4764 "user" 4765 ], 4766 "summary": "Create a GPG key", 4767 "operationId": "userCurrentPostGPGKey", 4768 "parameters": [ 4769 { 4770 "name": "Form", 4771 "in": "body", 4772 "schema": { 4773 "$ref": "#/definitions/CreateGPGKeyOption" 4774 } 4775 } 4776 ], 4777 "responses": { 4778 "201": { 4779 "$ref": "#/responses/GPGKey" 4780 }, 4781 "422": { 4782 "$ref": "#/responses/validationError" 4783 } 4784 } 4785 } 4786 }, 4787 "/user/gpg_keys/{id}": { 4788 "get": { 4789 "produces": [ 4790 "application/json" 4791 ], 4792 "tags": [ 4793 "user" 4794 ], 4795 "summary": "Get a GPG key", 4796 "operationId": "userCurrentGetGPGKey", 4797 "parameters": [ 4798 { 4799 "type": "integer", 4800 "description": "id of key to get", 4801 "name": "id", 4802 "in": "path", 4803 "required": true 4804 } 4805 ], 4806 "responses": { 4807 "200": { 4808 "$ref": "#/responses/GPGKey" 4809 }, 4810 "404": { 4811 "$ref": "#/responses/notFound" 4812 } 4813 } 4814 }, 4815 "delete": { 4816 "produces": [ 4817 "application/json" 4818 ], 4819 "tags": [ 4820 "user" 4821 ], 4822 "summary": "Remove a GPG key", 4823 "operationId": "userCurrentDeleteGPGKey", 4824 "parameters": [ 4825 { 4826 "type": "integer", 4827 "description": "id of key to delete", 4828 "name": "id", 4829 "in": "path", 4830 "required": true 4831 } 4832 ], 4833 "responses": { 4834 "204": { 4835 "$ref": "#/responses/empty" 4836 }, 4837 "403": { 4838 "$ref": "#/responses/forbidden" 4839 } 4840 } 4841 } 4842 }, 4843 "/user/keys": { 4844 "get": { 4845 "produces": [ 4846 "application/json" 4847 ], 4848 "tags": [ 4849 "user" 4850 ], 4851 "summary": "List the authenticated user's public keys", 4852 "operationId": "userCurrentListKeys", 4853 "responses": { 4854 "200": { 4855 "$ref": "#/responses/PublicKeyList" 4856 } 4857 } 4858 }, 4859 "post": { 4860 "consumes": [ 4861 "application/json" 4862 ], 4863 "produces": [ 4864 "application/json" 4865 ], 4866 "tags": [ 4867 "user" 4868 ], 4869 "summary": "Create a public key", 4870 "operationId": "userCurrentPostKey", 4871 "parameters": [ 4872 { 4873 "name": "body", 4874 "in": "body", 4875 "schema": { 4876 "$ref": "#/definitions/CreateKeyOption" 4877 } 4878 } 4879 ], 4880 "responses": { 4881 "201": { 4882 "$ref": "#/responses/PublicKey" 4883 }, 4884 "422": { 4885 "$ref": "#/responses/validationError" 4886 } 4887 } 4888 } 4889 }, 4890 "/user/keys/{id}": { 4891 "get": { 4892 "produces": [ 4893 "application/json" 4894 ], 4895 "tags": [ 4896 "user" 4897 ], 4898 "summary": "Get a public key", 4899 "operationId": "userCurrentGetKey", 4900 "parameters": [ 4901 { 4902 "type": "integer", 4903 "description": "id of key to get", 4904 "name": "id", 4905 "in": "path", 4906 "required": true 4907 } 4908 ], 4909 "responses": { 4910 "200": { 4911 "$ref": "#/responses/PublicKey" 4912 }, 4913 "404": { 4914 "$ref": "#/responses/notFound" 4915 } 4916 } 4917 }, 4918 "delete": { 4919 "produces": [ 4920 "application/json" 4921 ], 4922 "tags": [ 4923 "user" 4924 ], 4925 "summary": "Delete a public key", 4926 "operationId": "userCurrentDeleteKey", 4927 "parameters": [ 4928 { 4929 "type": "integer", 4930 "description": "id of key to delete", 4931 "name": "id", 4932 "in": "path", 4933 "required": true 4934 } 4935 ], 4936 "responses": { 4937 "204": { 4938 "$ref": "#/responses/empty" 4939 }, 4940 "403": { 4941 "$ref": "#/responses/forbidden" 4942 }, 4943 "404": { 4944 "$ref": "#/responses/notFound" 4945 } 4946 } 4947 } 4948 }, 4949 "/user/orgs": { 4950 "get": { 4951 "produces": [ 4952 "application/json" 4953 ], 4954 "tags": [ 4955 "organization" 4956 ], 4957 "summary": "List the current user's organizations", 4958 "operationId": "orgListCurrentUserOrgs", 4959 "responses": { 4960 "200": { 4961 "$ref": "#/responses/OrganizationList" 4962 } 4963 } 4964 } 4965 }, 4966 "/user/repos": { 4967 "get": { 4968 "produces": [ 4969 "application/json" 4970 ], 4971 "tags": [ 4972 "user" 4973 ], 4974 "summary": "List the repos that the authenticated user owns or has access to", 4975 "operationId": "userCurrentListRepos", 4976 "responses": { 4977 "200": { 4978 "$ref": "#/responses/RepositoryList" 4979 } 4980 } 4981 }, 4982 "post": { 4983 "consumes": [ 4984 "application/json" 4985 ], 4986 "produces": [ 4987 "application/json" 4988 ], 4989 "tags": [ 4990 "repository", 4991 "user" 4992 ], 4993 "summary": "Create a repository", 4994 "operationId": "createCurrentUserRepo", 4995 "parameters": [ 4996 { 4997 "name": "body", 4998 "in": "body", 4999 "schema": { 5000 "$ref": "#/definitions/CreateRepoOption" 5001 } 5002 } 5003 ], 5004 "responses": { 5005 "201": { 5006 "$ref": "#/responses/Repository" 5007 } 5008 } 5009 } 5010 }, 5011 "/user/starred": { 5012 "get": { 5013 "produces": [ 5014 "application/json" 5015 ], 5016 "tags": [ 5017 "user" 5018 ], 5019 "summary": "The repos that the authenticated user has starred", 5020 "operationId": "userCurrentListStarred", 5021 "responses": { 5022 "200": { 5023 "$ref": "#/responses/RepositoryList" 5024 } 5025 } 5026 } 5027 }, 5028 "/user/starred/{owner}/{repo}": { 5029 "get": { 5030 "tags": [ 5031 "user" 5032 ], 5033 "summary": "Whether the authenticated is starring the repo", 5034 "operationId": "userCurrentCheckStarring", 5035 "parameters": [ 5036 { 5037 "type": "string", 5038 "description": "owner of the repo", 5039 "name": "owner", 5040 "in": "path", 5041 "required": true 5042 }, 5043 { 5044 "type": "string", 5045 "description": "name of the repo", 5046 "name": "repo", 5047 "in": "path", 5048 "required": true 5049 } 5050 ], 5051 "responses": { 5052 "204": { 5053 "$ref": "#/responses/empty" 5054 }, 5055 "404": { 5056 "$ref": "#/responses/notFound" 5057 } 5058 } 5059 }, 5060 "put": { 5061 "tags": [ 5062 "user" 5063 ], 5064 "summary": "Star the given repo", 5065 "operationId": "userCurrentPutStar", 5066 "parameters": [ 5067 { 5068 "type": "string", 5069 "description": "owner of the repo to star", 5070 "name": "owner", 5071 "in": "path", 5072 "required": true 5073 }, 5074 { 5075 "type": "string", 5076 "description": "name of the repo to star", 5077 "name": "repo", 5078 "in": "path", 5079 "required": true 5080 } 5081 ], 5082 "responses": { 5083 "204": { 5084 "$ref": "#/responses/empty" 5085 } 5086 } 5087 }, 5088 "delete": { 5089 "tags": [ 5090 "user" 5091 ], 5092 "summary": "Unstar the given repo", 5093 "operationId": "userCurrentDeleteStar", 5094 "parameters": [ 5095 { 5096 "type": "string", 5097 "description": "owner of the repo to unstar", 5098 "name": "owner", 5099 "in": "path", 5100 "required": true 5101 }, 5102 { 5103 "type": "string", 5104 "description": "name of the repo to unstar", 5105 "name": "repo", 5106 "in": "path", 5107 "required": true 5108 } 5109 ], 5110 "responses": { 5111 "204": { 5112 "$ref": "#/responses/empty" 5113 } 5114 } 5115 } 5116 }, 5117 "/user/subscriptions": { 5118 "get": { 5119 "produces": [ 5120 "application/json" 5121 ], 5122 "tags": [ 5123 "user" 5124 ], 5125 "summary": "List repositories watched by the authenticated user", 5126 "operationId": "userCurrentListSubscriptions", 5127 "responses": { 5128 "200": { 5129 "$ref": "#/responses/RepositoryList" 5130 } 5131 } 5132 } 5133 }, 5134 "/user/times": { 5135 "get": { 5136 "produces": [ 5137 "application/json" 5138 ], 5139 "tags": [ 5140 "user" 5141 ], 5142 "summary": "List the current user's tracked times", 5143 "operationId": "userCurrentTrackedTimes", 5144 "responses": { 5145 "200": { 5146 "$ref": "#/responses/TrackedTimeList" 5147 } 5148 } 5149 } 5150 }, 5151 "/user/{username}/orgs": { 5152 "get": { 5153 "produces": [ 5154 "application/json" 5155 ], 5156 "tags": [ 5157 "organization" 5158 ], 5159 "summary": "List a user's organizations", 5160 "operationId": "orgListUserOrgs", 5161 "parameters": [ 5162 { 5163 "type": "string", 5164 "description": "username of user", 5165 "name": "username", 5166 "in": "path", 5167 "required": true 5168 } 5169 ], 5170 "responses": { 5171 "200": { 5172 "$ref": "#/responses/OrganizationList" 5173 } 5174 } 5175 } 5176 }, 5177 "/users/search": { 5178 "get": { 5179 "produces": [ 5180 "application/json" 5181 ], 5182 "tags": [ 5183 "user" 5184 ], 5185 "summary": "Search for users", 5186 "operationId": "userSearch", 5187 "parameters": [ 5188 { 5189 "type": "string", 5190 "description": "keyword", 5191 "name": "q", 5192 "in": "query" 5193 }, 5194 { 5195 "type": "integer", 5196 "description": "maximum number of users to return", 5197 "name": "limit", 5198 "in": "query" 5199 } 5200 ], 5201 "responses": { 5202 "200": { 5203 "$ref": "#/responses/UserList" 5204 } 5205 } 5206 } 5207 }, 5208 "/users/{follower}/following/{followee}": { 5209 "get": { 5210 "tags": [ 5211 "user" 5212 ], 5213 "summary": "Check if one user is following another user", 5214 "operationId": "userCheckFollowing", 5215 "parameters": [ 5216 { 5217 "type": "string", 5218 "description": "username of following user", 5219 "name": "follower", 5220 "in": "path", 5221 "required": true 5222 }, 5223 { 5224 "type": "string", 5225 "description": "username of followed user", 5226 "name": "followee", 5227 "in": "path", 5228 "required": true 5229 } 5230 ], 5231 "responses": { 5232 "204": { 5233 "$ref": "#/responses/empty" 5234 }, 5235 "404": { 5236 "$ref": "#/responses/notFound" 5237 } 5238 } 5239 } 5240 }, 5241 "/users/{username}": { 5242 "get": { 5243 "produces": [ 5244 "application/json" 5245 ], 5246 "tags": [ 5247 "user" 5248 ], 5249 "summary": "Get a user", 5250 "operationId": "userGet", 5251 "parameters": [ 5252 { 5253 "type": "string", 5254 "description": "username of user to get", 5255 "name": "username", 5256 "in": "path", 5257 "required": true 5258 } 5259 ], 5260 "responses": { 5261 "200": { 5262 "$ref": "#/responses/User" 5263 }, 5264 "404": { 5265 "$ref": "#/responses/notFound" 5266 } 5267 } 5268 } 5269 }, 5270 "/users/{username}/followers": { 5271 "get": { 5272 "produces": [ 5273 "application/json" 5274 ], 5275 "tags": [ 5276 "user" 5277 ], 5278 "summary": "List the given user's followers", 5279 "operationId": "userListFollowers", 5280 "parameters": [ 5281 { 5282 "type": "string", 5283 "description": "username of user", 5284 "name": "username", 5285 "in": "path", 5286 "required": true 5287 } 5288 ], 5289 "responses": { 5290 "200": { 5291 "$ref": "#/responses/UserList" 5292 } 5293 } 5294 } 5295 }, 5296 "/users/{username}/following": { 5297 "get": { 5298 "produces": [ 5299 "application/json" 5300 ], 5301 "tags": [ 5302 "user" 5303 ], 5304 "summary": "List the users that the given user is following", 5305 "operationId": "userListFollowing", 5306 "parameters": [ 5307 { 5308 "type": "string", 5309 "description": "username of user", 5310 "name": "username", 5311 "in": "path", 5312 "required": true 5313 } 5314 ], 5315 "responses": { 5316 "200": { 5317 "$ref": "#/responses/UserList" 5318 } 5319 } 5320 } 5321 }, 5322 "/users/{username}/gpg_keys": { 5323 "get": { 5324 "produces": [ 5325 "application/json" 5326 ], 5327 "tags": [ 5328 "user" 5329 ], 5330 "summary": "List the given user's GPG keys", 5331 "operationId": "userListGPGKeys", 5332 "parameters": [ 5333 { 5334 "type": "string", 5335 "description": "username of user", 5336 "name": "username", 5337 "in": "path", 5338 "required": true 5339 } 5340 ], 5341 "responses": { 5342 "200": { 5343 "$ref": "#/responses/GPGKeyList" 5344 } 5345 } 5346 } 5347 }, 5348 "/users/{username}/keys": { 5349 "get": { 5350 "produces": [ 5351 "application/json" 5352 ], 5353 "tags": [ 5354 "user" 5355 ], 5356 "summary": "List the given user's public keys", 5357 "operationId": "userListKeys", 5358 "parameters": [ 5359 { 5360 "type": "string", 5361 "description": "username of user", 5362 "name": "username", 5363 "in": "path", 5364 "required": true 5365 } 5366 ], 5367 "responses": { 5368 "200": { 5369 "$ref": "#/responses/PublicKeyList" 5370 } 5371 } 5372 } 5373 }, 5374 "/users/{username}/repos": { 5375 "get": { 5376 "produces": [ 5377 "application/json" 5378 ], 5379 "tags": [ 5380 "user" 5381 ], 5382 "summary": "List the repos owned by the given user", 5383 "operationId": "userListRepos", 5384 "parameters": [ 5385 { 5386 "type": "string", 5387 "description": "username of user", 5388 "name": "username", 5389 "in": "path", 5390 "required": true 5391 } 5392 ], 5393 "responses": { 5394 "200": { 5395 "$ref": "#/responses/RepositoryList" 5396 } 5397 } 5398 } 5399 }, 5400 "/users/{username}/starred": { 5401 "get": { 5402 "produces": [ 5403 "application/json" 5404 ], 5405 "tags": [ 5406 "user" 5407 ], 5408 "summary": "The repos that the given user has starred", 5409 "operationId": "userListStarred", 5410 "parameters": [ 5411 { 5412 "type": "string", 5413 "description": "username of user", 5414 "name": "username", 5415 "in": "path", 5416 "required": true 5417 } 5418 ], 5419 "responses": { 5420 "200": { 5421 "$ref": "#/responses/RepositoryList" 5422 } 5423 } 5424 } 5425 }, 5426 "/users/{username}/subscriptions": { 5427 "get": { 5428 "produces": [ 5429 "application/json" 5430 ], 5431 "tags": [ 5432 "user" 5433 ], 5434 "summary": "List the repositories watched by a user", 5435 "operationId": "userListSubscriptions", 5436 "parameters": [ 5437 { 5438 "type": "string", 5439 "description": "username of the user", 5440 "name": "username", 5441 "in": "path", 5442 "required": true 5443 } 5444 ], 5445 "responses": { 5446 "200": { 5447 "$ref": "#/responses/RepositoryList" 5448 } 5449 } 5450 } 5451 }, 5452 "/users/{username}/tokens": { 5453 "get": { 5454 "produces": [ 5455 "application/json" 5456 ], 5457 "tags": [ 5458 "user" 5459 ], 5460 "summary": "List the authenticated user's access tokens", 5461 "operationId": "userGetTokens", 5462 "parameters": [ 5463 { 5464 "type": "string", 5465 "description": "username of user", 5466 "name": "username", 5467 "in": "path", 5468 "required": true 5469 } 5470 ], 5471 "responses": { 5472 "200": { 5473 "$ref": "#/responses/AccessTokenList" 5474 } 5475 } 5476 }, 5477 "post": { 5478 "consumes": [ 5479 "application/json" 5480 ], 5481 "produces": [ 5482 "application/json" 5483 ], 5484 "tags": [ 5485 "user" 5486 ], 5487 "summary": "Create an access token", 5488 "operationId": "userCreateToken", 5489 "parameters": [ 5490 { 5491 "type": "string", 5492 "x-go-name": "Name", 5493 "description": "username of user", 5494 "name": "username", 5495 "in": "path", 5496 "required": true 5497 } 5498 ], 5499 "responses": { 5500 "200": { 5501 "$ref": "#/responses/AccessToken" 5502 } 5503 } 5504 } 5505 }, 5506 "/users/{username}/tokens/{token}": { 5507 "delete": { 5508 "produces": [ 5509 "application/json" 5510 ], 5511 "tags": [ 5512 "user" 5513 ], 5514 "summary": "delete an access token", 5515 "operationId": "userDeleteAccessToken", 5516 "parameters": [ 5517 { 5518 "type": "string", 5519 "description": "username of user", 5520 "name": "username", 5521 "in": "path", 5522 "required": true 5523 }, 5524 { 5525 "type": "integer", 5526 "description": "token to be deleted", 5527 "name": "token", 5528 "in": "path", 5529 "required": true 5530 } 5531 ], 5532 "responses": { 5533 "204": { 5534 "$ref": "#/responses/empty" 5535 } 5536 } 5537 } 5538 }, 5539 "/version": { 5540 "get": { 5541 "produces": [ 5542 "application/json" 5543 ], 5544 "tags": [ 5545 "miscellaneous" 5546 ], 5547 "summary": "Returns the version of the Gitea application", 5548 "operationId": "getVersion", 5549 "responses": { 5550 "200": { 5551 "$ref": "#/responses/ServerVersion" 5552 } 5553 } 5554 } 5555 } 5556 }, 5557 "definitions": { 5558 "AddCollaboratorOption": { 5559 "description": "AddCollaboratorOption options when adding a user as a collaborator of a repository", 5560 "type": "object", 5561 "properties": { 5562 "permission": { 5563 "type": "string", 5564 "x-go-name": "Permission" 5565 } 5566 }, 5567 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5568 }, 5569 "AddTimeOption": { 5570 "description": "AddTimeOption options for adding time to an issue", 5571 "type": "object", 5572 "required": [ 5573 "time" 5574 ], 5575 "properties": { 5576 "time": { 5577 "description": "time in seconds", 5578 "type": "integer", 5579 "format": "int64", 5580 "x-go-name": "Time" 5581 } 5582 }, 5583 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5584 }, 5585 "Attachment": { 5586 "description": "Attachment a generic attachment", 5587 "type": "object", 5588 "properties": { 5589 "browser_download_url": { 5590 "type": "string", 5591 "x-go-name": "DownloadURL" 5592 }, 5593 "created_at": { 5594 "type": "string", 5595 "format": "date-time", 5596 "x-go-name": "Created" 5597 }, 5598 "download_count": { 5599 "type": "integer", 5600 "format": "int64", 5601 "x-go-name": "DownloadCount" 5602 }, 5603 "id": { 5604 "type": "integer", 5605 "format": "int64", 5606 "x-go-name": "ID" 5607 }, 5608 "name": { 5609 "type": "string", 5610 "x-go-name": "Name" 5611 }, 5612 "size": { 5613 "type": "integer", 5614 "format": "int64", 5615 "x-go-name": "Size" 5616 }, 5617 "uuid": { 5618 "type": "string", 5619 "x-go-name": "UUID" 5620 } 5621 }, 5622 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5623 }, 5624 "Branch": { 5625 "description": "Branch represents a repository branch", 5626 "type": "object", 5627 "properties": { 5628 "commit": { 5629 "$ref": "#/definitions/PayloadCommit" 5630 }, 5631 "name": { 5632 "type": "string", 5633 "x-go-name": "Name" 5634 } 5635 }, 5636 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5637 }, 5638 "Comment": { 5639 "description": "Comment represents a comment on a commit or issue", 5640 "type": "object", 5641 "properties": { 5642 "body": { 5643 "type": "string", 5644 "x-go-name": "Body" 5645 }, 5646 "created_at": { 5647 "type": "string", 5648 "format": "date-time", 5649 "x-go-name": "Created" 5650 }, 5651 "html_url": { 5652 "type": "string", 5653 "x-go-name": "HTMLURL" 5654 }, 5655 "id": { 5656 "type": "integer", 5657 "format": "int64", 5658 "x-go-name": "ID" 5659 }, 5660 "issue_url": { 5661 "type": "string", 5662 "x-go-name": "IssueURL" 5663 }, 5664 "pull_request_url": { 5665 "type": "string", 5666 "x-go-name": "PRURL" 5667 }, 5668 "updated_at": { 5669 "type": "string", 5670 "format": "date-time", 5671 "x-go-name": "Updated" 5672 }, 5673 "user": { 5674 "$ref": "#/definitions/User" 5675 } 5676 }, 5677 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5678 }, 5679 "CreateEmailOption": { 5680 "description": "CreateEmailOption options when creating email addresses", 5681 "type": "object", 5682 "properties": { 5683 "emails": { 5684 "description": "email addresses to add", 5685 "type": "array", 5686 "items": { 5687 "type": "string" 5688 }, 5689 "x-go-name": "Emails" 5690 } 5691 }, 5692 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5693 }, 5694 "CreateForkOption": { 5695 "description": "CreateForkOption options for creating a fork", 5696 "type": "object", 5697 "properties": { 5698 "organization": { 5699 "description": "organization name, if forking into an organization", 5700 "type": "string", 5701 "x-go-name": "Organization" 5702 } 5703 }, 5704 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5705 }, 5706 "CreateGPGKeyOption": { 5707 "description": "CreateGPGKeyOption options create user GPG key", 5708 "type": "object", 5709 "required": [ 5710 "armored_public_key" 5711 ], 5712 "properties": { 5713 "armored_public_key": { 5714 "description": "An armored GPG key to add", 5715 "type": "string", 5716 "uniqueItems": true, 5717 "x-go-name": "ArmoredKey" 5718 } 5719 }, 5720 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5721 }, 5722 "CreateHookOption": { 5723 "description": "CreateHookOption options when create a hook", 5724 "type": "object", 5725 "required": [ 5726 "type", 5727 "config" 5728 ], 5729 "properties": { 5730 "active": { 5731 "type": "boolean", 5732 "default": false, 5733 "x-go-name": "Active" 5734 }, 5735 "config": { 5736 "type": "object", 5737 "additionalProperties": { 5738 "type": "string" 5739 }, 5740 "x-go-name": "Config" 5741 }, 5742 "events": { 5743 "type": "array", 5744 "items": { 5745 "type": "string" 5746 }, 5747 "x-go-name": "Events" 5748 }, 5749 "type": { 5750 "type": "string", 5751 "enum": [ 5752 "gitea", 5753 "gogs", 5754 "slack", 5755 "discord" 5756 ], 5757 "x-go-name": "Type" 5758 } 5759 }, 5760 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5761 }, 5762 "CreateIssueCommentOption": { 5763 "description": "CreateIssueCommentOption options for creating a comment on an issue", 5764 "type": "object", 5765 "required": [ 5766 "body" 5767 ], 5768 "properties": { 5769 "body": { 5770 "type": "string", 5771 "x-go-name": "Body" 5772 } 5773 }, 5774 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5775 }, 5776 "CreateIssueOption": { 5777 "description": "CreateIssueOption options to create one issue", 5778 "type": "object", 5779 "required": [ 5780 "title" 5781 ], 5782 "properties": { 5783 "assignee": { 5784 "description": "username of assignee", 5785 "type": "string", 5786 "x-go-name": "Assignee" 5787 }, 5788 "assignees": { 5789 "type": "array", 5790 "items": { 5791 "type": "string" 5792 }, 5793 "x-go-name": "Assignees" 5794 }, 5795 "body": { 5796 "type": "string", 5797 "x-go-name": "Body" 5798 }, 5799 "closed": { 5800 "type": "boolean", 5801 "x-go-name": "Closed" 5802 }, 5803 "due_date": { 5804 "type": "string", 5805 "format": "date-time", 5806 "x-go-name": "Deadline" 5807 }, 5808 "labels": { 5809 "description": "list of label ids", 5810 "type": "array", 5811 "items": { 5812 "type": "integer", 5813 "format": "int64" 5814 }, 5815 "x-go-name": "Labels" 5816 }, 5817 "milestone": { 5818 "description": "milestone id", 5819 "type": "integer", 5820 "format": "int64", 5821 "x-go-name": "Milestone" 5822 }, 5823 "title": { 5824 "type": "string", 5825 "x-go-name": "Title" 5826 } 5827 }, 5828 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5829 }, 5830 "CreateKeyOption": { 5831 "description": "CreateKeyOption options when creating a key", 5832 "type": "object", 5833 "required": [ 5834 "title", 5835 "key" 5836 ], 5837 "properties": { 5838 "key": { 5839 "description": "An armored SSH key to add", 5840 "type": "string", 5841 "uniqueItems": true, 5842 "x-go-name": "Key" 5843 }, 5844 "read_only": { 5845 "description": "Describe if the key has only read access or read/write", 5846 "type": "boolean", 5847 "x-go-name": "ReadOnly" 5848 }, 5849 "title": { 5850 "description": "Title of the key to add", 5851 "type": "string", 5852 "uniqueItems": true, 5853 "x-go-name": "Title" 5854 } 5855 }, 5856 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5857 }, 5858 "CreateLabelOption": { 5859 "description": "CreateLabelOption options for creating a label", 5860 "type": "object", 5861 "required": [ 5862 "name", 5863 "color" 5864 ], 5865 "properties": { 5866 "color": { 5867 "type": "string", 5868 "x-go-name": "Color", 5869 "example": "#00aabb" 5870 }, 5871 "name": { 5872 "type": "string", 5873 "x-go-name": "Name" 5874 } 5875 }, 5876 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5877 }, 5878 "CreateMilestoneOption": { 5879 "description": "CreateMilestoneOption options for creating a milestone", 5880 "type": "object", 5881 "properties": { 5882 "description": { 5883 "type": "string", 5884 "x-go-name": "Description" 5885 }, 5886 "due_on": { 5887 "type": "string", 5888 "format": "date-time", 5889 "x-go-name": "Deadline" 5890 }, 5891 "title": { 5892 "type": "string", 5893 "x-go-name": "Title" 5894 } 5895 }, 5896 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5897 }, 5898 "CreateOrgOption": { 5899 "description": "CreateOrgOption options for creating an organization", 5900 "type": "object", 5901 "required": [ 5902 "username" 5903 ], 5904 "properties": { 5905 "description": { 5906 "type": "string", 5907 "x-go-name": "Description" 5908 }, 5909 "full_name": { 5910 "type": "string", 5911 "x-go-name": "FullName" 5912 }, 5913 "location": { 5914 "type": "string", 5915 "x-go-name": "Location" 5916 }, 5917 "username": { 5918 "type": "string", 5919 "x-go-name": "UserName" 5920 }, 5921 "website": { 5922 "type": "string", 5923 "x-go-name": "Website" 5924 } 5925 }, 5926 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5927 }, 5928 "CreatePullRequestOption": { 5929 "description": "CreatePullRequestOption options when creating a pull request", 5930 "type": "object", 5931 "properties": { 5932 "assignee": { 5933 "type": "string", 5934 "x-go-name": "Assignee" 5935 }, 5936 "assignees": { 5937 "type": "array", 5938 "items": { 5939 "type": "string" 5940 }, 5941 "x-go-name": "Assignees" 5942 }, 5943 "base": { 5944 "type": "string", 5945 "x-go-name": "Base" 5946 }, 5947 "body": { 5948 "type": "string", 5949 "x-go-name": "Body" 5950 }, 5951 "due_date": { 5952 "type": "string", 5953 "format": "date-time", 5954 "x-go-name": "Deadline" 5955 }, 5956 "head": { 5957 "type": "string", 5958 "x-go-name": "Head" 5959 }, 5960 "labels": { 5961 "type": "array", 5962 "items": { 5963 "type": "integer", 5964 "format": "int64" 5965 }, 5966 "x-go-name": "Labels" 5967 }, 5968 "milestone": { 5969 "type": "integer", 5970 "format": "int64", 5971 "x-go-name": "Milestone" 5972 }, 5973 "title": { 5974 "type": "string", 5975 "x-go-name": "Title" 5976 } 5977 }, 5978 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 5979 }, 5980 "CreateReleaseOption": { 5981 "description": "CreateReleaseOption options when creating a release", 5982 "type": "object", 5983 "required": [ 5984 "tag_name" 5985 ], 5986 "properties": { 5987 "body": { 5988 "type": "string", 5989 "x-go-name": "Note" 5990 }, 5991 "draft": { 5992 "type": "boolean", 5993 "x-go-name": "IsDraft" 5994 }, 5995 "name": { 5996 "type": "string", 5997 "x-go-name": "Title" 5998 }, 5999 "prerelease": { 6000 "type": "boolean", 6001 "x-go-name": "IsPrerelease" 6002 }, 6003 "tag_name": { 6004 "type": "string", 6005 "x-go-name": "TagName" 6006 }, 6007 "target_commitish": { 6008 "type": "string", 6009 "x-go-name": "Target" 6010 } 6011 }, 6012 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6013 }, 6014 "CreateRepoOption": { 6015 "description": "CreateRepoOption options when creating repository", 6016 "type": "object", 6017 "required": [ 6018 "name" 6019 ], 6020 "properties": { 6021 "auto_init": { 6022 "description": "Whether the repository should be auto-intialized?", 6023 "type": "boolean", 6024 "x-go-name": "AutoInit" 6025 }, 6026 "description": { 6027 "description": "Description of the repository to create", 6028 "type": "string", 6029 "x-go-name": "Description" 6030 }, 6031 "gitignores": { 6032 "description": "Gitignores to use", 6033 "type": "string", 6034 "x-go-name": "Gitignores" 6035 }, 6036 "license": { 6037 "description": "License to use", 6038 "type": "string", 6039 "x-go-name": "License" 6040 }, 6041 "name": { 6042 "description": "Name of the repository to create", 6043 "type": "string", 6044 "uniqueItems": true, 6045 "x-go-name": "Name" 6046 }, 6047 "private": { 6048 "description": "Whether the repository is private", 6049 "type": "boolean", 6050 "x-go-name": "Private" 6051 }, 6052 "readme": { 6053 "description": "Readme of the repository to create", 6054 "type": "string", 6055 "x-go-name": "Readme" 6056 } 6057 }, 6058 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6059 }, 6060 "CreateStatusOption": { 6061 "description": "CreateStatusOption holds the information needed to create a new Status for a Commit", 6062 "type": "object", 6063 "properties": { 6064 "context": { 6065 "type": "string", 6066 "x-go-name": "Context" 6067 }, 6068 "description": { 6069 "type": "string", 6070 "x-go-name": "Description" 6071 }, 6072 "state": { 6073 "$ref": "#/definitions/StatusState" 6074 }, 6075 "target_url": { 6076 "type": "string", 6077 "x-go-name": "TargetURL" 6078 } 6079 }, 6080 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6081 }, 6082 "CreateTeamOption": { 6083 "description": "CreateTeamOption options for creating a team", 6084 "type": "object", 6085 "required": [ 6086 "name" 6087 ], 6088 "properties": { 6089 "description": { 6090 "type": "string", 6091 "x-go-name": "Description" 6092 }, 6093 "name": { 6094 "type": "string", 6095 "x-go-name": "Name" 6096 }, 6097 "permission": { 6098 "type": "string", 6099 "enum": [ 6100 "read", 6101 "write", 6102 "admin" 6103 ], 6104 "x-go-name": "Permission" 6105 } 6106 }, 6107 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6108 }, 6109 "CreateUserOption": { 6110 "description": "CreateUserOption create user options", 6111 "type": "object", 6112 "required": [ 6113 "username", 6114 "email", 6115 "password" 6116 ], 6117 "properties": { 6118 "email": { 6119 "type": "string", 6120 "format": "email", 6121 "x-go-name": "Email" 6122 }, 6123 "full_name": { 6124 "type": "string", 6125 "x-go-name": "FullName" 6126 }, 6127 "login_name": { 6128 "type": "string", 6129 "x-go-name": "LoginName" 6130 }, 6131 "password": { 6132 "type": "string", 6133 "x-go-name": "Password" 6134 }, 6135 "send_notify": { 6136 "type": "boolean", 6137 "x-go-name": "SendNotify" 6138 }, 6139 "source_id": { 6140 "type": "integer", 6141 "format": "int64", 6142 "x-go-name": "SourceID" 6143 }, 6144 "username": { 6145 "type": "string", 6146 "x-go-name": "Username" 6147 } 6148 }, 6149 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6150 }, 6151 "DeleteEmailOption": { 6152 "description": "DeleteEmailOption options when deleting email addresses", 6153 "type": "object", 6154 "properties": { 6155 "emails": { 6156 "description": "email addresses to delete", 6157 "type": "array", 6158 "items": { 6159 "type": "string" 6160 }, 6161 "x-go-name": "Emails" 6162 } 6163 }, 6164 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6165 }, 6166 "DeployKey": { 6167 "description": "DeployKey a deploy key", 6168 "type": "object", 6169 "properties": { 6170 "created_at": { 6171 "type": "string", 6172 "format": "date-time", 6173 "x-go-name": "Created" 6174 }, 6175 "id": { 6176 "type": "integer", 6177 "format": "int64", 6178 "x-go-name": "ID" 6179 }, 6180 "key": { 6181 "type": "string", 6182 "x-go-name": "Key" 6183 }, 6184 "read_only": { 6185 "type": "boolean", 6186 "x-go-name": "ReadOnly" 6187 }, 6188 "title": { 6189 "type": "string", 6190 "x-go-name": "Title" 6191 }, 6192 "url": { 6193 "type": "string", 6194 "x-go-name": "URL" 6195 } 6196 }, 6197 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6198 }, 6199 "EditAttachmentOptions": { 6200 "description": "EditAttachmentOptions options for editing attachments", 6201 "type": "object", 6202 "properties": { 6203 "name": { 6204 "type": "string", 6205 "x-go-name": "Name" 6206 } 6207 }, 6208 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6209 }, 6210 "EditDeadlineOption": { 6211 "description": "EditDeadlineOption options for creating a deadline", 6212 "type": "object", 6213 "required": [ 6214 "due_date" 6215 ], 6216 "properties": { 6217 "due_date": { 6218 "type": "string", 6219 "format": "date-time", 6220 "x-go-name": "Deadline" 6221 } 6222 }, 6223 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6224 }, 6225 "EditHookOption": { 6226 "description": "EditHookOption options when modify one hook", 6227 "type": "object", 6228 "properties": { 6229 "active": { 6230 "type": "boolean", 6231 "x-go-name": "Active" 6232 }, 6233 "config": { 6234 "type": "object", 6235 "additionalProperties": { 6236 "type": "string" 6237 }, 6238 "x-go-name": "Config" 6239 }, 6240 "events": { 6241 "type": "array", 6242 "items": { 6243 "type": "string" 6244 }, 6245 "x-go-name": "Events" 6246 } 6247 }, 6248 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6249 }, 6250 "EditIssueCommentOption": { 6251 "description": "EditIssueCommentOption options for editing a comment", 6252 "type": "object", 6253 "required": [ 6254 "body" 6255 ], 6256 "properties": { 6257 "body": { 6258 "type": "string", 6259 "x-go-name": "Body" 6260 } 6261 }, 6262 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6263 }, 6264 "EditIssueOption": { 6265 "description": "EditIssueOption options for editing an issue", 6266 "type": "object", 6267 "properties": { 6268 "assignee": { 6269 "type": "string", 6270 "x-go-name": "Assignee" 6271 }, 6272 "assignees": { 6273 "type": "array", 6274 "items": { 6275 "type": "string" 6276 }, 6277 "x-go-name": "Assignees" 6278 }, 6279 "body": { 6280 "type": "string", 6281 "x-go-name": "Body" 6282 }, 6283 "due_date": { 6284 "type": "string", 6285 "format": "date-time", 6286 "x-go-name": "Deadline" 6287 }, 6288 "milestone": { 6289 "type": "integer", 6290 "format": "int64", 6291 "x-go-name": "Milestone" 6292 }, 6293 "state": { 6294 "type": "string", 6295 "x-go-name": "State" 6296 }, 6297 "title": { 6298 "type": "string", 6299 "x-go-name": "Title" 6300 } 6301 }, 6302 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6303 }, 6304 "EditLabelOption": { 6305 "description": "EditLabelOption options for editing a label", 6306 "type": "object", 6307 "properties": { 6308 "color": { 6309 "type": "string", 6310 "x-go-name": "Color" 6311 }, 6312 "name": { 6313 "type": "string", 6314 "x-go-name": "Name" 6315 } 6316 }, 6317 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6318 }, 6319 "EditMilestoneOption": { 6320 "description": "EditMilestoneOption options for editing a milestone", 6321 "type": "object", 6322 "properties": { 6323 "description": { 6324 "type": "string", 6325 "x-go-name": "Description" 6326 }, 6327 "due_on": { 6328 "type": "string", 6329 "format": "date-time", 6330 "x-go-name": "Deadline" 6331 }, 6332 "state": { 6333 "type": "string", 6334 "x-go-name": "State" 6335 }, 6336 "title": { 6337 "type": "string", 6338 "x-go-name": "Title" 6339 } 6340 }, 6341 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6342 }, 6343 "EditOrgOption": { 6344 "description": "EditOrgOption options for editing an organization", 6345 "type": "object", 6346 "properties": { 6347 "description": { 6348 "type": "string", 6349 "x-go-name": "Description" 6350 }, 6351 "full_name": { 6352 "type": "string", 6353 "x-go-name": "FullName" 6354 }, 6355 "location": { 6356 "type": "string", 6357 "x-go-name": "Location" 6358 }, 6359 "website": { 6360 "type": "string", 6361 "x-go-name": "Website" 6362 } 6363 }, 6364 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6365 }, 6366 "EditPullRequestOption": { 6367 "description": "EditPullRequestOption options when modify pull request", 6368 "type": "object", 6369 "properties": { 6370 "assignee": { 6371 "type": "string", 6372 "x-go-name": "Assignee" 6373 }, 6374 "assignees": { 6375 "type": "array", 6376 "items": { 6377 "type": "string" 6378 }, 6379 "x-go-name": "Assignees" 6380 }, 6381 "body": { 6382 "type": "string", 6383 "x-go-name": "Body" 6384 }, 6385 "due_date": { 6386 "type": "string", 6387 "format": "date-time", 6388 "x-go-name": "Deadline" 6389 }, 6390 "labels": { 6391 "type": "array", 6392 "items": { 6393 "type": "integer", 6394 "format": "int64" 6395 }, 6396 "x-go-name": "Labels" 6397 }, 6398 "milestone": { 6399 "type": "integer", 6400 "format": "int64", 6401 "x-go-name": "Milestone" 6402 }, 6403 "state": { 6404 "type": "string", 6405 "x-go-name": "State" 6406 }, 6407 "title": { 6408 "type": "string", 6409 "x-go-name": "Title" 6410 } 6411 }, 6412 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6413 }, 6414 "EditReleaseOption": { 6415 "description": "EditReleaseOption options when editing a release", 6416 "type": "object", 6417 "properties": { 6418 "body": { 6419 "type": "string", 6420 "x-go-name": "Note" 6421 }, 6422 "draft": { 6423 "type": "boolean", 6424 "x-go-name": "IsDraft" 6425 }, 6426 "name": { 6427 "type": "string", 6428 "x-go-name": "Title" 6429 }, 6430 "prerelease": { 6431 "type": "boolean", 6432 "x-go-name": "IsPrerelease" 6433 }, 6434 "tag_name": { 6435 "type": "string", 6436 "x-go-name": "TagName" 6437 }, 6438 "target_commitish": { 6439 "type": "string", 6440 "x-go-name": "Target" 6441 } 6442 }, 6443 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6444 }, 6445 "EditTeamOption": { 6446 "description": "EditTeamOption options for editing a team", 6447 "type": "object", 6448 "required": [ 6449 "name" 6450 ], 6451 "properties": { 6452 "description": { 6453 "type": "string", 6454 "x-go-name": "Description" 6455 }, 6456 "name": { 6457 "type": "string", 6458 "x-go-name": "Name" 6459 }, 6460 "permission": { 6461 "type": "string", 6462 "enum": [ 6463 "read", 6464 "write", 6465 "admin" 6466 ], 6467 "x-go-name": "Permission" 6468 } 6469 }, 6470 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6471 }, 6472 "EditUserOption": { 6473 "description": "EditUserOption edit user options", 6474 "type": "object", 6475 "required": [ 6476 "email" 6477 ], 6478 "properties": { 6479 "active": { 6480 "type": "boolean", 6481 "x-go-name": "Active" 6482 }, 6483 "admin": { 6484 "type": "boolean", 6485 "x-go-name": "Admin" 6486 }, 6487 "allow_git_hook": { 6488 "type": "boolean", 6489 "x-go-name": "AllowGitHook" 6490 }, 6491 "allow_import_local": { 6492 "type": "boolean", 6493 "x-go-name": "AllowImportLocal" 6494 }, 6495 "email": { 6496 "type": "string", 6497 "format": "email", 6498 "x-go-name": "Email" 6499 }, 6500 "full_name": { 6501 "type": "string", 6502 "x-go-name": "FullName" 6503 }, 6504 "location": { 6505 "type": "string", 6506 "x-go-name": "Location" 6507 }, 6508 "login_name": { 6509 "type": "string", 6510 "x-go-name": "LoginName" 6511 }, 6512 "max_repo_creation": { 6513 "type": "integer", 6514 "format": "int64", 6515 "x-go-name": "MaxRepoCreation" 6516 }, 6517 "password": { 6518 "type": "string", 6519 "x-go-name": "Password" 6520 }, 6521 "source_id": { 6522 "type": "integer", 6523 "format": "int64", 6524 "x-go-name": "SourceID" 6525 }, 6526 "website": { 6527 "type": "string", 6528 "x-go-name": "Website" 6529 } 6530 }, 6531 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6532 }, 6533 "Email": { 6534 "description": "Email an email address belonging to a user", 6535 "type": "object", 6536 "properties": { 6537 "email": { 6538 "type": "string", 6539 "format": "email", 6540 "x-go-name": "Email" 6541 }, 6542 "primary": { 6543 "type": "boolean", 6544 "x-go-name": "Primary" 6545 }, 6546 "verified": { 6547 "type": "boolean", 6548 "x-go-name": "Verified" 6549 } 6550 }, 6551 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6552 }, 6553 "GPGKey": { 6554 "description": "GPGKey a user GPG key to sign commit and tag in repository", 6555 "type": "object", 6556 "properties": { 6557 "can_certify": { 6558 "type": "boolean", 6559 "x-go-name": "CanCertify" 6560 }, 6561 "can_encrypt_comms": { 6562 "type": "boolean", 6563 "x-go-name": "CanEncryptComms" 6564 }, 6565 "can_encrypt_storage": { 6566 "type": "boolean", 6567 "x-go-name": "CanEncryptStorage" 6568 }, 6569 "can_sign": { 6570 "type": "boolean", 6571 "x-go-name": "CanSign" 6572 }, 6573 "created_at": { 6574 "type": "string", 6575 "format": "date-time", 6576 "x-go-name": "Created" 6577 }, 6578 "emails": { 6579 "type": "array", 6580 "items": { 6581 "$ref": "#/definitions/GPGKeyEmail" 6582 }, 6583 "x-go-name": "Emails" 6584 }, 6585 "expires_at": { 6586 "type": "string", 6587 "format": "date-time", 6588 "x-go-name": "Expires" 6589 }, 6590 "id": { 6591 "type": "integer", 6592 "format": "int64", 6593 "x-go-name": "ID" 6594 }, 6595 "key_id": { 6596 "type": "string", 6597 "x-go-name": "KeyID" 6598 }, 6599 "primary_key_id": { 6600 "type": "string", 6601 "x-go-name": "PrimaryKeyID" 6602 }, 6603 "public_key": { 6604 "type": "string", 6605 "x-go-name": "PublicKey" 6606 }, 6607 "subkeys": { 6608 "type": "array", 6609 "items": { 6610 "$ref": "#/definitions/GPGKey" 6611 }, 6612 "x-go-name": "SubsKey" 6613 } 6614 }, 6615 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6616 }, 6617 "GPGKeyEmail": { 6618 "description": "GPGKeyEmail an email attached to a GPGKey", 6619 "type": "object", 6620 "properties": { 6621 "email": { 6622 "type": "string", 6623 "x-go-name": "Email" 6624 }, 6625 "verified": { 6626 "type": "boolean", 6627 "x-go-name": "Verified" 6628 } 6629 }, 6630 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6631 }, 6632 "Issue": { 6633 "description": "Issue represents an issue in a repository", 6634 "type": "object", 6635 "properties": { 6636 "assignee": { 6637 "$ref": "#/definitions/User" 6638 }, 6639 "assignees": { 6640 "type": "array", 6641 "items": { 6642 "$ref": "#/definitions/User" 6643 }, 6644 "x-go-name": "Assignees" 6645 }, 6646 "body": { 6647 "type": "string", 6648 "x-go-name": "Body" 6649 }, 6650 "closed_at": { 6651 "type": "string", 6652 "format": "date-time", 6653 "x-go-name": "Closed" 6654 }, 6655 "comments": { 6656 "type": "integer", 6657 "format": "int64", 6658 "x-go-name": "Comments" 6659 }, 6660 "created_at": { 6661 "type": "string", 6662 "format": "date-time", 6663 "x-go-name": "Created" 6664 }, 6665 "due_date": { 6666 "type": "string", 6667 "format": "date-time", 6668 "x-go-name": "Deadline" 6669 }, 6670 "id": { 6671 "type": "integer", 6672 "format": "int64", 6673 "x-go-name": "ID" 6674 }, 6675 "labels": { 6676 "type": "array", 6677 "items": { 6678 "$ref": "#/definitions/Label" 6679 }, 6680 "x-go-name": "Labels" 6681 }, 6682 "milestone": { 6683 "$ref": "#/definitions/Milestone" 6684 }, 6685 "number": { 6686 "type": "integer", 6687 "format": "int64", 6688 "x-go-name": "Index" 6689 }, 6690 "pull_request": { 6691 "$ref": "#/definitions/PullRequestMeta" 6692 }, 6693 "state": { 6694 "$ref": "#/definitions/StateType" 6695 }, 6696 "title": { 6697 "type": "string", 6698 "x-go-name": "Title" 6699 }, 6700 "updated_at": { 6701 "type": "string", 6702 "format": "date-time", 6703 "x-go-name": "Updated" 6704 }, 6705 "url": { 6706 "type": "string", 6707 "x-go-name": "URL" 6708 }, 6709 "user": { 6710 "$ref": "#/definitions/User" 6711 } 6712 }, 6713 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6714 }, 6715 "IssueDeadline": { 6716 "description": "IssueDeadline represents an issue deadline", 6717 "type": "object", 6718 "properties": { 6719 "due_date": { 6720 "type": "string", 6721 "format": "date-time", 6722 "x-go-name": "Deadline" 6723 } 6724 }, 6725 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6726 }, 6727 "IssueLabelsOption": { 6728 "description": "IssueLabelsOption a collection of labels", 6729 "type": "object", 6730 "properties": { 6731 "labels": { 6732 "description": "list of label IDs", 6733 "type": "array", 6734 "items": { 6735 "type": "integer", 6736 "format": "int64" 6737 }, 6738 "x-go-name": "Labels" 6739 } 6740 }, 6741 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6742 }, 6743 "Label": { 6744 "description": "Label a label to an issue or a pr", 6745 "type": "object", 6746 "properties": { 6747 "color": { 6748 "type": "string", 6749 "x-go-name": "Color", 6750 "example": "00aabb" 6751 }, 6752 "id": { 6753 "type": "integer", 6754 "format": "int64", 6755 "x-go-name": "ID" 6756 }, 6757 "name": { 6758 "type": "string", 6759 "x-go-name": "Name" 6760 }, 6761 "url": { 6762 "type": "string", 6763 "x-go-name": "URL" 6764 } 6765 }, 6766 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6767 }, 6768 "MarkdownOption": { 6769 "description": "MarkdownOption markdown options", 6770 "type": "object", 6771 "properties": { 6772 "Context": { 6773 "description": "Context to render\n\nin: body", 6774 "type": "string" 6775 }, 6776 "Mode": { 6777 "description": "Mode to render\n\nin: body", 6778 "type": "string" 6779 }, 6780 "Text": { 6781 "description": "Text markdown to render\n\nin: body", 6782 "type": "string" 6783 }, 6784 "Wiki": { 6785 "description": "Is it a wiki page ?\n\nin: body", 6786 "type": "boolean" 6787 } 6788 }, 6789 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6790 }, 6791 "MigrateRepoForm": { 6792 "description": "MigrateRepoForm form for migrating repository", 6793 "type": "object", 6794 "required": [ 6795 "clone_addr", 6796 "uid", 6797 "repo_name" 6798 ], 6799 "properties": { 6800 "auth_password": { 6801 "type": "string", 6802 "x-go-name": "AuthPassword" 6803 }, 6804 "auth_username": { 6805 "type": "string", 6806 "x-go-name": "AuthUsername" 6807 }, 6808 "clone_addr": { 6809 "type": "string", 6810 "x-go-name": "CloneAddr" 6811 }, 6812 "description": { 6813 "type": "string", 6814 "x-go-name": "Description" 6815 }, 6816 "mirror": { 6817 "type": "boolean", 6818 "x-go-name": "Mirror" 6819 }, 6820 "private": { 6821 "type": "boolean", 6822 "x-go-name": "Private" 6823 }, 6824 "repo_name": { 6825 "type": "string", 6826 "x-go-name": "RepoName" 6827 }, 6828 "uid": { 6829 "type": "integer", 6830 "format": "int64", 6831 "x-go-name": "UID" 6832 } 6833 }, 6834 "x-go-package": "code.gitea.io/gitea/modules/auth" 6835 }, 6836 "Milestone": { 6837 "description": "Milestone milestone is a collection of issues on one repository", 6838 "type": "object", 6839 "properties": { 6840 "closed_at": { 6841 "type": "string", 6842 "format": "date-time", 6843 "x-go-name": "Closed" 6844 }, 6845 "closed_issues": { 6846 "type": "integer", 6847 "format": "int64", 6848 "x-go-name": "ClosedIssues" 6849 }, 6850 "description": { 6851 "type": "string", 6852 "x-go-name": "Description" 6853 }, 6854 "due_on": { 6855 "type": "string", 6856 "format": "date-time", 6857 "x-go-name": "Deadline" 6858 }, 6859 "id": { 6860 "type": "integer", 6861 "format": "int64", 6862 "x-go-name": "ID" 6863 }, 6864 "open_issues": { 6865 "type": "integer", 6866 "format": "int64", 6867 "x-go-name": "OpenIssues" 6868 }, 6869 "state": { 6870 "$ref": "#/definitions/StateType" 6871 }, 6872 "title": { 6873 "type": "string", 6874 "x-go-name": "Title" 6875 } 6876 }, 6877 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6878 }, 6879 "Organization": { 6880 "description": "Organization represents an organization", 6881 "type": "object", 6882 "properties": { 6883 "avatar_url": { 6884 "type": "string", 6885 "x-go-name": "AvatarURL" 6886 }, 6887 "description": { 6888 "type": "string", 6889 "x-go-name": "Description" 6890 }, 6891 "full_name": { 6892 "type": "string", 6893 "x-go-name": "FullName" 6894 }, 6895 "id": { 6896 "type": "integer", 6897 "format": "int64", 6898 "x-go-name": "ID" 6899 }, 6900 "location": { 6901 "type": "string", 6902 "x-go-name": "Location" 6903 }, 6904 "username": { 6905 "type": "string", 6906 "x-go-name": "UserName" 6907 }, 6908 "website": { 6909 "type": "string", 6910 "x-go-name": "Website" 6911 } 6912 }, 6913 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6914 }, 6915 "PRBranchInfo": { 6916 "description": "PRBranchInfo information about a branch", 6917 "type": "object", 6918 "properties": { 6919 "label": { 6920 "type": "string", 6921 "x-go-name": "Name" 6922 }, 6923 "ref": { 6924 "type": "string", 6925 "x-go-name": "Ref" 6926 }, 6927 "repo": { 6928 "$ref": "#/definitions/Repository" 6929 }, 6930 "repo_id": { 6931 "type": "integer", 6932 "format": "int64", 6933 "x-go-name": "RepoID" 6934 }, 6935 "sha": { 6936 "type": "string", 6937 "x-go-name": "Sha" 6938 } 6939 }, 6940 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6941 }, 6942 "PayloadCommit": { 6943 "description": "PayloadCommit represents a commit", 6944 "type": "object", 6945 "properties": { 6946 "author": { 6947 "$ref": "#/definitions/PayloadUser" 6948 }, 6949 "committer": { 6950 "$ref": "#/definitions/PayloadUser" 6951 }, 6952 "id": { 6953 "description": "sha1 hash of the commit", 6954 "type": "string", 6955 "x-go-name": "ID" 6956 }, 6957 "message": { 6958 "type": "string", 6959 "x-go-name": "Message" 6960 }, 6961 "timestamp": { 6962 "type": "string", 6963 "format": "date-time", 6964 "x-go-name": "Timestamp" 6965 }, 6966 "url": { 6967 "type": "string", 6968 "x-go-name": "URL" 6969 }, 6970 "verification": { 6971 "$ref": "#/definitions/PayloadCommitVerification" 6972 } 6973 }, 6974 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6975 }, 6976 "PayloadCommitVerification": { 6977 "description": "PayloadCommitVerification represents the GPG verification of a commit", 6978 "type": "object", 6979 "properties": { 6980 "payload": { 6981 "type": "string", 6982 "x-go-name": "Payload" 6983 }, 6984 "reason": { 6985 "type": "string", 6986 "x-go-name": "Reason" 6987 }, 6988 "signature": { 6989 "type": "string", 6990 "x-go-name": "Signature" 6991 }, 6992 "verified": { 6993 "type": "boolean", 6994 "x-go-name": "Verified" 6995 } 6996 }, 6997 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 6998 }, 6999 "PayloadUser": { 7000 "description": "PayloadUser represents the author or committer of a commit", 7001 "type": "object", 7002 "properties": { 7003 "email": { 7004 "type": "string", 7005 "format": "email", 7006 "x-go-name": "Email" 7007 }, 7008 "name": { 7009 "description": "Full name of the commit author", 7010 "type": "string", 7011 "x-go-name": "Name" 7012 }, 7013 "username": { 7014 "type": "string", 7015 "x-go-name": "UserName" 7016 } 7017 }, 7018 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7019 }, 7020 "Permission": { 7021 "description": "Permission represents a set of permissions", 7022 "type": "object", 7023 "properties": { 7024 "admin": { 7025 "type": "boolean", 7026 "x-go-name": "Admin" 7027 }, 7028 "pull": { 7029 "type": "boolean", 7030 "x-go-name": "Pull" 7031 }, 7032 "push": { 7033 "type": "boolean", 7034 "x-go-name": "Push" 7035 } 7036 }, 7037 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7038 }, 7039 "PublicKey": { 7040 "description": "PublicKey publickey is a user key to push code to repository", 7041 "type": "object", 7042 "properties": { 7043 "created_at": { 7044 "type": "string", 7045 "format": "date-time", 7046 "x-go-name": "Created" 7047 }, 7048 "fingerprint": { 7049 "type": "string", 7050 "x-go-name": "Fingerprint" 7051 }, 7052 "id": { 7053 "type": "integer", 7054 "format": "int64", 7055 "x-go-name": "ID" 7056 }, 7057 "key": { 7058 "type": "string", 7059 "x-go-name": "Key" 7060 }, 7061 "title": { 7062 "type": "string", 7063 "x-go-name": "Title" 7064 }, 7065 "url": { 7066 "type": "string", 7067 "x-go-name": "URL" 7068 } 7069 }, 7070 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7071 }, 7072 "PullRequest": { 7073 "description": "PullRequest represents a pull request", 7074 "type": "object", 7075 "properties": { 7076 "assignee": { 7077 "$ref": "#/definitions/User" 7078 }, 7079 "assignees": { 7080 "type": "array", 7081 "items": { 7082 "$ref": "#/definitions/User" 7083 }, 7084 "x-go-name": "Assignees" 7085 }, 7086 "base": { 7087 "$ref": "#/definitions/PRBranchInfo" 7088 }, 7089 "body": { 7090 "type": "string", 7091 "x-go-name": "Body" 7092 }, 7093 "closed_at": { 7094 "type": "string", 7095 "format": "date-time", 7096 "x-go-name": "Closed" 7097 }, 7098 "comments": { 7099 "type": "integer", 7100 "format": "int64", 7101 "x-go-name": "Comments" 7102 }, 7103 "created_at": { 7104 "type": "string", 7105 "format": "date-time", 7106 "x-go-name": "Created" 7107 }, 7108 "diff_url": { 7109 "type": "string", 7110 "x-go-name": "DiffURL" 7111 }, 7112 "due_date": { 7113 "type": "string", 7114 "format": "date-time", 7115 "x-go-name": "Deadline" 7116 }, 7117 "head": { 7118 "$ref": "#/definitions/PRBranchInfo" 7119 }, 7120 "html_url": { 7121 "type": "string", 7122 "x-go-name": "HTMLURL" 7123 }, 7124 "id": { 7125 "type": "integer", 7126 "format": "int64", 7127 "x-go-name": "ID" 7128 }, 7129 "labels": { 7130 "type": "array", 7131 "items": { 7132 "$ref": "#/definitions/Label" 7133 }, 7134 "x-go-name": "Labels" 7135 }, 7136 "merge_base": { 7137 "type": "string", 7138 "x-go-name": "MergeBase" 7139 }, 7140 "merge_commit_sha": { 7141 "type": "string", 7142 "x-go-name": "MergedCommitID" 7143 }, 7144 "mergeable": { 7145 "type": "boolean", 7146 "x-go-name": "Mergeable" 7147 }, 7148 "merged": { 7149 "type": "boolean", 7150 "x-go-name": "HasMerged" 7151 }, 7152 "merged_at": { 7153 "type": "string", 7154 "format": "date-time", 7155 "x-go-name": "Merged" 7156 }, 7157 "merged_by": { 7158 "$ref": "#/definitions/User" 7159 }, 7160 "milestone": { 7161 "$ref": "#/definitions/Milestone" 7162 }, 7163 "number": { 7164 "type": "integer", 7165 "format": "int64", 7166 "x-go-name": "Index" 7167 }, 7168 "patch_url": { 7169 "type": "string", 7170 "x-go-name": "PatchURL" 7171 }, 7172 "state": { 7173 "$ref": "#/definitions/StateType" 7174 }, 7175 "title": { 7176 "type": "string", 7177 "x-go-name": "Title" 7178 }, 7179 "updated_at": { 7180 "type": "string", 7181 "format": "date-time", 7182 "x-go-name": "Updated" 7183 }, 7184 "url": { 7185 "type": "string", 7186 "x-go-name": "URL" 7187 }, 7188 "user": { 7189 "$ref": "#/definitions/User" 7190 } 7191 }, 7192 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7193 }, 7194 "PullRequestMeta": { 7195 "description": "PullRequestMeta PR info if an issue is a PR", 7196 "type": "object", 7197 "properties": { 7198 "merged": { 7199 "type": "boolean", 7200 "x-go-name": "HasMerged" 7201 }, 7202 "merged_at": { 7203 "type": "string", 7204 "format": "date-time", 7205 "x-go-name": "Merged" 7206 } 7207 }, 7208 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7209 }, 7210 "Release": { 7211 "description": "Release represents a repository release", 7212 "type": "object", 7213 "properties": { 7214 "assets": { 7215 "type": "array", 7216 "items": { 7217 "$ref": "#/definitions/Attachment" 7218 }, 7219 "x-go-name": "Attachments" 7220 }, 7221 "author": { 7222 "$ref": "#/definitions/User" 7223 }, 7224 "body": { 7225 "type": "string", 7226 "x-go-name": "Note" 7227 }, 7228 "created_at": { 7229 "type": "string", 7230 "format": "date-time", 7231 "x-go-name": "CreatedAt" 7232 }, 7233 "draft": { 7234 "type": "boolean", 7235 "x-go-name": "IsDraft" 7236 }, 7237 "id": { 7238 "type": "integer", 7239 "format": "int64", 7240 "x-go-name": "ID" 7241 }, 7242 "name": { 7243 "type": "string", 7244 "x-go-name": "Title" 7245 }, 7246 "prerelease": { 7247 "type": "boolean", 7248 "x-go-name": "IsPrerelease" 7249 }, 7250 "published_at": { 7251 "type": "string", 7252 "format": "date-time", 7253 "x-go-name": "PublishedAt" 7254 }, 7255 "tag_name": { 7256 "type": "string", 7257 "x-go-name": "TagName" 7258 }, 7259 "tarball_url": { 7260 "type": "string", 7261 "x-go-name": "TarURL" 7262 }, 7263 "target_commitish": { 7264 "type": "string", 7265 "x-go-name": "Target" 7266 }, 7267 "url": { 7268 "type": "string", 7269 "x-go-name": "URL" 7270 }, 7271 "zipball_url": { 7272 "type": "string", 7273 "x-go-name": "ZipURL" 7274 } 7275 }, 7276 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7277 }, 7278 "Repository": { 7279 "description": "Repository represents a repository", 7280 "type": "object", 7281 "properties": { 7282 "clone_url": { 7283 "type": "string", 7284 "x-go-name": "CloneURL" 7285 }, 7286 "created_at": { 7287 "type": "string", 7288 "format": "date-time", 7289 "x-go-name": "Created" 7290 }, 7291 "default_branch": { 7292 "type": "string", 7293 "x-go-name": "DefaultBranch" 7294 }, 7295 "description": { 7296 "type": "string", 7297 "x-go-name": "Description" 7298 }, 7299 "empty": { 7300 "type": "boolean", 7301 "x-go-name": "Empty" 7302 }, 7303 "fork": { 7304 "type": "boolean", 7305 "x-go-name": "Fork" 7306 }, 7307 "forks_count": { 7308 "type": "integer", 7309 "format": "int64", 7310 "x-go-name": "Forks" 7311 }, 7312 "full_name": { 7313 "type": "string", 7314 "x-go-name": "FullName" 7315 }, 7316 "html_url": { 7317 "type": "string", 7318 "x-go-name": "HTMLURL" 7319 }, 7320 "id": { 7321 "type": "integer", 7322 "format": "int64", 7323 "x-go-name": "ID" 7324 }, 7325 "mirror": { 7326 "type": "boolean", 7327 "x-go-name": "Mirror" 7328 }, 7329 "name": { 7330 "type": "string", 7331 "x-go-name": "Name" 7332 }, 7333 "open_issues_count": { 7334 "type": "integer", 7335 "format": "int64", 7336 "x-go-name": "OpenIssues" 7337 }, 7338 "owner": { 7339 "$ref": "#/definitions/User" 7340 }, 7341 "parent": { 7342 "$ref": "#/definitions/Repository" 7343 }, 7344 "permissions": { 7345 "$ref": "#/definitions/Permission" 7346 }, 7347 "private": { 7348 "type": "boolean", 7349 "x-go-name": "Private" 7350 }, 7351 "size": { 7352 "type": "integer", 7353 "format": "int64", 7354 "x-go-name": "Size" 7355 }, 7356 "ssh_url": { 7357 "type": "string", 7358 "x-go-name": "SSHURL" 7359 }, 7360 "stars_count": { 7361 "type": "integer", 7362 "format": "int64", 7363 "x-go-name": "Stars" 7364 }, 7365 "updated_at": { 7366 "type": "string", 7367 "format": "date-time", 7368 "x-go-name": "Updated" 7369 }, 7370 "watchers_count": { 7371 "type": "integer", 7372 "format": "int64", 7373 "x-go-name": "Watchers" 7374 }, 7375 "website": { 7376 "type": "string", 7377 "x-go-name": "Website" 7378 } 7379 }, 7380 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7381 }, 7382 "SearchResults": { 7383 "description": "SearchResults results of a successful search", 7384 "type": "object", 7385 "properties": { 7386 "data": { 7387 "type": "array", 7388 "items": { 7389 "$ref": "#/definitions/Repository" 7390 }, 7391 "x-go-name": "Data" 7392 }, 7393 "ok": { 7394 "type": "boolean", 7395 "x-go-name": "OK" 7396 } 7397 }, 7398 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7399 }, 7400 "ServerVersion": { 7401 "description": "ServerVersion wraps the version of the server", 7402 "type": "object", 7403 "properties": { 7404 "version": { 7405 "type": "string", 7406 "x-go-name": "Version" 7407 } 7408 }, 7409 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7410 }, 7411 "StateType": { 7412 "description": "StateType issue state type", 7413 "type": "string", 7414 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7415 }, 7416 "Status": { 7417 "description": "Status holds a single Status of a single Commit", 7418 "type": "object", 7419 "properties": { 7420 "context": { 7421 "type": "string", 7422 "x-go-name": "Context" 7423 }, 7424 "created_at": { 7425 "type": "string", 7426 "format": "date-time", 7427 "x-go-name": "Created" 7428 }, 7429 "creator": { 7430 "$ref": "#/definitions/User" 7431 }, 7432 "description": { 7433 "type": "string", 7434 "x-go-name": "Description" 7435 }, 7436 "id": { 7437 "type": "integer", 7438 "format": "int64", 7439 "x-go-name": "ID" 7440 }, 7441 "status": { 7442 "$ref": "#/definitions/StatusState" 7443 }, 7444 "target_url": { 7445 "type": "string", 7446 "x-go-name": "TargetURL" 7447 }, 7448 "updated_at": { 7449 "type": "string", 7450 "format": "date-time", 7451 "x-go-name": "Updated" 7452 }, 7453 "url": { 7454 "type": "string", 7455 "x-go-name": "URL" 7456 } 7457 }, 7458 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7459 }, 7460 "StatusState": { 7461 "description": "StatusState holds the state of a Status\nIt can be \"pending\", \"success\", \"error\", \"failure\", and \"warning\"", 7462 "type": "string", 7463 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7464 }, 7465 "Team": { 7466 "description": "Team represents a team in an organization", 7467 "type": "object", 7468 "properties": { 7469 "description": { 7470 "type": "string", 7471 "x-go-name": "Description" 7472 }, 7473 "id": { 7474 "type": "integer", 7475 "format": "int64", 7476 "x-go-name": "ID" 7477 }, 7478 "name": { 7479 "type": "string", 7480 "x-go-name": "Name" 7481 }, 7482 "permission": { 7483 "type": "string", 7484 "enum": [ 7485 "none", 7486 "read", 7487 "write", 7488 "admin", 7489 "owner" 7490 ], 7491 "x-go-name": "Permission" 7492 } 7493 }, 7494 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7495 }, 7496 "TrackedTime": { 7497 "description": "TrackedTime worked time for an issue / pr", 7498 "type": "object", 7499 "properties": { 7500 "created": { 7501 "type": "string", 7502 "format": "date-time", 7503 "x-go-name": "Created" 7504 }, 7505 "id": { 7506 "type": "integer", 7507 "format": "int64", 7508 "x-go-name": "ID" 7509 }, 7510 "issue_id": { 7511 "type": "integer", 7512 "format": "int64", 7513 "x-go-name": "IssueID" 7514 }, 7515 "time": { 7516 "description": "Time in seconds", 7517 "type": "integer", 7518 "format": "int64", 7519 "x-go-name": "Time" 7520 }, 7521 "user_id": { 7522 "type": "integer", 7523 "format": "int64", 7524 "x-go-name": "UserID" 7525 } 7526 }, 7527 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7528 }, 7529 "User": { 7530 "description": "User represents a user", 7531 "type": "object", 7532 "properties": { 7533 "avatar_url": { 7534 "description": "URL to the user's avatar", 7535 "type": "string", 7536 "x-go-name": "AvatarURL" 7537 }, 7538 "email": { 7539 "type": "string", 7540 "format": "email", 7541 "x-go-name": "Email" 7542 }, 7543 "full_name": { 7544 "description": "the user's full name", 7545 "type": "string", 7546 "x-go-name": "FullName" 7547 }, 7548 "id": { 7549 "description": "the user's id", 7550 "type": "integer", 7551 "format": "int64", 7552 "x-go-name": "ID" 7553 }, 7554 "language": { 7555 "description": "User locale", 7556 "type": "string", 7557 "x-go-name": "Language" 7558 }, 7559 "login": { 7560 "description": "the user's username", 7561 "type": "string", 7562 "x-go-name": "UserName" 7563 } 7564 }, 7565 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7566 }, 7567 "WatchInfo": { 7568 "description": "WatchInfo represents an API watch status of one repository", 7569 "type": "object", 7570 "properties": { 7571 "created_at": { 7572 "type": "string", 7573 "format": "date-time", 7574 "x-go-name": "CreatedAt" 7575 }, 7576 "ignored": { 7577 "type": "boolean", 7578 "x-go-name": "Ignored" 7579 }, 7580 "reason": { 7581 "type": "object", 7582 "x-go-name": "Reason" 7583 }, 7584 "repository_url": { 7585 "type": "string", 7586 "x-go-name": "RepositoryURL" 7587 }, 7588 "subscribed": { 7589 "type": "boolean", 7590 "x-go-name": "Subscribed" 7591 }, 7592 "url": { 7593 "type": "string", 7594 "x-go-name": "URL" 7595 } 7596 }, 7597 "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea" 7598 } 7599 }, 7600 "responses": { 7601 "AccessToken": { 7602 "description": "AccessToken represents a API access token.", 7603 "headers": { 7604 "id": { 7605 "type": "integer", 7606 "format": "int64" 7607 }, 7608 "name": { 7609 "type": "string" 7610 }, 7611 "sha1": { 7612 "type": "string" 7613 } 7614 } 7615 }, 7616 "AccessTokenList": { 7617 "description": "AccessTokenList represents a list of API access token." 7618 }, 7619 "Attachment": { 7620 "description": "Attachment", 7621 "schema": { 7622 "$ref": "#/definitions/Attachment" 7623 } 7624 }, 7625 "AttachmentList": { 7626 "description": "AttachmentList", 7627 "schema": { 7628 "type": "array", 7629 "items": { 7630 "$ref": "#/definitions/Attachment" 7631 } 7632 } 7633 }, 7634 "Branch": { 7635 "description": "Branch", 7636 "schema": { 7637 "$ref": "#/definitions/Branch" 7638 } 7639 }, 7640 "BranchList": { 7641 "description": "BranchList", 7642 "schema": { 7643 "type": "array", 7644 "items": { 7645 "$ref": "#/definitions/Branch" 7646 } 7647 } 7648 }, 7649 "Comment": { 7650 "description": "Comment", 7651 "schema": { 7652 "$ref": "#/definitions/Comment" 7653 } 7654 }, 7655 "CommentList": { 7656 "description": "CommentList", 7657 "schema": { 7658 "type": "array", 7659 "items": { 7660 "$ref": "#/definitions/Comment" 7661 } 7662 } 7663 }, 7664 "DeployKey": { 7665 "description": "DeployKey", 7666 "schema": { 7667 "$ref": "#/definitions/DeployKey" 7668 } 7669 }, 7670 "DeployKeyList": { 7671 "description": "DeployKeyList", 7672 "schema": { 7673 "type": "array", 7674 "items": { 7675 "$ref": "#/definitions/DeployKey" 7676 } 7677 } 7678 }, 7679 "EmailList": { 7680 "description": "EmailList", 7681 "schema": { 7682 "type": "array", 7683 "items": { 7684 "$ref": "#/definitions/Email" 7685 } 7686 } 7687 }, 7688 "GPGKey": { 7689 "description": "GPGKey", 7690 "schema": { 7691 "$ref": "#/definitions/GPGKey" 7692 } 7693 }, 7694 "GPGKeyList": { 7695 "description": "GPGKeyList", 7696 "schema": { 7697 "type": "array", 7698 "items": { 7699 "$ref": "#/definitions/GPGKey" 7700 } 7701 } 7702 }, 7703 "Hook": { 7704 "description": "Hook", 7705 "schema": { 7706 "type": "array", 7707 "items": { 7708 "$ref": "#/definitions/Branch" 7709 } 7710 } 7711 }, 7712 "HookList": { 7713 "description": "HookList", 7714 "schema": { 7715 "type": "array", 7716 "items": { 7717 "$ref": "#/definitions/Branch" 7718 } 7719 } 7720 }, 7721 "Issue": { 7722 "description": "Issue", 7723 "schema": { 7724 "$ref": "#/definitions/Issue" 7725 } 7726 }, 7727 "IssueDeadline": { 7728 "description": "IssueDeadline", 7729 "schema": { 7730 "$ref": "#/definitions/IssueDeadline" 7731 } 7732 }, 7733 "IssueList": { 7734 "description": "IssueList", 7735 "schema": { 7736 "type": "array", 7737 "items": { 7738 "$ref": "#/definitions/Issue" 7739 } 7740 } 7741 }, 7742 "Label": { 7743 "description": "Label", 7744 "schema": { 7745 "$ref": "#/definitions/Label" 7746 } 7747 }, 7748 "LabelList": { 7749 "description": "LabelList", 7750 "schema": { 7751 "type": "array", 7752 "items": { 7753 "$ref": "#/definitions/Label" 7754 } 7755 } 7756 }, 7757 "MarkdownRender": { 7758 "description": "MarkdownRender is a rendered markdown document" 7759 }, 7760 "Milestone": { 7761 "description": "Milestone", 7762 "schema": { 7763 "$ref": "#/definitions/Milestone" 7764 } 7765 }, 7766 "MilestoneList": { 7767 "description": "MilestoneList", 7768 "schema": { 7769 "type": "array", 7770 "items": { 7771 "$ref": "#/definitions/Milestone" 7772 } 7773 } 7774 }, 7775 "Organization": { 7776 "description": "Organization", 7777 "schema": { 7778 "$ref": "#/definitions/Organization" 7779 } 7780 }, 7781 "OrganizationList": { 7782 "description": "OrganizationList", 7783 "schema": { 7784 "type": "array", 7785 "items": { 7786 "$ref": "#/definitions/Organization" 7787 } 7788 } 7789 }, 7790 "PublicKey": { 7791 "description": "PublicKey", 7792 "schema": { 7793 "$ref": "#/definitions/PublicKey" 7794 } 7795 }, 7796 "PublicKeyList": { 7797 "description": "PublicKeyList", 7798 "schema": { 7799 "type": "array", 7800 "items": { 7801 "$ref": "#/definitions/PublicKey" 7802 } 7803 } 7804 }, 7805 "PullRequest": { 7806 "description": "PullRequest", 7807 "schema": { 7808 "$ref": "#/definitions/PullRequest" 7809 } 7810 }, 7811 "PullRequestList": { 7812 "description": "PullRequestList", 7813 "schema": { 7814 "type": "array", 7815 "items": { 7816 "$ref": "#/definitions/PullRequest" 7817 } 7818 } 7819 }, 7820 "Release": { 7821 "description": "Release", 7822 "schema": { 7823 "$ref": "#/definitions/Release" 7824 } 7825 }, 7826 "ReleaseList": { 7827 "description": "ReleaseList", 7828 "schema": { 7829 "type": "array", 7830 "items": { 7831 "$ref": "#/definitions/Release" 7832 } 7833 } 7834 }, 7835 "Repository": { 7836 "description": "Repository", 7837 "schema": { 7838 "$ref": "#/definitions/Repository" 7839 } 7840 }, 7841 "RepositoryList": { 7842 "description": "RepositoryList", 7843 "schema": { 7844 "type": "array", 7845 "items": { 7846 "$ref": "#/definitions/Repository" 7847 } 7848 } 7849 }, 7850 "SearchResults": { 7851 "description": "SearchResults", 7852 "schema": { 7853 "$ref": "#/definitions/SearchResults" 7854 } 7855 }, 7856 "ServerVersion": { 7857 "description": "ServerVersion", 7858 "schema": { 7859 "$ref": "#/definitions/ServerVersion" 7860 } 7861 }, 7862 "Status": { 7863 "description": "Status", 7864 "schema": { 7865 "$ref": "#/definitions/Status" 7866 } 7867 }, 7868 "StatusList": { 7869 "description": "StatusList", 7870 "schema": { 7871 "type": "array", 7872 "items": { 7873 "$ref": "#/definitions/Status" 7874 } 7875 } 7876 }, 7877 "Team": { 7878 "description": "Team", 7879 "schema": { 7880 "$ref": "#/definitions/Team" 7881 } 7882 }, 7883 "TeamList": { 7884 "description": "TeamList", 7885 "schema": { 7886 "type": "array", 7887 "items": { 7888 "$ref": "#/definitions/Team" 7889 } 7890 } 7891 }, 7892 "TrackedTime": { 7893 "description": "TrackedTime", 7894 "schema": { 7895 "$ref": "#/definitions/TrackedTime" 7896 } 7897 }, 7898 "TrackedTimeList": { 7899 "description": "TrackedTimeList", 7900 "schema": { 7901 "type": "array", 7902 "items": { 7903 "$ref": "#/definitions/TrackedTime" 7904 } 7905 } 7906 }, 7907 "User": { 7908 "description": "User", 7909 "schema": { 7910 "$ref": "#/definitions/User" 7911 } 7912 }, 7913 "UserList": { 7914 "description": "UserList", 7915 "schema": { 7916 "type": "array", 7917 "items": { 7918 "$ref": "#/definitions/User" 7919 } 7920 } 7921 }, 7922 "WatchInfo": { 7923 "description": "WatchInfo", 7924 "schema": { 7925 "$ref": "#/definitions/WatchInfo" 7926 } 7927 }, 7928 "empty": { 7929 "description": "APIEmpty is an empty response" 7930 }, 7931 "error": { 7932 "description": "APIError is error format response", 7933 "headers": { 7934 "message": { 7935 "type": "string" 7936 }, 7937 "url": { 7938 "type": "string" 7939 } 7940 } 7941 }, 7942 "forbidden": { 7943 "description": "APIForbiddenError is a forbidden error response", 7944 "headers": { 7945 "message": { 7946 "type": "string" 7947 }, 7948 "url": { 7949 "type": "string" 7950 } 7951 } 7952 }, 7953 "notFound": { 7954 "description": "APINotFound is a not found empty response" 7955 }, 7956 "parameterBodies": { 7957 "description": "parameterBodies", 7958 "schema": { 7959 "$ref": "#/definitions/EditAttachmentOptions" 7960 } 7961 }, 7962 "redirect": { 7963 "description": "APIRedirect is a redirect response" 7964 }, 7965 "validationError": { 7966 "description": "APIValidationError is error format response related to input validation", 7967 "headers": { 7968 "message": { 7969 "type": "string" 7970 }, 7971 "url": { 7972 "type": "string" 7973 } 7974 } 7975 } 7976 }, 7977 "securityDefinitions": { 7978 "AccessToken": { 7979 "type": "apiKey", 7980 "name": "access_token", 7981 "in": "query" 7982 }, 7983 "AuthorizationHeaderToken": { 7984 "type": "apiKey", 7985 "name": "Authorization", 7986 "in": "header" 7987 }, 7988 "BasicAuth": { 7989 "type": "basic" 7990 }, 7991 "Token": { 7992 "type": "apiKey", 7993 "name": "token", 7994 "in": "query" 7995 } 7996 }, 7997 "security": [ 7998 { 7999 "BasicAuth": [] 8000 }, 8001 { 8002 "Token": [] 8003 }, 8004 { 8005 "AccessToken": [] 8006 }, 8007 { 8008 "AuthorizationHeaderToken": [] 8009 } 8010 ] 8011 }