1---
2 consumes:
3 - "application/json"
4 - "text/plain"
5 produces:
6 - "application/json"
7 - "text/html"
8 schemes:
9 - "http"
10 - "https"
11 swagger: "2.0"
12 info:
13 description: "This documentation describes the Gitea API."
14 title: "Gitea API."
15 license:
16 name: "MIT"
17 url: "http://opensource.org/licenses/MIT"
18 version: "1.1.1"
19 basePath: "/api/v1"
20 paths:
21 /admin/users:
22 post:
23 consumes:
24 - "application/json"
25 produces:
26 - "application/json"
27 tags:
28 - "admin"
29 summary: "Create a user"
30 operationId: "adminCreateUser"
31 parameters:
32 -
33 name: "body"
34 in: "body"
35 schema:
36 $ref: "#/definitions/CreateUserOption"
37 responses:
38 201:
39 $ref: "#/responses/User"
40 403:
41 $ref: "#/responses/forbidden"
42 422:
43 $ref: "#/responses/validationError"
44 /admin/users/{username}:
45 delete:
46 produces:
47 - "application/json"
48 tags:
49 - "admin"
50 summary: "Delete a user"
51 operationId: "adminDeleteUser"
52 parameters:
53 -
54 type: "string"
55 description: "username of user to delete"
56 name: "username"
57 in: "path"
58 required: true
59 responses:
60 204:
61 $ref: "#/responses/empty"
62 403:
63 $ref: "#/responses/forbidden"
64 422:
65 $ref: "#/responses/validationError"
66 patch:
67 consumes:
68 - "application/json"
69 produces:
70 - "application/json"
71 tags:
72 - "admin"
73 summary: "Edit an existing user"
74 operationId: "adminEditUser"
75 parameters:
76 -
77 type: "string"
78 description: "username of user to edit"
79 name: "username"
80 in: "path"
81 required: true
82 -
83 name: "body"
84 in: "body"
85 schema:
86 $ref: "#/definitions/EditUserOption"
87 responses:
88 200:
89 $ref: "#/responses/User"
90 403:
91 $ref: "#/responses/forbidden"
92 422:
93 $ref: "#/responses/validationError"
94 /admin/users/{username}/keys:
95 post:
96 consumes:
97 - "application/json"
98 produces:
99 - "application/json"
100 tags:
101 - "admin"
102 summary: "Add a public key on behalf of a user"
103 operationId: "adminCreatePublicKey"
104 parameters:
105 -
106 type: "string"
107 description: "username of the user"
108 name: "username"
109 in: "path"
110 required: true
111 responses:
112 201:
113 $ref: "#/responses/PublicKey"
114 403:
115 $ref: "#/responses/forbidden"
116 422:
117 $ref: "#/responses/validationError"
118 /admin/users/{username}/keys/{id}:
119 delete:
120 produces:
121 - "application/json"
122 tags:
123 - "admin"
124 summary: "Delete a user's public key"
125 operationId: "adminDeleteUserPublicKey"
126 parameters:
127 -
128 type: "string"
129 description: "username of user"
130 name: "username"
131 in: "path"
132 required: true
133 -
134 type: "integer"
135 description: "id of the key to delete"
136 name: "id"
137 in: "path"
138 required: true
139 responses:
140 204:
141 $ref: "#/responses/empty"
142 403:
143 $ref: "#/responses/forbidden"
144 404:
145 $ref: "#/responses/notFound"
146 /admin/users/{username}/orgs:
147 post:
148 consumes:
149 - "application/json"
150 produces:
151 - "application/json"
152 tags:
153 - "admin"
154 summary: "Create an organization"
155 operationId: "adminCreateOrg"
156 parameters:
157 -
158 type: "string"
159 description: "username of the user that will own the created organization"
160 name: "username"
161 in: "path"
162 required: true
163 responses:
164 201:
165 $ref: "#/responses/Organization"
166 403:
167 $ref: "#/responses/forbidden"
168 422:
169 $ref: "#/responses/validationError"
170 /admin/users/{username}/repos:
171 post:
172 consumes:
173 - "application/json"
174 produces:
175 - "application/json"
176 tags:
177 - "admin"
178 summary: "Create a repository on behalf a user"
179 operationId: "adminCreateRepo"
180 parameters:
181 -
182 type: "string"
183 description: "username of the user. This user will own the created repository"
184 name: "username"
185 in: "path"
186 required: true
187 responses:
188 201:
189 $ref: "#/responses/Repository"
190 403:
191 $ref: "#/responses/forbidden"
192 422:
193 $ref: "#/responses/validationError"
194 /markdown:
195 post:
196 consumes:
197 - "application/json"
198 produces:
199 - "text/html"
200 tags:
201 - "miscellaneous"
202 summary: "Render a markdown document as HTML"
203 operationId: "renderMarkdown"
204 parameters:
205 -
206 name: "body"
207 in: "body"
208 schema:
209 $ref: "#/definitions/MarkdownOption"
210 responses:
211 200:
212 $ref: "#/responses/MarkdownRender"
213 422:
214 $ref: "#/responses/validationError"
215 /markdown/raw:
216 post:
217 consumes:
218 - "text/plain"
219 produces:
220 - "text/html"
221 tags:
222 - "miscellaneous"
223 summary: "Render raw markdown as HTML"
224 operationId: "renderMarkdownRaw"
225 parameters:
226 -
227 description: "Request body to render"
228 name: "body"
229 in: "body"
230 required: true
231 schema:
232 type: "string"
233 responses:
234 200:
235 $ref: "#/responses/MarkdownRender"
236 422:
237 $ref: "#/responses/validationError"
238 /org/{org}/repos:
239 post:
240 consumes:
241 - "application/json"
242 produces:
243 - "application/json"
244 tags:
245 - "organization"
246 summary: "Create a repository in an organization"
247 operationId: "createOrgRepo"
248 parameters:
249 -
250 type: "string"
251 description: "name of organization"
252 name: "org"
253 in: "path"
254 required: true
255 -
256 name: "body"
257 in: "body"
258 schema:
259 $ref: "#/definitions/CreateRepoOption"
260 responses:
261 201:
262 $ref: "#/responses/Repository"
263 403:
264 $ref: "#/responses/forbidden"
265 422:
266 $ref: "#/responses/validationError"
267 /orgs/{org}:
268 get:
269 produces:
270 - "application/json"
271 tags:
272 - "organization"
273 summary: "Get an organization"
274 operationId: "orgGet"
275 parameters:
276 -
277 type: "string"
278 description: "name of the organization to get"
279 name: "org"
280 in: "path"
281 required: true
282 responses:
283 200:
284 $ref: "#/responses/Organization"
285 patch:
286 consumes:
287 - "application/json"
288 produces:
289 - "application/json"
290 tags:
291 - "organization"
292 summary: "Edit an organization"
293 operationId: "orgEdit"
294 parameters:
295 -
296 type: "string"
297 description: "name of the organization to edit"
298 name: "org"
299 in: "path"
300 required: true
301 -
302 name: "body"
303 in: "body"
304 schema:
305 $ref: "#/definitions/EditOrgOption"
306 responses:
307 200:
308 $ref: "#/responses/Organization"
309 /orgs/{org}/hooks:
310 get:
311 produces:
312 - "application/json"
313 tags:
314 - "organization"
315 summary: "List an organization's webhooks"
316 operationId: "orgListHooks"
317 parameters:
318 -
319 type: "string"
320 description: "name of the organization"
321 name: "org"
322 in: "path"
323 required: true
324 responses:
325 200:
326 $ref: "#/responses/HookList"
327 /orgs/{org}/hooks/:
328 post:
329 consumes:
330 - "application/json"
331 produces:
332 - "application/json"
333 tags:
334 - "organization"
335 summary: "Create a hook"
336 operationId: "orgCreateHook"
337 parameters:
338 -
339 type: "string"
340 description: "name of the organization"
341 name: "org"
342 in: "path"
343 required: true
344 responses:
345 201:
346 $ref: "#/responses/Hook"
347 /orgs/{org}/hooks/{id}:
348 get:
349 produces:
350 - "application/json"
351 tags:
352 - "organization"
353 summary: "Get a hook"
354 operationId: "orgGetHook"
355 parameters:
356 -
357 type: "string"
358 description: "name of the organization"
359 name: "org"
360 in: "path"
361 required: true
362 -
363 type: "integer"
364 description: "id of the hook to get"
365 name: "id"
366 in: "path"
367 required: true
368 responses:
369 200:
370 $ref: "#/responses/Hook"
371 delete:
372 produces:
373 - "application/json"
374 tags:
375 - "organization"
376 summary: "Delete a hook"
377 operationId: "orgDeleteHook"
378 parameters:
379 -
380 type: "string"
381 description: "name of the organization"
382 name: "org"
383 in: "path"
384 required: true
385 -
386 type: "integer"
387 description: "id of the hook to delete"
388 name: "id"
389 in: "path"
390 required: true
391 responses:
392 204:
393 $ref: "#/responses/empty"
394 patch:
395 consumes:
396 - "application/json"
397 produces:
398 - "application/json"
399 tags:
400 - "organization"
401 summary: "Update a hook"
402 operationId: "orgEditHook"
403 parameters:
404 -
405 type: "string"
406 description: "name of the organization"
407 name: "org"
408 in: "path"
409 required: true
410 -
411 type: "integer"
412 description: "id of the hook to update"
413 name: "id"
414 in: "path"
415 required: true
416 responses:
417 200:
418 $ref: "#/responses/Hook"
419 /orgs/{org}/members:
420 get:
421 produces:
422 - "application/json"
423 tags:
424 - "organization"
425 summary: "List an organization's members"
426 operationId: "orgListMembers"
427 parameters:
428 -
429 type: "string"
430 description: "name of the organization"
431 name: "org"
432 in: "path"
433 required: true
434 responses:
435 200:
436 $ref: "#/responses/UserList"
437 /orgs/{org}/members/{username}:
438 get:
439 tags:
440 - "organization"
441 summary: "Check if a user is a member of an organization"
442 operationId: "orgIsMember"
443 parameters:
444 -
445 type: "string"
446 description: "name of the organization"
447 name: "org"
448 in: "path"
449 required: true
450 -
451 type: "string"
452 description: "username of the user"
453 name: "username"
454 in: "path"
455 required: true
456 responses:
457 204:
458 description: "user is a member"
459 schema:
460 $ref: "#/responses/empty"
461 404:
462 description: "user is not a member"
463 schema:
464 $ref: "#/responses/empty"
465 delete:
466 produces:
467 - "application/json"
468 tags:
469 - "organization"
470 summary: "Remove a member from an organization"
471 operationId: "orgDeleteMember"
472 parameters:
473 -
474 type: "string"
475 description: "name of the organization"
476 name: "org"
477 in: "path"
478 required: true
479 -
480 type: "string"
481 description: "username of the user"
482 name: "username"
483 in: "path"
484 required: true
485 responses:
486 204:
487 description: "member removed"
488 schema:
489 $ref: "#/responses/empty"
490 /orgs/{org}/public_members:
491 get:
492 produces:
493 - "application/json"
494 tags:
495 - "organization"
496 summary: "List an organization's public members"
497 operationId: "orgListPublicMembers"
498 parameters:
499 -
500 type: "string"
501 description: "name of the organization"
502 name: "org"
503 in: "path"
504 required: true
505 responses:
506 200:
507 $ref: "#/responses/UserList"
508 /orgs/{org}/public_members/{username}:
509 get:
510 tags:
511 - "organization"
512 summary: "Check if a user is a public member of an organization"
513 operationId: "orgIsPublicMember"
514 parameters:
515 -
516 type: "string"
517 description: "name of the organization"
518 name: "org"
519 in: "path"
520 required: true
521 -
522 type: "string"
523 description: "username of the user"
524 name: "username"
525 in: "path"
526 required: true
527 responses:
528 204:
529 description: "user is a public member"
530 schema:
531 $ref: "#/responses/empty"
532 404:
533 description: "user is not a public member"
534 schema:
535 $ref: "#/responses/empty"
536 put:
537 produces:
538 - "application/json"
539 tags:
540 - "organization"
541 summary: "Publicize a user's membership"
542 operationId: "orgPublicizeMember"
543 parameters:
544 -
545 type: "string"
546 description: "name of the organization"
547 name: "org"
548 in: "path"
549 required: true
550 -
551 type: "string"
552 description: "username of the user"
553 name: "username"
554 in: "path"
555 required: true
556 responses:
557 204:
558 description: "membership publicized"
559 schema:
560 $ref: "#/responses/empty"
561 delete:
562 produces:
563 - "application/json"
564 tags:
565 - "organization"
566 summary: "Conceal a user's membership"
567 operationId: "orgConcealMember"
568 parameters:
569 -
570 type: "string"
571 description: "name of the organization"
572 name: "org"
573 in: "path"
574 required: true
575 -
576 type: "string"
577 description: "username of the user"
578 name: "username"
579 in: "path"
580 required: true
581 responses:
582 204:
583 $ref: "#/responses/empty"
584 /orgs/{org}/repos:
585 get:
586 produces:
587 - "application/json"
588 tags:
589 - "organization"
590 summary: "List an organization's repos"
591 operationId: "orgListRepos"
592 parameters:
593 -
594 type: "string"
595 description: "name of the organization"
596 name: "org"
597 in: "path"
598 required: true
599 responses:
600 200:
601 $ref: "#/responses/RepositoryList"
602 /orgs/{org}/teams:
603 get:
604 produces:
605 - "application/json"
606 tags:
607 - "organization"
608 summary: "List an organization's teams"
609 operationId: "orgListTeams"
610 parameters:
611 -
612 type: "string"
613 description: "name of the organization"
614 name: "org"
615 in: "path"
616 required: true
617 responses:
618 200:
619 $ref: "#/responses/TeamList"
620 post:
621 consumes:
622 - "application/json"
623 produces:
624 - "application/json"
625 tags:
626 - "organization"
627 summary: "Create a team"
628 operationId: "orgCreateTeam"
629 parameters:
630 -
631 type: "string"
632 description: "name of the organization"
633 name: "org"
634 in: "path"
635 required: true
636 -
637 name: "body"
638 in: "body"
639 schema:
640 $ref: "#/definitions/CreateTeamOption"
641 responses:
642 201:
643 $ref: "#/responses/Team"
644 /repos/migrate:
645 post:
646 consumes:
647 - "application/json"
648 produces:
649 - "application/json"
650 tags:
651 - "repository"
652 summary: "Migrate a remote git repository"
653 operationId: "repoMigrate"
654 parameters:
655 -
656 name: "body"
657 in: "body"
658 schema:
659 $ref: "#/definitions/MigrateRepoForm"
660 responses:
661 201:
662 $ref: "#/responses/Repository"
663 /repos/search:
664 get:
665 produces:
666 - "application/json"
667 tags:
668 - "repository"
669 summary: "Search for repositories"
670 operationId: "repoSearch"
671 parameters:
672 -
673 type: "string"
674 description: "keyword"
675 name: "q"
676 in: "query"
677 -
678 type: "integer"
679 description: "search only for repos that the user with the given id owns or contributes to"
680 name: "uid"
681 in: "query"
682 -
683 type: "integer"
684 description: "page number of results to return (1-based)"
685 name: "page"
686 in: "query"
687 -
688 type: "integer"
689 description: "page size of results, maximum page size is 50"
690 name: "limit"
691 in: "query"
692 -
693 type: "string"
694 description: "type of repository to search for. Supported values are \"fork\", \"source\", \"mirror\" and \"collaborative\""
695 name: "mode"
696 in: "query"
697 -
698 type: "boolean"
699 description: "if `uid` is given, search only for repos that the user owns"
700 name: "exclusive"
701 in: "query"
702 responses:
703 200:
704 $ref: "#/responses/SearchResults"
705 422:
706 $ref: "#/responses/validationError"
707 /repos/{owner}/{repo}:
708 get:
709 produces:
710 - "application/json"
711 tags:
712 - "repository"
713 summary: "Get a repository"
714 operationId: "repoGet"
715 parameters:
716 -
717 type: "string"
718 description: "owner of the repo"
719 name: "owner"
720 in: "path"
721 required: true
722 -
723 type: "string"
724 description: "name of the repo"
725 name: "repo"
726 in: "path"
727 required: true
728 responses:
729 200:
730 $ref: "#/responses/Repository"
731 delete:
732 produces:
733 - "application/json"
734 tags:
735 - "repository"
736 summary: "Delete a repository"
737 operationId: "repoDelete"
738 parameters:
739 -
740 type: "string"
741 description: "owner of the repo to delete"
742 name: "owner"
743 in: "path"
744 required: true
745 -
746 type: "string"
747 description: "name of the repo to delete"
748 name: "repo"
749 in: "path"
750 required: true
751 responses:
752 204:
753 $ref: "#/responses/empty"
754 403:
755 $ref: "#/responses/forbidden"
756 /repos/{owner}/{repo}/archive/{archive}:
757 get:
758 produces:
759 - "application/json"
760 tags:
761 - "repository"
762 summary: "Get an archive of a repository"
763 operationId: "repoGetArchive"
764 parameters:
765 -
766 type: "string"
767 description: "owner of the repo"
768 name: "owner"
769 in: "path"
770 required: true
771 -
772 type: "string"
773 description: "name of the repo"
774 name: "repo"
775 in: "path"
776 required: true
777 -
778 type: "string"
779 description: "archive to download, consisting of a git reference and archive"
780 name: "archive"
781 in: "path"
782 required: true
783 responses:
784 200:
785 description: "success"
786 /repos/{owner}/{repo}/branches:
787 get:
788 produces:
789 - "application/json"
790 tags:
791 - "repository"
792 summary: "List a repository's branches"
793 operationId: "repoListBranches"
794 parameters:
795 -
796 type: "string"
797 description: "owner of the repo"
798 name: "owner"
799 in: "path"
800 required: true
801 -
802 type: "string"
803 description: "name of the repo"
804 name: "repo"
805 in: "path"
806 required: true
807 responses:
808 200:
809 $ref: "#/responses/BranchList"
810 /repos/{owner}/{repo}/branches/{branch}:
811 get:
812 produces:
813 - "application/json"
814 tags:
815 - "repository"
816 summary: "List a repository's branches"
817 operationId: "repoGetBranch"
818 parameters:
819 -
820 type: "string"
821 description: "owner of the repo"
822 name: "owner"
823 in: "path"
824 required: true
825 -
826 type: "string"
827 description: "name of the repo"
828 name: "repo"
829 in: "path"
830 required: true
831 -
832 type: "string"
833 description: "branch to get"
834 name: "branch"
835 in: "path"
836 required: true
837 responses:
838 200:
839 $ref: "#/responses/Branch"
840 /repos/{owner}/{repo}/collaborators:
841 get:
842 produces:
843 - "application/json"
844 tags:
845 - "repository"
846 summary: "List a repository's collaborators"
847 operationId: "repoListCollaborators"
848 parameters:
849 -
850 type: "string"
851 description: "owner of the repo"
852 name: "owner"
853 in: "path"
854 required: true
855 -
856 type: "string"
857 description: "name of the repo"
858 name: "repo"
859 in: "path"
860 required: true
861 responses:
862 200:
863 $ref: "#/responses/UserList"
864 /repos/{owner}/{repo}/collaborators/{collaborator}:
865 get:
866 produces:
867 - "application/json"
868 tags:
869 - "repository"
870 summary: "Check if a user is a collaborator of a repository"
871 operationId: "repoCheckCollaborator"
872 parameters:
873 -
874 type: "string"
875 description: "owner of the repo"
876 name: "owner"
877 in: "path"
878 required: true
879 -
880 type: "string"
881 description: "name of the repo"
882 name: "repo"
883 in: "path"
884 required: true
885 -
886 type: "string"
887 description: "username of the collaborator"
888 name: "collaborator"
889 in: "path"
890 required: true
891 responses:
892 204:
893 $ref: "#/responses/empty"
894 404:
895 $ref: "#/responses/empty"
896 put:
897 produces:
898 - "application/json"
899 tags:
900 - "repository"
901 summary: "Add a collaborator to a repository"
902 operationId: "repoAddCollaborator"
903 parameters:
904 -
905 type: "string"
906 description: "owner of the repo"
907 name: "owner"
908 in: "path"
909 required: true
910 -
911 type: "string"
912 description: "name of the repo"
913 name: "repo"
914 in: "path"
915 required: true
916 -
917 type: "string"
918 description: "username of the collaborator to add"
919 name: "collaborator"
920 in: "path"
921 required: true
922 -
923 name: "body"
924 in: "body"
925 schema:
926 $ref: "#/definitions/AddCollaboratorOption"
927 responses:
928 204:
929 $ref: "#/responses/empty"
930 delete:
931 produces:
932 - "application/json"
933 tags:
934 - "repository"
935 summary: "Delete a collaborator from a repository"
936 operationId: "repoDeleteCollaborator"
937 parameters:
938 -
939 type: "string"
940 description: "owner of the repo"
941 name: "owner"
942 in: "path"
943 required: true
944 -
945 type: "string"
946 description: "name of the repo"
947 name: "repo"
948 in: "path"
949 required: true
950 -
951 type: "string"
952 description: "username of the collaborator to delete"
953 name: "collaborator"
954 in: "path"
955 required: true
956 responses:
957 204:
958 $ref: "#/responses/empty"
959 /repos/{owner}/{repo}/commits/{ref}/statuses:
960 get:
961 produces:
962 - "application/json"
963 tags:
964 - "repository"
965 summary: "Get a commit's combined status, by branch/tag/commit reference"
966 operationId: "repoGetCombinedStatusByRef"
967 parameters:
968 -
969 type: "string"
970 description: "owner of the repo"
971 name: "owner"
972 in: "path"
973 required: true
974 -
975 type: "string"
976 description: "name of the repo"
977 name: "repo"
978 in: "path"
979 required: true
980 -
981 type: "string"
982 description: "name of branch/tag/commit"
983 name: "ref"
984 in: "path"
985 required: true
986 responses:
987 200:
988 $ref: "#/responses/Status"
989 /repos/{owner}/{repo}/editorconfig/{filepath}:
990 get:
991 produces:
992 - "application/json"
993 tags:
994 - "repository"
995 summary: "Get the EditorConfig definitions of a file in a repository"
996 operationId: "repoGetEditorConfig"
997 parameters:
998 -
999 type: "string"
1000 description: "owner of the repo"
1001 name: "owner"
1002 in: "path"
1003 required: true
1004 -
1005 type: "string"
1006 description: "name of the repo"
1007 name: "repo"
1008 in: "path"
1009 required: true
1010 -
1011 type: "string"
1012 description: "filepath of file to get"
1013 name: "filepath"
1014 in: "path"
1015 required: true
1016 responses:
1017 200:
1018 description: "success"
1019 /repos/{owner}/{repo}/forks:
1020 get:
1021 produces:
1022 - "application/json"
1023 tags:
1024 - "repository"
1025 summary: "List a repository's forks"
1026 operationId: "listForks"
1027 parameters:
1028 -
1029 type: "string"
1030 description: "owner of the repo"
1031 name: "owner"
1032 in: "path"
1033 required: true
1034 -
1035 type: "string"
1036 description: "name of the repo"
1037 name: "repo"
1038 in: "path"
1039 required: true
1040 responses:
1041 200:
1042 $ref: "#/responses/RepositoryList"
1043 post:
1044 produces:
1045 - "application/json"
1046 tags:
1047 - "repository"
1048 summary: "Fork a repository"
1049 operationId: "createFork"
1050 parameters:
1051 -
1052 type: "string"
1053 description: "owner of the repo to fork"
1054 name: "owner"
1055 in: "path"
1056 required: true
1057 -
1058 type: "string"
1059 description: "name of the repo to fork"
1060 name: "repo"
1061 in: "path"
1062 required: true
1063 -
1064 name: "body"
1065 in: "body"
1066 schema:
1067 $ref: "#/definitions/CreateForkOption"
1068 responses:
1069 202:
1070 $ref: "#/responses/Repository"
1071 /repos/{owner}/{repo}/hooks:
1072 get:
1073 produces:
1074 - "application/json"
1075 tags:
1076 - "repository"
1077 summary: "List the hooks in a repository"
1078 operationId: "repoListHooks"
1079 parameters:
1080 -
1081 type: "string"
1082 description: "owner of the repo"
1083 name: "owner"
1084 in: "path"
1085 required: true
1086 -
1087 type: "string"
1088 description: "name of the repo"
1089 name: "repo"
1090 in: "path"
1091 required: true
1092 responses:
1093 200:
1094 $ref: "#/responses/HookList"
1095 post:
1096 consumes:
1097 - "application/json"
1098 produces:
1099 - "application/json"
1100 tags:
1101 - "repository"
1102 summary: "Create a hook"
1103 operationId: "repoCreateHook"
1104 parameters:
1105 -
1106 type: "string"
1107 description: "owner of the repo"
1108 name: "owner"
1109 in: "path"
1110 required: true
1111 -
1112 type: "string"
1113 description: "name of the repo"
1114 name: "repo"
1115 in: "path"
1116 required: true
1117 -
1118 name: "body"
1119 in: "body"
1120 schema:
1121 $ref: "#/definitions/CreateHookOption"
1122 responses:
1123 201:
1124 $ref: "#/responses/Hook"
1125 /repos/{owner}/{repo}/hooks/{id}:
1126 get:
1127 produces:
1128 - "application/json"
1129 tags:
1130 - "repository"
1131 summary: "Get a hook"
1132 operationId: "repoGetHook"
1133 parameters:
1134 -
1135 type: "string"
1136 description: "owner of the repo"
1137 name: "owner"
1138 in: "path"
1139 required: true
1140 -
1141 type: "string"
1142 description: "name of the repo"
1143 name: "repo"
1144 in: "path"
1145 required: true
1146 -
1147 type: "integer"
1148 description: "id of the hook to get"
1149 name: "id"
1150 in: "path"
1151 required: true
1152 responses:
1153 200:
1154 $ref: "#/responses/Hook"
1155 delete:
1156 produces:
1157 - "application/json"
1158 tags:
1159 - "repository"
1160 summary: "Delete a hook in a repository"
1161 operationId: "repoDeleteHook"
1162 parameters:
1163 -
1164 type: "string"
1165 description: "owner of the repo"
1166 name: "owner"
1167 in: "path"
1168 required: true
1169 -
1170 type: "string"
1171 description: "name of the repo"
1172 name: "repo"
1173 in: "path"
1174 required: true
1175 -
1176 type: "integer"
1177 description: "id of the hook to delete"
1178 name: "id"
1179 in: "path"
1180 required: true
1181 responses:
1182 204:
1183 $ref: "#/responses/empty"
1184 404:
1185 $ref: "#/responses/notFound"
1186 patch:
1187 produces:
1188 - "application/json"
1189 tags:
1190 - "repository"
1191 summary: "Edit a hook in a repository"
1192 operationId: "repoEditHook"
1193 parameters:
1194 -
1195 type: "string"
1196 description: "owner of the repo"
1197 name: "owner"
1198 in: "path"
1199 required: true
1200 -
1201 type: "string"
1202 description: "name of the repo"
1203 name: "repo"
1204 in: "path"
1205 required: true
1206 -
1207 type: "integer"
1208 description: "index of the hook"
1209 name: "id"
1210 in: "path"
1211 required: true
1212 -
1213 name: "body"
1214 in: "body"
1215 schema:
1216 $ref: "#/definitions/EditHookOption"
1217 responses:
1218 200:
1219 $ref: "#/responses/Hook"
1220 /repos/{owner}/{repo}/hooks/{id}/tests:
1221 post:
1222 produces:
1223 - "application/json"
1224 tags:
1225 - "repository"
1226 summary: "Test a push webhook"
1227 operationId: "repoTestHook"
1228 parameters:
1229 -
1230 type: "string"
1231 description: "owner of the repo"
1232 name: "owner"
1233 in: "path"
1234 required: true
1235 -
1236 type: "string"
1237 description: "name of the repo"
1238 name: "repo"
1239 in: "path"
1240 required: true
1241 -
1242 type: "integer"
1243 description: "id of the hook to test"
1244 name: "id"
1245 in: "path"
1246 required: true
1247 responses:
1248 204:
1249 $ref: "#/responses/empty"
1250 /repos/{owner}/{repo}/issues:
1251 get:
1252 produces:
1253 - "application/json"
1254 tags:
1255 - "issue"
1256 summary: "List a repository's issues"
1257 operationId: "issueListIssues"
1258 parameters:
1259 -
1260 type: "string"
1261 description: "owner of the repo"
1262 name: "owner"
1263 in: "path"
1264 required: true
1265 -
1266 type: "string"
1267 description: "name of the repo"
1268 name: "repo"
1269 in: "path"
1270 required: true
1271 -
1272 type: "string"
1273 description: "whether issue is open or closed"
1274 name: "state"
1275 in: "query"
1276 -
1277 type: "integer"
1278 description: "page number of requested issues"
1279 name: "page"
1280 in: "query"
1281 -
1282 type: "string"
1283 description: "search string"
1284 name: "q"
1285 in: "query"
1286 responses:
1287 200:
1288 $ref: "#/responses/IssueList"
1289 post:
1290 consumes:
1291 - "application/json"
1292 produces:
1293 - "application/json"
1294 tags:
1295 - "issue"
1296 summary: "Create an issue"
1297 operationId: "issueCreateIssue"
1298 parameters:
1299 -
1300 type: "string"
1301 description: "owner of the repo"
1302 name: "owner"
1303 in: "path"
1304 required: true
1305 -
1306 type: "string"
1307 description: "name of the repo"
1308 name: "repo"
1309 in: "path"
1310 required: true
1311 -
1312 name: "body"
1313 in: "body"
1314 schema:
1315 $ref: "#/definitions/CreateIssueOption"
1316 responses:
1317 201:
1318 $ref: "#/responses/Issue"
1319 /repos/{owner}/{repo}/issues/comments:
1320 get:
1321 produces:
1322 - "application/json"
1323 tags:
1324 - "issue"
1325 summary: "List all comments in a repository"
1326 operationId: "issueGetRepoComments"
1327 parameters:
1328 -
1329 type: "string"
1330 description: "owner of the repo"
1331 name: "owner"
1332 in: "path"
1333 required: true
1334 -
1335 type: "string"
1336 description: "name of the repo"
1337 name: "repo"
1338 in: "path"
1339 required: true
1340 -
1341 type: "string"
1342 description: "if provided, only comments updated since the provided time are returned."
1343 name: "since"
1344 in: "query"
1345 responses:
1346 200:
1347 $ref: "#/responses/CommentList"
1348 /repos/{owner}/{repo}/issues/comments/{id}:
1349 delete:
1350 tags:
1351 - "issue"
1352 summary: "Delete a comment"
1353 operationId: "issueDeleteComment"
1354 parameters:
1355 -
1356 type: "string"
1357 description: "owner of the repo"
1358 name: "owner"
1359 in: "path"
1360 required: true
1361 -
1362 type: "string"
1363 description: "name of the repo"
1364 name: "repo"
1365 in: "path"
1366 required: true
1367 -
1368 type: "integer"
1369 description: "id of comment to delete"
1370 name: "id"
1371 in: "path"
1372 required: true
1373 responses:
1374 204:
1375 $ref: "#/responses/empty"
1376 patch:
1377 consumes:
1378 - "application/json"
1379 produces:
1380 - "application/json"
1381 tags:
1382 - "issue"
1383 summary: "Edit a comment"
1384 operationId: "issueEditComment"
1385 parameters:
1386 -
1387 type: "string"
1388 description: "owner of the repo"
1389 name: "owner"
1390 in: "path"
1391 required: true
1392 -
1393 type: "string"
1394 description: "name of the repo"
1395 name: "repo"
1396 in: "path"
1397 required: true
1398 -
1399 type: "integer"
1400 description: "id of the comment to edit"
1401 name: "id"
1402 in: "path"
1403 required: true
1404 -
1405 name: "body"
1406 in: "body"
1407 schema:
1408 $ref: "#/definitions/EditIssueCommentOption"
1409 responses:
1410 200:
1411 $ref: "#/responses/Comment"
1412 /repos/{owner}/{repo}/issues/{id}/times:
1413 get:
1414 produces:
1415 - "application/json"
1416 tags:
1417 - "issue"
1418 summary: "List an issue's tracked times"
1419 operationId: "issueTrackedTimes"
1420 parameters:
1421 -
1422 type: "string"
1423 description: "owner of the repo"
1424 name: "owner"
1425 in: "path"
1426 required: true
1427 -
1428 type: "string"
1429 description: "name of the repo"
1430 name: "repo"
1431 in: "path"
1432 required: true
1433 -
1434 type: "integer"
1435 description: "index of the issue"
1436 name: "id"
1437 in: "path"
1438 required: true
1439 responses:
1440 200:
1441 $ref: "#/responses/TrackedTimeList"
1442 post:
1443 consumes:
1444 - "application/json"
1445 produces:
1446 - "application/json"
1447 tags:
1448 - "issue"
1449 summary: "Add a tracked time to a issue"
1450 operationId: "issueAddTime"
1451 parameters:
1452 -
1453 type: "string"
1454 description: "owner of the repo"
1455 name: "owner"
1456 in: "path"
1457 required: true
1458 -
1459 type: "string"
1460 description: "name of the repo"
1461 name: "repo"
1462 in: "path"
1463 required: true
1464 -
1465 type: "integer"
1466 description: "index of the issue to add tracked time to"
1467 name: "id"
1468 in: "path"
1469 required: true
1470 -
1471 name: "body"
1472 in: "body"
1473 schema:
1474 $ref: "#/definitions/AddTimeOption"
1475 responses:
1476 200:
1477 $ref: "#/responses/TrackedTime"
1478 400:
1479 $ref: "#/responses/error"
1480 403:
1481 $ref: "#/responses/error"
1482 /repos/{owner}/{repo}/issues/{index}:
1483 get:
1484 produces:
1485 - "application/json"
1486 tags:
1487 - "issue"
1488 summary: "Get an issue"
1489 operationId: "issueGetIssue"
1490 parameters:
1491 -
1492 type: "string"
1493 description: "owner of the repo"
1494 name: "owner"
1495 in: "path"
1496 required: true
1497 -
1498 type: "string"
1499 description: "name of the repo"
1500 name: "repo"
1501 in: "path"
1502 required: true
1503 -
1504 type: "integer"
1505 description: "index of the issue to get"
1506 name: "index"
1507 in: "path"
1508 required: true
1509 responses:
1510 200:
1511 $ref: "#/responses/Issue"
1512 patch:
1513 consumes:
1514 - "application/json"
1515 produces:
1516 - "application/json"
1517 tags:
1518 - "issue"
1519 summary: "Edit an issue"
1520 operationId: "issueEditIssue"
1521 parameters:
1522 -
1523 type: "string"
1524 description: "owner of the repo"
1525 name: "owner"
1526 in: "path"
1527 required: true
1528 -
1529 type: "string"
1530 description: "name of the repo"
1531 name: "repo"
1532 in: "path"
1533 required: true
1534 -
1535 type: "integer"
1536 description: "index of the issue to edit"
1537 name: "index"
1538 in: "path"
1539 required: true
1540 -
1541 name: "body"
1542 in: "body"
1543 schema:
1544 $ref: "#/definitions/EditIssueOption"
1545 responses:
1546 201:
1547 $ref: "#/responses/Issue"
1548 /repos/{owner}/{repo}/issues/{index}/comments:
1549 get:
1550 produces:
1551 - "application/json"
1552 tags:
1553 - "issue"
1554 summary: "List all comments on an issue"
1555 operationId: "issueGetComments"
1556 parameters:
1557 -
1558 type: "string"
1559 description: "owner of the repo"
1560 name: "owner"
1561 in: "path"
1562 required: true
1563 -
1564 type: "string"
1565 description: "name of the repo"
1566 name: "repo"
1567 in: "path"
1568 required: true
1569 -
1570 type: "integer"
1571 description: "index of the issue"
1572 name: "index"
1573 in: "path"
1574 required: true
1575 -
1576 type: "string"
1577 description: "if provided, only comments updated since the specified time are returned."
1578 name: "since"
1579 in: "query"
1580 responses:
1581 200:
1582 $ref: "#/responses/CommentList"
1583 post:
1584 consumes:
1585 - "application/json"
1586 produces:
1587 - "application/json"
1588 tags:
1589 - "issue"
1590 summary: "Add a comment to an issue"
1591 operationId: "issueCreateComment"
1592 parameters:
1593 -
1594 type: "string"
1595 description: "owner of the repo"
1596 name: "owner"
1597 in: "path"
1598 required: true
1599 -
1600 type: "string"
1601 description: "name of the repo"
1602 name: "repo"
1603 in: "path"
1604 required: true
1605 -
1606 type: "integer"
1607 description: "index of the issue"
1608 name: "index"
1609 in: "path"
1610 required: true
1611 -
1612 name: "body"
1613 in: "body"
1614 schema:
1615 $ref: "#/definitions/CreateIssueCommentOption"
1616 responses:
1617 201:
1618 $ref: "#/responses/Comment"
1619 /repos/{owner}/{repo}/issues/{index}/comments/{id}:
1620 delete:
1621 tags:
1622 - "issue"
1623 summary: "Delete a comment"
1624 operationId: "issueDeleteCommentDeprecated"
1625 deprecated: true
1626 parameters:
1627 -
1628 type: "string"
1629 description: "owner of the repo"
1630 name: "owner"
1631 in: "path"
1632 required: true
1633 -
1634 type: "string"
1635 description: "name of the repo"
1636 name: "repo"
1637 in: "path"
1638 required: true
1639 -
1640 type: "integer"
1641 description: "this parameter is ignored"
1642 name: "index"
1643 in: "path"
1644 required: true
1645 -
1646 type: "integer"
1647 description: "id of comment to delete"
1648 name: "id"
1649 in: "path"
1650 required: true
1651 responses:
1652 204:
1653 $ref: "#/responses/empty"
1654 patch:
1655 consumes:
1656 - "application/json"
1657 produces:
1658 - "application/json"
1659 tags:
1660 - "issue"
1661 summary: "Edit a comment"
1662 operationId: "issueEditCommentDeprecated"
1663 deprecated: true
1664 parameters:
1665 -
1666 type: "string"
1667 description: "owner of the repo"
1668 name: "owner"
1669 in: "path"
1670 required: true
1671 -
1672 type: "string"
1673 description: "name of the repo"
1674 name: "repo"
1675 in: "path"
1676 required: true
1677 -
1678 type: "integer"
1679 description: "this parameter is ignored"
1680 name: "index"
1681 in: "path"
1682 required: true
1683 -
1684 type: "integer"
1685 description: "id of the comment to edit"
1686 name: "id"
1687 in: "path"
1688 required: true
1689 -
1690 name: "body"
1691 in: "body"
1692 schema:
1693 $ref: "#/definitions/EditIssueCommentOption"
1694 responses:
1695 200:
1696 $ref: "#/responses/Comment"
1697 /repos/{owner}/{repo}/issues/{index}/deadline:
1698 post:
1699 consumes:
1700 - "application/json"
1701 produces:
1702 - "application/json"
1703 tags:
1704 - "issue"
1705 summary: "Set an issue deadline. If set to null, the deadline is deleted."
1706 operationId: "issueEditIssueDeadline"
1707 parameters:
1708 -
1709 type: "string"
1710 description: "owner of the repo"
1711 name: "owner"
1712 in: "path"
1713 required: true
1714 -
1715 type: "string"
1716 description: "name of the repo"
1717 name: "repo"
1718 in: "path"
1719 required: true
1720 -
1721 type: "integer"
1722 description: "index of the issue to create or update a deadline on"
1723 name: "index"
1724 in: "path"
1725 required: true
1726 -
1727 name: "body"
1728 in: "body"
1729 schema:
1730 $ref: "#/definitions/EditDeadlineOption"
1731 responses:
1732 201:
1733 $ref: "#/responses/IssueDeadline"
1734 403:
1735 description: "Not repo writer"
1736 schema:
1737 $ref: "#/responses/forbidden"
1738 404:
1739 description: "Issue not found"
1740 schema:
1741 $ref: "#/responses/empty"
1742 /repos/{owner}/{repo}/issues/{index}/labels:
1743 get:
1744 produces:
1745 - "application/json"
1746 tags:
1747 - "issue"
1748 summary: "Get an issue's labels"
1749 operationId: "issueGetLabels"
1750 parameters:
1751 -
1752 type: "string"
1753 description: "owner of the repo"
1754 name: "owner"
1755 in: "path"
1756 required: true
1757 -
1758 type: "string"
1759 description: "name of the repo"
1760 name: "repo"
1761 in: "path"
1762 required: true
1763 -
1764 type: "integer"
1765 description: "index of the issue"
1766 name: "index"
1767 in: "path"
1768 required: true
1769 responses:
1770 200:
1771 $ref: "#/responses/LabelList"
1772 404:
1773 $ref: "#/responses/notFound"
1774 put:
1775 consumes:
1776 - "application/json"
1777 produces:
1778 - "application/json"
1779 tags:
1780 - "issue"
1781 summary: "Replace an issue's labels"
1782 operationId: "issueReplaceLabels"
1783 parameters:
1784 -
1785 type: "string"
1786 description: "owner of the repo"
1787 name: "owner"
1788 in: "path"
1789 required: true
1790 -
1791 type: "string"
1792 description: "name of the repo"
1793 name: "repo"
1794 in: "path"
1795 required: true
1796 -
1797 type: "integer"
1798 description: "index of the issue"
1799 name: "index"
1800 in: "path"
1801 required: true
1802 -
1803 name: "body"
1804 in: "body"
1805 schema:
1806 $ref: "#/definitions/IssueLabelsOption"
1807 responses:
1808 200:
1809 $ref: "#/responses/LabelList"
1810 post:
1811 consumes:
1812 - "application/json"
1813 produces:
1814 - "application/json"
1815 tags:
1816 - "issue"
1817 summary: "Add a label to an issue"
1818 operationId: "issueAddLabel"
1819 parameters:
1820 -
1821 type: "string"
1822 description: "owner of the repo"
1823 name: "owner"
1824 in: "path"
1825 required: true
1826 -
1827 type: "string"
1828 description: "name of the repo"
1829 name: "repo"
1830 in: "path"
1831 required: true
1832 -
1833 type: "integer"
1834 description: "index of the issue"
1835 name: "index"
1836 in: "path"
1837 required: true
1838 -
1839 name: "body"
1840 in: "body"
1841 schema:
1842 $ref: "#/definitions/IssueLabelsOption"
1843 responses:
1844 200:
1845 $ref: "#/responses/LabelList"
1846 delete:
1847 produces:
1848 - "application/json"
1849 tags:
1850 - "issue"
1851 summary: "Remove all labels from an issue"
1852 operationId: "issueClearLabels"
1853 parameters:
1854 -
1855 type: "string"
1856 description: "owner of the repo"
1857 name: "owner"
1858 in: "path"
1859 required: true
1860 -
1861 type: "string"
1862 description: "name of the repo"
1863 name: "repo"
1864 in: "path"
1865 required: true
1866 -
1867 type: "integer"
1868 description: "index of the issue"
1869 name: "index"
1870 in: "path"
1871 required: true
1872 responses:
1873 204:
1874 $ref: "#/responses/empty"
1875 /repos/{owner}/{repo}/issues/{index}/labels/{id}:
1876 delete:
1877 produces:
1878 - "application/json"
1879 tags:
1880 - "issue"
1881 summary: "Remove a label from an issue"
1882 operationId: "issueRemoveLabel"
1883 parameters:
1884 -
1885 type: "string"
1886 description: "owner of the repo"
1887 name: "owner"
1888 in: "path"
1889 required: true
1890 -
1891 type: "string"
1892 description: "name of the repo"
1893 name: "repo"
1894 in: "path"
1895 required: true
1896 -
1897 type: "integer"
1898 description: "index of the issue"
1899 name: "index"
1900 in: "path"
1901 required: true
1902 -
1903 type: "integer"
1904 description: "id of the label to remove"
1905 name: "id"
1906 in: "path"
1907 required: true
1908 responses:
1909 204:
1910 $ref: "#/responses/empty"
1911 /repos/{owner}/{repo}/keys:
1912 get:
1913 produces:
1914 - "application/json"
1915 tags:
1916 - "repository"
1917 summary: "List a repository's keys"
1918 operationId: "repoListKeys"
1919 parameters:
1920 -
1921 type: "string"
1922 description: "owner of the repo"
1923 name: "owner"
1924 in: "path"
1925 required: true
1926 -
1927 type: "string"
1928 description: "name of the repo"
1929 name: "repo"
1930 in: "path"
1931 required: true
1932 responses:
1933 200:
1934 $ref: "#/responses/DeployKeyList"
1935 post:
1936 consumes:
1937 - "application/json"
1938 produces:
1939 - "application/json"
1940 tags:
1941 - "repository"
1942 summary: "Add a key to a repository"
1943 operationId: "repoCreateKey"
1944 parameters:
1945 -
1946 type: "string"
1947 description: "owner of the repo"
1948 name: "owner"
1949 in: "path"
1950 required: true
1951 -
1952 type: "string"
1953 description: "name of the repo"
1954 name: "repo"
1955 in: "path"
1956 required: true
1957 -
1958 name: "body"
1959 in: "body"
1960 schema:
1961 $ref: "#/definitions/CreateKeyOption"
1962 responses:
1963 201:
1964 $ref: "#/responses/DeployKey"
1965 /repos/{owner}/{repo}/keys/{id}:
1966 get:
1967 produces:
1968 - "application/json"
1969 tags:
1970 - "repository"
1971 summary: "Get a repository's key by id"
1972 operationId: "repoGetKey"
1973 parameters:
1974 -
1975 type: "string"
1976 description: "owner of the repo"
1977 name: "owner"
1978 in: "path"
1979 required: true
1980 -
1981 type: "string"
1982 description: "name of the repo"
1983 name: "repo"
1984 in: "path"
1985 required: true
1986 -
1987 type: "integer"
1988 description: "id of the key to get"
1989 name: "id"
1990 in: "path"
1991 required: true
1992 responses:
1993 200:
1994 $ref: "#/responses/DeployKey"
1995 delete:
1996 tags:
1997 - "repository"
1998 summary: "Delete a key from a repository"
1999 operationId: "repoDeleteKey"
2000 parameters:
2001 -
2002 type: "string"
2003 description: "owner of the repo"
2004 name: "owner"
2005 in: "path"
2006 required: true
2007 -
2008 type: "string"
2009 description: "name of the repo"
2010 name: "repo"
2011 in: "path"
2012 required: true
2013 -
2014 type: "integer"
2015 description: "id of the key to delete"
2016 name: "id"
2017 in: "path"
2018 required: true
2019 responses:
2020 204:
2021 $ref: "#/responses/empty"
2022 /repos/{owner}/{repo}/labels:
2023 get:
2024 produces:
2025 - "application/json"
2026 tags:
2027 - "issue"
2028 summary: "Get all of a repository's labels"
2029 operationId: "issueListLabels"
2030 parameters:
2031 -
2032 type: "string"
2033 description: "owner of the repo"
2034 name: "owner"
2035 in: "path"
2036 required: true
2037 -
2038 type: "string"
2039 description: "name of the repo"
2040 name: "repo"
2041 in: "path"
2042 required: true
2043 responses:
2044 200:
2045 $ref: "#/responses/LabelList"
2046 post:
2047 consumes:
2048 - "application/json"
2049 produces:
2050 - "application/json"
2051 tags:
2052 - "issue"
2053 summary: "Create a label"
2054 operationId: "issueCreateLabel"
2055 parameters:
2056 -
2057 type: "string"
2058 description: "owner of the repo"
2059 name: "owner"
2060 in: "path"
2061 required: true
2062 -
2063 type: "string"
2064 description: "name of the repo"
2065 name: "repo"
2066 in: "path"
2067 required: true
2068 -
2069 name: "body"
2070 in: "body"
2071 schema:
2072 $ref: "#/definitions/CreateLabelOption"
2073 responses:
2074 201:
2075 $ref: "#/responses/Label"
2076 /repos/{owner}/{repo}/labels/{id}:
2077 get:
2078 produces:
2079 - "application/json"
2080 tags:
2081 - "issue"
2082 summary: "Get a single label"
2083 operationId: "issueGetLabel"
2084 parameters:
2085 -
2086 type: "string"
2087 description: "owner of the repo"
2088 name: "owner"
2089 in: "path"
2090 required: true
2091 -
2092 type: "string"
2093 description: "name of the repo"
2094 name: "repo"
2095 in: "path"
2096 required: true
2097 -
2098 type: "integer"
2099 description: "id of the label to get"
2100 name: "id"
2101 in: "path"
2102 required: true
2103 responses:
2104 200:
2105 $ref: "#/responses/Label"
2106 delete:
2107 tags:
2108 - "issue"
2109 summary: "Delete a label"
2110 operationId: "issueDeleteLabel"
2111 parameters:
2112 -
2113 type: "string"
2114 description: "owner of the repo"
2115 name: "owner"
2116 in: "path"
2117 required: true
2118 -
2119 type: "string"
2120 description: "name of the repo"
2121 name: "repo"
2122 in: "path"
2123 required: true
2124 -
2125 type: "integer"
2126 description: "id of the label to delete"
2127 name: "id"
2128 in: "path"
2129 required: true
2130 responses:
2131 204:
2132 $ref: "#/responses/empty"
2133 patch:
2134 consumes:
2135 - "application/json"
2136 produces:
2137 - "application/json"
2138 tags:
2139 - "issue"
2140 summary: "Update a label"
2141 operationId: "issueEditLabel"
2142 parameters:
2143 -
2144 type: "string"
2145 description: "owner of the repo"
2146 name: "owner"
2147 in: "path"
2148 required: true
2149 -
2150 type: "string"
2151 description: "name of the repo"
2152 name: "repo"
2153 in: "path"
2154 required: true
2155 -
2156 type: "integer"
2157 description: "id of the label to edit"
2158 name: "id"
2159 in: "path"
2160 required: true
2161 -
2162 name: "body"
2163 in: "body"
2164 schema:
2165 $ref: "#/definitions/EditLabelOption"
2166 responses:
2167 200:
2168 $ref: "#/responses/Label"
2169 /repos/{owner}/{repo}/milestones:
2170 get:
2171 produces:
2172 - "application/json"
2173 tags:
2174 - "issue"
2175 summary: "Get all of a repository's milestones"
2176 operationId: "issueGetMilestonesList"
2177 parameters:
2178 -
2179 type: "string"
2180 description: "owner of the repo"
2181 name: "owner"
2182 in: "path"
2183 required: true
2184 -
2185 type: "string"
2186 description: "name of the repo"
2187 name: "repo"
2188 in: "path"
2189 required: true
2190 responses:
2191 200:
2192 $ref: "#/responses/MilestoneList"
2193 post:
2194 consumes:
2195 - "application/json"
2196 produces:
2197 - "application/json"
2198 tags:
2199 - "issue"
2200 summary: "Create a milestone"
2201 operationId: "issueCreateMilestone"
2202 parameters:
2203 -
2204 type: "string"
2205 description: "owner of the repo"
2206 name: "owner"
2207 in: "path"
2208 required: true
2209 -
2210 type: "string"
2211 description: "name of the repo"
2212 name: "repo"
2213 in: "path"
2214 required: true
2215 -
2216 name: "body"
2217 in: "body"
2218 schema:
2219 $ref: "#/definitions/CreateMilestoneOption"
2220 responses:
2221 201:
2222 $ref: "#/responses/Milestone"
2223 /repos/{owner}/{repo}/milestones/{id}:
2224 get:
2225 produces:
2226 - "application/json"
2227 tags:
2228 - "issue"
2229 summary: "Get a milestone"
2230 operationId: "issueGetMilestone"
2231 parameters:
2232 -
2233 type: "string"
2234 description: "owner of the repo"
2235 name: "owner"
2236 in: "path"
2237 required: true
2238 -
2239 type: "string"
2240 description: "name of the repo"
2241 name: "repo"
2242 in: "path"
2243 required: true
2244 -
2245 type: "integer"
2246 description: "id of the milestone"
2247 name: "id"
2248 in: "path"
2249 required: true
2250 responses:
2251 200:
2252 $ref: "#/responses/Milestone"
2253 delete:
2254 tags:
2255 - "issue"
2256 summary: "Delete a milestone"
2257 operationId: "issueDeleteMilestone"
2258 parameters:
2259 -
2260 type: "string"
2261 description: "owner of the repo"
2262 name: "owner"
2263 in: "path"
2264 required: true
2265 -
2266 type: "string"
2267 description: "name of the repo"
2268 name: "repo"
2269 in: "path"
2270 required: true
2271 -
2272 type: "integer"
2273 description: "id of the milestone to delete"
2274 name: "id"
2275 in: "path"
2276 required: true
2277 responses:
2278 204:
2279 $ref: "#/responses/empty"
2280 patch:
2281 consumes:
2282 - "application/json"
2283 produces:
2284 - "application/json"
2285 tags:
2286 - "issue"
2287 summary: "Update a milestone"
2288 operationId: "issueEditMilestone"
2289 parameters:
2290 -
2291 type: "string"
2292 description: "owner of the repo"
2293 name: "owner"
2294 in: "path"
2295 required: true
2296 -
2297 type: "string"
2298 description: "name of the repo"
2299 name: "repo"
2300 in: "path"
2301 required: true
2302 -
2303 type: "integer"
2304 description: "id of the milestone"
2305 name: "id"
2306 in: "path"
2307 required: true
2308 -
2309 name: "body"
2310 in: "body"
2311 schema:
2312 $ref: "#/definitions/EditMilestoneOption"
2313 responses:
2314 200:
2315 $ref: "#/responses/Milestone"
2316 /repos/{owner}/{repo}/mirror-sync:
2317 post:
2318 produces:
2319 - "application/json"
2320 tags:
2321 - "repository"
2322 summary: "Sync a mirrored repository"
2323 operationId: "repoMirrorSync"
2324 parameters:
2325 -
2326 type: "string"
2327 description: "owner of the repo to sync"
2328 name: "owner"
2329 in: "path"
2330 required: true
2331 -
2332 type: "string"
2333 description: "name of the repo to sync"
2334 name: "repo"
2335 in: "path"
2336 required: true
2337 responses:
2338 200:
2339 $ref: "#/responses/empty"
2340 /repos/{owner}/{repo}/pulls:
2341 get:
2342 produces:
2343 - "application/json"
2344 tags:
2345 - "repository"
2346 summary: "List a repo's pull requests"
2347 operationId: "repoListPullRequests"
2348 parameters:
2349 -
2350 type: "string"
2351 description: "owner of the repo"
2352 name: "owner"
2353 in: "path"
2354 required: true
2355 -
2356 type: "string"
2357 description: "name of the repo"
2358 name: "repo"
2359 in: "path"
2360 required: true
2361 responses:
2362 200:
2363 $ref: "#/responses/PullRequestList"
2364 post:
2365 consumes:
2366 - "application/json"
2367 produces:
2368 - "application/json"
2369 tags:
2370 - "repository"
2371 summary: "Create a pull request"
2372 operationId: "repoCreatePullRequest"
2373 parameters:
2374 -
2375 type: "string"
2376 description: "owner of the repo"
2377 name: "owner"
2378 in: "path"
2379 required: true
2380 -
2381 type: "string"
2382 description: "name of the repo"
2383 name: "repo"
2384 in: "path"
2385 required: true
2386 -
2387 name: "body"
2388 in: "body"
2389 schema:
2390 $ref: "#/definitions/CreatePullRequestOption"
2391 responses:
2392 201:
2393 $ref: "#/responses/PullRequest"
2394 /repos/{owner}/{repo}/pulls/{index}:
2395 get:
2396 produces:
2397 - "application/json"
2398 tags:
2399 - "repository"
2400 summary: "Get a pull request"
2401 operationId: "repoGetPullRequest"
2402 parameters:
2403 -
2404 type: "string"
2405 description: "owner of the repo"
2406 name: "owner"
2407 in: "path"
2408 required: true
2409 -
2410 type: "string"
2411 description: "name of the repo"
2412 name: "repo"
2413 in: "path"
2414 required: true
2415 -
2416 type: "integer"
2417 description: "index of the pull request to get"
2418 name: "index"
2419 in: "path"
2420 required: true
2421 responses:
2422 200:
2423 $ref: "#/responses/PullRequest"
2424 patch:
2425 consumes:
2426 - "application/json"
2427 produces:
2428 - "application/json"
2429 tags:
2430 - "repository"
2431 summary: "Update a pull request"
2432 operationId: "repoEditPullRequest"
2433 parameters:
2434 -
2435 type: "string"
2436 description: "owner of the repo"
2437 name: "owner"
2438 in: "path"
2439 required: true
2440 -
2441 type: "string"
2442 description: "name of the repo"
2443 name: "repo"
2444 in: "path"
2445 required: true
2446 -
2447 type: "integer"
2448 description: "index of the pull request to edit"
2449 name: "index"
2450 in: "path"
2451 required: true
2452 -
2453 name: "body"
2454 in: "body"
2455 schema:
2456 $ref: "#/definitions/EditPullRequestOption"
2457 responses:
2458 201:
2459 $ref: "#/responses/PullRequest"
2460 /repos/{owner}/{repo}/pulls/{index}/merge:
2461 get:
2462 produces:
2463 - "application/json"
2464 tags:
2465 - "repository"
2466 summary: "Check if a pull request has been merged"
2467 operationId: "repoPullRequestIsMerged"
2468 parameters:
2469 -
2470 type: "string"
2471 description: "owner of the repo"
2472 name: "owner"
2473 in: "path"
2474 required: true
2475 -
2476 type: "string"
2477 description: "name of the repo"
2478 name: "repo"
2479 in: "path"
2480 required: true
2481 -
2482 type: "integer"
2483 description: "index of the pull request"
2484 name: "index"
2485 in: "path"
2486 required: true
2487 responses:
2488 204:
2489 description: "pull request has been merged"
2490 schema:
2491 $ref: "#/responses/empty"
2492 404:
2493 description: "pull request has not been merged"
2494 schema:
2495 $ref: "#/responses/empty"
2496 post:
2497 produces:
2498 - "application/json"
2499 tags:
2500 - "repository"
2501 summary: "Merge a pull request"
2502 operationId: "repoMergePullRequest"
2503 parameters:
2504 -
2505 type: "string"
2506 description: "owner of the repo"
2507 name: "owner"
2508 in: "path"
2509 required: true
2510 -
2511 type: "string"
2512 description: "name of the repo"
2513 name: "repo"
2514 in: "path"
2515 required: true
2516 -
2517 type: "integer"
2518 description: "index of the pull request to merge"
2519 name: "index"
2520 in: "path"
2521 required: true
2522 responses:
2523 200:
2524 $ref: "#/responses/empty"
2525 405:
2526 $ref: "#/responses/empty"
2527 /repos/{owner}/{repo}/raw/{filepath}:
2528 get:
2529 produces:
2530 - "application/json"
2531 tags:
2532 - "repository"
2533 summary: "Get a file from a repository"
2534 operationId: "repoGetRawFile"
2535 parameters:
2536 -
2537 type: "string"
2538 description: "owner of the repo"
2539 name: "owner"
2540 in: "path"
2541 required: true
2542 -
2543 type: "string"
2544 description: "name of the repo"
2545 name: "repo"
2546 in: "path"
2547 required: true
2548 -
2549 type: "string"
2550 description: "filepath of the file to get"
2551 name: "filepath"
2552 in: "path"
2553 required: true
2554 responses:
2555 200:
2556 description: "success"
2557 /repos/{owner}/{repo}/releases:
2558 get:
2559 produces:
2560 - "application/json"
2561 tags:
2562 - "repository"
2563 summary: "List a repo's releases"
2564 operationId: "repoListReleases"
2565 parameters:
2566 -
2567 type: "string"
2568 description: "owner of the repo"
2569 name: "owner"
2570 in: "path"
2571 required: true
2572 -
2573 type: "string"
2574 description: "name of the repo"
2575 name: "repo"
2576 in: "path"
2577 required: true
2578 responses:
2579 200:
2580 $ref: "#/responses/ReleaseList"
2581 post:
2582 consumes:
2583 - "application/json"
2584 produces:
2585 - "application/json"
2586 tags:
2587 - "repository"
2588 summary: "Create a release"
2589 operationId: "repoCreateRelease"
2590 parameters:
2591 -
2592 type: "string"
2593 description: "owner of the repo"
2594 name: "owner"
2595 in: "path"
2596 required: true
2597 -
2598 type: "string"
2599 description: "name of the repo"
2600 name: "repo"
2601 in: "path"
2602 required: true
2603 -
2604 name: "body"
2605 in: "body"
2606 schema:
2607 $ref: "#/definitions/CreateReleaseOption"
2608 responses:
2609 201:
2610 $ref: "#/responses/Release"
2611 /repos/{owner}/{repo}/releases/{id}:
2612 get:
2613 produces:
2614 - "application/json"
2615 tags:
2616 - "repository"
2617 summary: "Get a release"
2618 operationId: "repoGetRelease"
2619 parameters:
2620 -
2621 type: "string"
2622 description: "owner of the repo"
2623 name: "owner"
2624 in: "path"
2625 required: true
2626 -
2627 type: "string"
2628 description: "name of the repo"
2629 name: "repo"
2630 in: "path"
2631 required: true
2632 -
2633 type: "integer"
2634 description: "id of the release to get"
2635 name: "id"
2636 in: "path"
2637 required: true
2638 responses:
2639 200:
2640 $ref: "#/responses/Release"
2641 delete:
2642 tags:
2643 - "repository"
2644 summary: "Delete a release"
2645 operationId: "repoDeleteRelease"
2646 parameters:
2647 -
2648 type: "string"
2649 description: "owner of the repo"
2650 name: "owner"
2651 in: "path"
2652 required: true
2653 -
2654 type: "string"
2655 description: "name of the repo"
2656 name: "repo"
2657 in: "path"
2658 required: true
2659 -
2660 type: "integer"
2661 description: "id of the release to delete"
2662 name: "id"
2663 in: "path"
2664 required: true
2665 responses:
2666 204:
2667 $ref: "#/responses/empty"
2668 patch:
2669 consumes:
2670 - "application/json"
2671 produces:
2672 - "application/json"
2673 tags:
2674 - "repository"
2675 summary: "Update a release"
2676 operationId: "repoEditRelease"
2677 parameters:
2678 -
2679 type: "string"
2680 description: "owner of the repo"
2681 name: "owner"
2682 in: "path"
2683 required: true
2684 -
2685 type: "string"
2686 description: "name of the repo"
2687 name: "repo"
2688 in: "path"
2689 required: true
2690 -
2691 type: "integer"
2692 description: "id of the release to edit"
2693 name: "id"
2694 in: "path"
2695 required: true
2696 -
2697 name: "body"
2698 in: "body"
2699 schema:
2700 $ref: "#/definitions/EditReleaseOption"
2701 responses:
2702 200:
2703 $ref: "#/responses/Release"
2704 /repos/{owner}/{repo}/releases/{id}/assets:
2705 get:
2706 produces:
2707 - "application/json"
2708 tags:
2709 - "repository"
2710 summary: "List release's attachments"
2711 operationId: "repoListReleaseAttachments"
2712 parameters:
2713 -
2714 type: "string"
2715 description: "owner of the repo"
2716 name: "owner"
2717 in: "path"
2718 required: true
2719 -
2720 type: "string"
2721 description: "name of the repo"
2722 name: "repo"
2723 in: "path"
2724 required: true
2725 -
2726 type: "integer"
2727 description: "id of the release"
2728 name: "id"
2729 in: "path"
2730 required: true
2731 responses:
2732 200:
2733 $ref: "#/responses/AttachmentList"
2734 post:
2735 consumes:
2736 - "multipart/form-data"
2737 produces:
2738 - "application/json"
2739 tags:
2740 - "repository"
2741 summary: "Create a release attachment"
2742 operationId: "repoCreateReleaseAttachment"
2743 parameters:
2744 -
2745 type: "string"
2746 description: "owner of the repo"
2747 name: "owner"
2748 in: "path"
2749 required: true
2750 -
2751 type: "string"
2752 description: "name of the repo"
2753 name: "repo"
2754 in: "path"
2755 required: true
2756 -
2757 type: "integer"
2758 description: "id of the release"
2759 name: "id"
2760 in: "path"
2761 required: true
2762 -
2763 type: "string"
2764 description: "name of the attachment"
2765 name: "name"
2766 in: "query"
2767 -
2768 type: "file"
2769 description: "attachment to upload"
2770 name: "attachment"
2771 in: "formData"
2772 required: true
2773 responses:
2774 201:
2775 $ref: "#/responses/Attachment"
2776 /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}:
2777 get:
2778 produces:
2779 - "application/json"
2780 tags:
2781 - "repository"
2782 summary: "Get a release attachment"
2783 operationId: "repoGetReleaseAttachment"
2784 parameters:
2785 -
2786 type: "string"
2787 description: "owner of the repo"
2788 name: "owner"
2789 in: "path"
2790 required: true
2791 -
2792 type: "string"
2793 description: "name of the repo"
2794 name: "repo"
2795 in: "path"
2796 required: true
2797 -
2798 type: "integer"
2799 description: "id of the release"
2800 name: "id"
2801 in: "path"
2802 required: true
2803 -
2804 type: "integer"
2805 description: "id of the attachment to get"
2806 name: "attachment_id"
2807 in: "path"
2808 required: true
2809 responses:
2810 200:
2811 $ref: "#/responses/Attachment"
2812 delete:
2813 produces:
2814 - "application/json"
2815 tags:
2816 - "repository"
2817 summary: "Delete a release attachment"
2818 operationId: "repoDeleteReleaseAttachment"
2819 parameters:
2820 -
2821 type: "string"
2822 description: "owner of the repo"
2823 name: "owner"
2824 in: "path"
2825 required: true
2826 -
2827 type: "string"
2828 description: "name of the repo"
2829 name: "repo"
2830 in: "path"
2831 required: true
2832 -
2833 type: "integer"
2834 description: "id of the release"
2835 name: "id"
2836 in: "path"
2837 required: true
2838 -
2839 type: "integer"
2840 description: "id of the attachment to delete"
2841 name: "attachment_id"
2842 in: "path"
2843 required: true
2844 responses:
2845 204:
2846 $ref: "#/responses/empty"
2847 patch:
2848 consumes:
2849 - "application/json"
2850 produces:
2851 - "application/json"
2852 tags:
2853 - "repository"
2854 summary: "Edit a release attachment"
2855 operationId: "repoEditReleaseAttachment"
2856 parameters:
2857 -
2858 type: "string"
2859 description: "owner of the repo"
2860 name: "owner"
2861 in: "path"
2862 required: true
2863 -
2864 type: "string"
2865 description: "name of the repo"
2866 name: "repo"
2867 in: "path"
2868 required: true
2869 -
2870 type: "integer"
2871 description: "id of the release"
2872 name: "id"
2873 in: "path"
2874 required: true
2875 -
2876 type: "integer"
2877 description: "id of the attachment to edit"
2878 name: "attachment_id"
2879 in: "path"
2880 required: true
2881 -
2882 name: "body"
2883 in: "body"
2884 schema:
2885 $ref: "#/definitions/EditAttachmentOptions"
2886 responses:
2887 201:
2888 $ref: "#/responses/Attachment"
2889 /repos/{owner}/{repo}/stargazers:
2890 get:
2891 produces:
2892 - "application/json"
2893 tags:
2894 - "repository"
2895 summary: "List a repo's stargazers"
2896 operationId: "repoListStargazers"
2897 parameters:
2898 -
2899 type: "string"
2900 description: "owner of the repo"
2901 name: "owner"
2902 in: "path"
2903 required: true
2904 -
2905 type: "string"
2906 description: "name of the repo"
2907 name: "repo"
2908 in: "path"
2909 required: true
2910 responses:
2911 200:
2912 $ref: "#/responses/UserList"
2913 /repos/{owner}/{repo}/statuses/{sha}:
2914 get:
2915 produces:
2916 - "application/json"
2917 tags:
2918 - "repository"
2919 summary: "Get a commit's statuses"
2920 operationId: "repoListStatuses"
2921 parameters:
2922 -
2923 type: "string"
2924 description: "owner of the repo"
2925 name: "owner"
2926 in: "path"
2927 required: true
2928 -
2929 type: "string"
2930 description: "name of the repo"
2931 name: "repo"
2932 in: "path"
2933 required: true
2934 -
2935 type: "string"
2936 description: "sha of the commit"
2937 name: "sha"
2938 in: "path"
2939 required: true
2940 responses:
2941 200:
2942 $ref: "#/responses/StatusList"
2943 post:
2944 produces:
2945 - "application/json"
2946 tags:
2947 - "repository"
2948 summary: "Create a commit status"
2949 operationId: "repoCreateStatus"
2950 parameters:
2951 -
2952 type: "string"
2953 description: "owner of the repo"
2954 name: "owner"
2955 in: "path"
2956 required: true
2957 -
2958 type: "string"
2959 description: "name of the repo"
2960 name: "repo"
2961 in: "path"
2962 required: true
2963 -
2964 type: "string"
2965 description: "sha of the commit"
2966 name: "sha"
2967 in: "path"
2968 required: true
2969 -
2970 name: "body"
2971 in: "body"
2972 schema:
2973 $ref: "#/definitions/CreateStatusOption"
2974 responses:
2975 200:
2976 $ref: "#/responses/StatusList"
2977 /repos/{owner}/{repo}/subscribers:
2978 get:
2979 produces:
2980 - "application/json"
2981 tags:
2982 - "repository"
2983 summary: "List a repo's watchers"
2984 operationId: "repoListSubscribers"
2985 parameters:
2986 -
2987 type: "string"
2988 description: "owner of the repo"
2989 name: "owner"
2990 in: "path"
2991 required: true
2992 -
2993 type: "string"
2994 description: "name of the repo"
2995 name: "repo"
2996 in: "path"
2997 required: true
2998 responses:
2999 200:
3000 $ref: "#/responses/UserList"
3001 /repos/{owner}/{repo}/subscription:
3002 get:
3003 tags:
3004 - "repository"
3005 summary: "Check if the current user is watching a repo"
3006 operationId: "userCurrentCheckSubscription"
3007 parameters:
3008 -
3009 type: "string"
3010 description: "owner of the repo"
3011 name: "owner"
3012 in: "path"
3013 required: true
3014 -
3015 type: "string"
3016 description: "name of the repo"
3017 name: "repo"
3018 in: "path"
3019 required: true
3020 responses:
3021 200:
3022 $ref: "#/responses/WatchInfo"
3023 put:
3024 tags:
3025 - "repository"
3026 summary: "Watch a repo"
3027 operationId: "userCurrentPutSubscription"
3028 parameters:
3029 -
3030 type: "string"
3031 description: "owner of the repo"
3032 name: "owner"
3033 in: "path"
3034 required: true
3035 -
3036 type: "string"
3037 description: "name of the repo"
3038 name: "repo"
3039 in: "path"
3040 required: true
3041 responses:
3042 200:
3043 $ref: "#/responses/WatchInfo"
3044 delete:
3045 tags:
3046 - "repository"
3047 summary: "Unwatch a repo"
3048 operationId: "userCurrentDeleteSubscription"
3049 parameters:
3050 -
3051 type: "string"
3052 description: "owner of the repo"
3053 name: "owner"
3054 in: "path"
3055 required: true
3056 -
3057 type: "string"
3058 description: "name of the repo"
3059 name: "repo"
3060 in: "path"
3061 required: true
3062 responses:
3063 204:
3064 $ref: "#/responses/empty"
3065 /repos/{owner}/{repo}/times:
3066 get:
3067 produces:
3068 - "application/json"
3069 tags:
3070 - "repository"
3071 summary: "List a repo's tracked times"
3072 operationId: "repoTrackedTimes"
3073 parameters:
3074 -
3075 type: "string"
3076 description: "owner of the repo"
3077 name: "owner"
3078 in: "path"
3079 required: true
3080 -
3081 type: "string"
3082 description: "name of the repo"
3083 name: "repo"
3084 in: "path"
3085 required: true
3086 responses:
3087 200:
3088 $ref: "#/responses/TrackedTimeList"
3089 /repos/{owner}/{repo}/times/{user}:
3090 get:
3091 produces:
3092 - "application/json"
3093 tags:
3094 - "user"
3095 summary: "List a user's tracked times in a repo"
3096 operationId: "userTrackedTimes"
3097 parameters:
3098 -
3099 type: "string"
3100 description: "owner of the repo"
3101 name: "owner"
3102 in: "path"
3103 required: true
3104 -
3105 type: "string"
3106 description: "name of the repo"
3107 name: "repo"
3108 in: "path"
3109 required: true
3110 -
3111 type: "string"
3112 description: "username of user"
3113 name: "user"
3114 in: "path"
3115 required: true
3116 responses:
3117 200:
3118 $ref: "#/responses/TrackedTimeList"
3119 /repositories/{id}:
3120 get:
3121 produces:
3122 - "application/json"
3123 tags:
3124 - "repository"
3125 summary: "Get a repository by id"
3126 operationId: "repoGetByID"
3127 parameters:
3128 -
3129 type: "integer"
3130 description: "id of the repo to get"
3131 name: "id"
3132 in: "path"
3133 required: true
3134 responses:
3135 200:
3136 $ref: "#/responses/Repository"
3137 /teams/{id}:
3138 get:
3139 produces:
3140 - "application/json"
3141 tags:
3142 - "organization"
3143 summary: "Get a team"
3144 operationId: "orgGetTeam"
3145 parameters:
3146 -
3147 type: "integer"
3148 description: "id of the team to get"
3149 name: "id"
3150 in: "path"
3151 required: true
3152 responses:
3153 200:
3154 $ref: "#/responses/Team"
3155 delete:
3156 tags:
3157 - "organization"
3158 summary: "Delete a team"
3159 operationId: "orgDeleteTeam"
3160 parameters:
3161 -
3162 type: "integer"
3163 description: "id of the team to delete"
3164 name: "id"
3165 in: "path"
3166 required: true
3167 responses:
3168 204:
3169 description: "team deleted"
3170 schema:
3171 $ref: "#/responses/empty"
3172 patch:
3173 consumes:
3174 - "application/json"
3175 produces:
3176 - "application/json"
3177 tags:
3178 - "organization"
3179 summary: "Edit a team"
3180 operationId: "orgEditTeam"
3181 parameters:
3182 -
3183 type: "integer"
3184 description: "id of the team to edit"
3185 name: "id"
3186 in: "path"
3187 required: true
3188 -
3189 name: "body"
3190 in: "body"
3191 schema:
3192 $ref: "#/definitions/EditTeamOption"
3193 responses:
3194 200:
3195 $ref: "#/responses/Team"
3196 /teams/{id}/members:
3197 get:
3198 produces:
3199 - "application/json"
3200 tags:
3201 - "organization"
3202 summary: "List a team's members"
3203 operationId: "orgListTeamMembers"
3204 parameters:
3205 -
3206 type: "integer"
3207 description: "id of the team"
3208 name: "id"
3209 in: "path"
3210 required: true
3211 responses:
3212 200:
3213 $ref: "#/responses/UserList"
3214 /teams/{id}/members/{username}:
3215 put:
3216 produces:
3217 - "application/json"
3218 tags:
3219 - "organization"
3220 summary: "Add a team member"
3221 operationId: "orgAddTeamMember"
3222 parameters:
3223 -
3224 type: "integer"
3225 description: "id of the team"
3226 name: "id"
3227 in: "path"
3228 required: true
3229 -
3230 type: "string"
3231 description: "username of the user to add"
3232 name: "username"
3233 in: "path"
3234 required: true
3235 responses:
3236 204:
3237 $ref: "#/responses/empty"
3238 delete:
3239 produces:
3240 - "application/json"
3241 tags:
3242 - "organization"
3243 summary: "Remove a team member"
3244 operationId: "orgRemoveTeamMember"
3245 parameters:
3246 -
3247 type: "integer"
3248 description: "id of the team"
3249 name: "id"
3250 in: "path"
3251 required: true
3252 -
3253 type: "string"
3254 description: "username of the user to remove"
3255 name: "username"
3256 in: "path"
3257 required: true
3258 responses:
3259 204:
3260 $ref: "#/responses/empty"
3261 /teams/{id}/repos:
3262 get:
3263 produces:
3264 - "application/json"
3265 tags:
3266 - "organization"
3267 summary: "List a team's repos"
3268 operationId: "orgListTeamRepos"
3269 parameters:
3270 -
3271 type: "integer"
3272 description: "id of the team"
3273 name: "id"
3274 in: "path"
3275 required: true
3276 responses:
3277 200:
3278 $ref: "#/responses/RepositoryList"
3279 /teams/{id}/repos/{org}/{repo}:
3280 put:
3281 produces:
3282 - "application/json"
3283 tags:
3284 - "organization"
3285 summary: "Add a repository to a team"
3286 operationId: "orgAddTeamRepository"
3287 parameters:
3288 -
3289 type: "integer"
3290 description: "id of the team"
3291 name: "id"
3292 in: "path"
3293 required: true
3294 -
3295 type: "string"
3296 description: "organization that owns the repo to add"
3297 name: "org"
3298 in: "path"
3299 required: true
3300 -
3301 type: "string"
3302 description: "name of the repo to add"
3303 name: "repo"
3304 in: "path"
3305 required: true
3306 responses:
3307 204:
3308 $ref: "#/responses/empty"
3309 delete:
3310 description: "This does not delete the repository, it only removes the repository from the team."
3311 produces:
3312 - "application/json"
3313 tags:
3314 - "organization"
3315 summary: "Remove a repository from a team"
3316 operationId: "orgRemoveTeamRepository"
3317 parameters:
3318 -
3319 type: "integer"
3320 description: "id of the team"
3321 name: "id"
3322 in: "path"
3323 required: true
3324 -
3325 type: "string"
3326 description: "organization that owns the repo to remove"
3327 name: "org"
3328 in: "path"
3329 required: true
3330 -
3331 type: "string"
3332 description: "name of the repo to remove"
3333 name: "repo"
3334 in: "path"
3335 required: true
3336 responses:
3337 204:
3338 $ref: "#/responses/empty"
3339 /topics/search:
3340 get:
3341 produces:
3342 - "application/json"
3343 tags:
3344 - "repository"
3345 summary: "search topics via keyword"
3346 operationId: "topicSearch"
3347 parameters:
3348 -
3349 type: "string"
3350 description: "keywords to search"
3351 name: "q"
3352 in: "query"
3353 required: true
3354 responses:
3355 200:
3356 $ref: "#/responses/Repository"
3357 /user:
3358 get:
3359 produces:
3360 - "application/json"
3361 tags:
3362 - "user"
3363 summary: "Get the authenticated user"
3364 operationId: "userGetCurrent"
3365 responses:
3366 200:
3367 $ref: "#/responses/User"
3368 /user/emails:
3369 get:
3370 produces:
3371 - "application/json"
3372 tags:
3373 - "user"
3374 summary: "List the authenticated user's email addresses"
3375 operationId: "userListEmails"
3376 responses:
3377 200:
3378 $ref: "#/responses/EmailList"
3379 post:
3380 produces:
3381 - "application/json"
3382 tags:
3383 - "user"
3384 summary: "Add email addresses"
3385 operationId: "userAddEmail"
3386 parameters:
3387 -
3388 name: "body"
3389 in: "body"
3390 schema:
3391 $ref: "#/definitions/CreateEmailOption"
3392 responses:
3393 201:
3394 $ref: "#/responses/EmailList"
3395 delete:
3396 produces:
3397 - "application/json"
3398 tags:
3399 - "user"
3400 summary: "Delete email addresses"
3401 operationId: "userDeleteEmail"
3402 parameters:
3403 -
3404 name: "body"
3405 in: "body"
3406 schema:
3407 $ref: "#/definitions/DeleteEmailOption"
3408 responses:
3409 204:
3410 $ref: "#/responses/empty"
3411 /user/followers:
3412 get:
3413 produces:
3414 - "application/json"
3415 tags:
3416 - "user"
3417 summary: "List the authenticated user's followers"
3418 operationId: "userCurrentListFollowers"
3419 responses:
3420 200:
3421 $ref: "#/responses/UserList"
3422 /user/following:
3423 get:
3424 produces:
3425 - "application/json"
3426 tags:
3427 - "user"
3428 summary: "List the users that the authenticated user is following"
3429 operationId: "userCurrentListFollowing"
3430 responses:
3431 200:
3432 $ref: "#/responses/UserList"
3433 /user/following/{username}:
3434 get:
3435 tags:
3436 - "user"
3437 summary: "Check whether a user is followed by the authenticated user"
3438 operationId: "userCurrentCheckFollowing"
3439 parameters:
3440 -
3441 type: "string"
3442 description: "username of followed user"
3443 name: "username"
3444 in: "path"
3445 required: true
3446 responses:
3447 204:
3448 $ref: "#/responses/empty"
3449 404:
3450 $ref: "#/responses/notFound"
3451 put:
3452 tags:
3453 - "user"
3454 summary: "Follow a user"
3455 operationId: "userCurrentPutFollow"
3456 parameters:
3457 -
3458 type: "string"
3459 description: "username of user to follow"
3460 name: "username"
3461 in: "path"
3462 required: true
3463 responses:
3464 204:
3465 $ref: "#/responses/empty"
3466 delete:
3467 tags:
3468 - "user"
3469 summary: "Unfollow a user"
3470 operationId: "userCurrentDeleteFollow"
3471 parameters:
3472 -
3473 type: "string"
3474 description: "username of user to unfollow"
3475 name: "username"
3476 in: "path"
3477 required: true
3478 responses:
3479 204:
3480 $ref: "#/responses/empty"
3481 /user/gpg_keys:
3482 get:
3483 produces:
3484 - "application/json"
3485 tags:
3486 - "user"
3487 summary: "List the authenticated user's GPG keys"
3488 operationId: "userCurrentListGPGKeys"
3489 responses:
3490 200:
3491 $ref: "#/responses/GPGKeyList"
3492 post:
3493 consumes:
3494 - "application/json"
3495 produces:
3496 - "application/json"
3497 tags:
3498 - "user"
3499 summary: "Create a GPG key"
3500 operationId: "userCurrentPostGPGKey"
3501 parameters:
3502 -
3503 name: "Form"
3504 in: "body"
3505 schema:
3506 $ref: "#/definitions/CreateGPGKeyOption"
3507 responses:
3508 201:
3509 $ref: "#/responses/GPGKey"
3510 422:
3511 $ref: "#/responses/validationError"
3512 /user/gpg_keys/{id}:
3513 get:
3514 produces:
3515 - "application/json"
3516 tags:
3517 - "user"
3518 summary: "Get a GPG key"
3519 operationId: "userCurrentGetGPGKey"
3520 parameters:
3521 -
3522 type: "integer"
3523 description: "id of key to get"
3524 name: "id"
3525 in: "path"
3526 required: true
3527 responses:
3528 200:
3529 $ref: "#/responses/GPGKey"
3530 404:
3531 $ref: "#/responses/notFound"
3532 delete:
3533 produces:
3534 - "application/json"
3535 tags:
3536 - "user"
3537 summary: "Remove a GPG key"
3538 operationId: "userCurrentDeleteGPGKey"
3539 parameters:
3540 -
3541 type: "integer"
3542 description: "id of key to delete"
3543 name: "id"
3544 in: "path"
3545 required: true
3546 responses:
3547 204:
3548 $ref: "#/responses/empty"
3549 403:
3550 $ref: "#/responses/forbidden"
3551 /user/keys:
3552 get:
3553 produces:
3554 - "application/json"
3555 tags:
3556 - "user"
3557 summary: "List the authenticated user's public keys"
3558 operationId: "userCurrentListKeys"
3559 responses:
3560 200:
3561 $ref: "#/responses/PublicKeyList"
3562 post:
3563 consumes:
3564 - "application/json"
3565 produces:
3566 - "application/json"
3567 tags:
3568 - "user"
3569 summary: "Create a public key"
3570 operationId: "userCurrentPostKey"
3571 parameters:
3572 -
3573 name: "body"
3574 in: "body"
3575 schema:
3576 $ref: "#/definitions/CreateKeyOption"
3577 responses:
3578 201:
3579 $ref: "#/responses/PublicKey"
3580 422:
3581 $ref: "#/responses/validationError"
3582 /user/keys/{id}:
3583 get:
3584 produces:
3585 - "application/json"
3586 tags:
3587 - "user"
3588 summary: "Get a public key"
3589 operationId: "userCurrentGetKey"
3590 parameters:
3591 -
3592 type: "integer"
3593 description: "id of key to get"
3594 name: "id"
3595 in: "path"
3596 required: true
3597 responses:
3598 200:
3599 $ref: "#/responses/PublicKey"
3600 404:
3601 $ref: "#/responses/notFound"
3602 delete:
3603 produces:
3604 - "application/json"
3605 tags:
3606 - "user"
3607 summary: "Delete a public key"
3608 operationId: "userCurrentDeleteKey"
3609 parameters:
3610 -
3611 type: "integer"
3612 description: "id of key to delete"
3613 name: "id"
3614 in: "path"
3615 required: true
3616 responses:
3617 204:
3618 $ref: "#/responses/empty"
3619 403:
3620 $ref: "#/responses/forbidden"
3621 404:
3622 $ref: "#/responses/notFound"
3623 /user/orgs:
3624 get:
3625 produces:
3626 - "application/json"
3627 tags:
3628 - "organization"
3629 summary: "List the current user's organizations"
3630 operationId: "orgListCurrentUserOrgs"
3631 responses:
3632 200:
3633 $ref: "#/responses/OrganizationList"
3634 /user/repos:
3635 get:
3636 produces:
3637 - "application/json"
3638 tags:
3639 - "user"
3640 summary: "List the repos that the authenticated user owns or has access to"
3641 operationId: "userCurrentListRepos"
3642 responses:
3643 200:
3644 $ref: "#/responses/RepositoryList"
3645 post:
3646 consumes:
3647 - "application/json"
3648 produces:
3649 - "application/json"
3650 tags:
3651 - "repository"
3652 - "user"
3653 summary: "Create a repository"
3654 operationId: "createCurrentUserRepo"
3655 parameters:
3656 -
3657 name: "body"
3658 in: "body"
3659 schema:
3660 $ref: "#/definitions/CreateRepoOption"
3661 responses:
3662 201:
3663 $ref: "#/responses/Repository"
3664 /user/starred:
3665 get:
3666 produces:
3667 - "application/json"
3668 tags:
3669 - "user"
3670 summary: "The repos that the authenticated user has starred"
3671 operationId: "userCurrentListStarred"
3672 responses:
3673 200:
3674 $ref: "#/responses/RepositoryList"
3675 /user/starred/{owner}/{repo}:
3676 get:
3677 tags:
3678 - "user"
3679 summary: "Whether the authenticated is starring the repo"
3680 operationId: "userCurrentCheckStarring"
3681 parameters:
3682 -
3683 type: "string"
3684 description: "owner of the repo"
3685 name: "owner"
3686 in: "path"
3687 required: true
3688 -
3689 type: "string"
3690 description: "name of the repo"
3691 name: "repo"
3692 in: "path"
3693 required: true
3694 responses:
3695 204:
3696 $ref: "#/responses/empty"
3697 404:
3698 $ref: "#/responses/notFound"
3699 put:
3700 tags:
3701 - "user"
3702 summary: "Star the given repo"
3703 operationId: "userCurrentPutStar"
3704 parameters:
3705 -
3706 type: "string"
3707 description: "owner of the repo to star"
3708 name: "owner"
3709 in: "path"
3710 required: true
3711 -
3712 type: "string"
3713 description: "name of the repo to star"
3714 name: "repo"
3715 in: "path"
3716 required: true
3717 responses:
3718 204:
3719 $ref: "#/responses/empty"
3720 delete:
3721 tags:
3722 - "user"
3723 summary: "Unstar the given repo"
3724 operationId: "userCurrentDeleteStar"
3725 parameters:
3726 -
3727 type: "string"
3728 description: "owner of the repo to unstar"
3729 name: "owner"
3730 in: "path"
3731 required: true
3732 -
3733 type: "string"
3734 description: "name of the repo to unstar"
3735 name: "repo"
3736 in: "path"
3737 required: true
3738 responses:
3739 204:
3740 $ref: "#/responses/empty"
3741 /user/subscriptions:
3742 get:
3743 produces:
3744 - "application/json"
3745 tags:
3746 - "user"
3747 summary: "List repositories watched by the authenticated user"
3748 operationId: "userCurrentListSubscriptions"
3749 responses:
3750 200:
3751 $ref: "#/responses/RepositoryList"
3752 /user/times:
3753 get:
3754 produces:
3755 - "application/json"
3756 tags:
3757 - "user"
3758 summary: "List the current user's tracked times"
3759 operationId: "userCurrentTrackedTimes"
3760 responses:
3761 200:
3762 $ref: "#/responses/TrackedTimeList"
3763 /user/{username}/orgs:
3764 get:
3765 produces:
3766 - "application/json"
3767 tags:
3768 - "organization"
3769 summary: "List a user's organizations"
3770 operationId: "orgListUserOrgs"
3771 parameters:
3772 -
3773 type: "string"
3774 description: "username of user"
3775 name: "username"
3776 in: "path"
3777 required: true
3778 responses:
3779 200:
3780 $ref: "#/responses/OrganizationList"
3781 /users/search:
3782 get:
3783 produces:
3784 - "application/json"
3785 tags:
3786 - "user"
3787 summary: "Search for users"
3788 operationId: "userSearch"
3789 parameters:
3790 -
3791 type: "string"
3792 description: "keyword"
3793 name: "q"
3794 in: "query"
3795 -
3796 type: "integer"
3797 description: "maximum number of users to return"
3798 name: "limit"
3799 in: "query"
3800 responses:
3801 200:
3802 $ref: "#/responses/UserList"
3803 /users/{follower}/following/{followee}:
3804 get:
3805 tags:
3806 - "user"
3807 summary: "Check if one user is following another user"
3808 operationId: "userCheckFollowing"
3809 parameters:
3810 -
3811 type: "string"
3812 description: "username of following user"
3813 name: "follower"
3814 in: "path"
3815 required: true
3816 -
3817 type: "string"
3818 description: "username of followed user"
3819 name: "followee"
3820 in: "path"
3821 required: true
3822 responses:
3823 204:
3824 $ref: "#/responses/empty"
3825 404:
3826 $ref: "#/responses/notFound"
3827 /users/{username}:
3828 get:
3829 produces:
3830 - "application/json"
3831 tags:
3832 - "user"
3833 summary: "Get a user"
3834 operationId: "userGet"
3835 parameters:
3836 -
3837 type: "string"
3838 description: "username of user to get"
3839 name: "username"
3840 in: "path"
3841 required: true
3842 responses:
3843 200:
3844 $ref: "#/responses/User"
3845 404:
3846 $ref: "#/responses/notFound"
3847 /users/{username}/followers:
3848 get:
3849 produces:
3850 - "application/json"
3851 tags:
3852 - "user"
3853 summary: "List the given user's followers"
3854 operationId: "userListFollowers"
3855 parameters:
3856 -
3857 type: "string"
3858 description: "username of user"
3859 name: "username"
3860 in: "path"
3861 required: true
3862 responses:
3863 200:
3864 $ref: "#/responses/UserList"
3865 /users/{username}/following:
3866 get:
3867 produces:
3868 - "application/json"
3869 tags:
3870 - "user"
3871 summary: "List the users that the given user is following"
3872 operationId: "userListFollowing"
3873 parameters:
3874 -
3875 type: "string"
3876 description: "username of user"
3877 name: "username"
3878 in: "path"
3879 required: true
3880 responses:
3881 200:
3882 $ref: "#/responses/UserList"
3883 /users/{username}/gpg_keys:
3884 get:
3885 produces:
3886 - "application/json"
3887 tags:
3888 - "user"
3889 summary: "List the given user's GPG keys"
3890 operationId: "userListGPGKeys"
3891 parameters:
3892 -
3893 type: "string"
3894 description: "username of user"
3895 name: "username"
3896 in: "path"
3897 required: true
3898 responses:
3899 200:
3900 $ref: "#/responses/GPGKeyList"
3901 /users/{username}/keys:
3902 get:
3903 produces:
3904 - "application/json"
3905 tags:
3906 - "user"
3907 summary: "List the given user's public keys"
3908 operationId: "userListKeys"
3909 parameters:
3910 -
3911 type: "string"
3912 description: "username of user"
3913 name: "username"
3914 in: "path"
3915 required: true
3916 responses:
3917 200:
3918 $ref: "#/responses/PublicKeyList"
3919 /users/{username}/repos:
3920 get:
3921 produces:
3922 - "application/json"
3923 tags:
3924 - "user"
3925 summary: "List the repos owned by the given user"
3926 operationId: "userListRepos"
3927 parameters:
3928 -
3929 type: "string"
3930 description: "username of user"
3931 name: "username"
3932 in: "path"
3933 required: true
3934 responses:
3935 200:
3936 $ref: "#/responses/RepositoryList"
3937 /users/{username}/starred:
3938 get:
3939 produces:
3940 - "application/json"
3941 tags:
3942 - "user"
3943 summary: "The repos that the given user has starred"
3944 operationId: "userListStarred"
3945 parameters:
3946 -
3947 type: "string"
3948 description: "username of user"
3949 name: "username"
3950 in: "path"
3951 required: true
3952 responses:
3953 200:
3954 $ref: "#/responses/RepositoryList"
3955 /users/{username}/subscriptions:
3956 get:
3957 produces:
3958 - "application/json"
3959 tags:
3960 - "user"
3961 summary: "List the repositories watched by a user"
3962 operationId: "userListSubscriptions"
3963 parameters:
3964 -
3965 type: "string"
3966 description: "username of the user"
3967 name: "username"
3968 in: "path"
3969 required: true
3970 responses:
3971 200:
3972 $ref: "#/responses/RepositoryList"
3973 /users/{username}/tokens:
3974 get:
3975 produces:
3976 - "application/json"
3977 tags:
3978 - "user"
3979 summary: "List the authenticated user's access tokens"
3980 operationId: "userGetTokens"
3981 parameters:
3982 -
3983 type: "string"
3984 description: "username of user"
3985 name: "username"
3986 in: "path"
3987 required: true
3988 responses:
3989 200:
3990 $ref: "#/responses/AccessTokenList"
3991 post:
3992 consumes:
3993 - "application/json"
3994 produces:
3995 - "application/json"
3996 tags:
3997 - "user"
3998 summary: "Create an access token"
3999 operationId: "userCreateToken"
4000 parameters:
4001 -
4002 type: "string"
4003 x-go-name: "Name"
4004 description: "username of user"
4005 name: "username"
4006 in: "path"
4007 required: true
4008 responses:
4009 200:
4010 $ref: "#/responses/AccessToken"
4011 /users/{username}/tokens/{token}:
4012 delete:
4013 produces:
4014 - "application/json"
4015 tags:
4016 - "user"
4017 summary: "delete an access token"
4018 operationId: "userDeleteAccessToken"
4019 parameters:
4020 -
4021 type: "string"
4022 description: "username of user"
4023 name: "username"
4024 in: "path"
4025 required: true
4026 -
4027 type: "integer"
4028 description: "token to be deleted"
4029 name: "token"
4030 in: "path"
4031 required: true
4032 responses:
4033 204:
4034 $ref: "#/responses/empty"
4035 /version:
4036 get:
4037 produces:
4038 - "application/json"
4039 tags:
4040 - "miscellaneous"
4041 summary: "Returns the version of the Gitea application"
4042 operationId: "getVersion"
4043 responses:
4044 200:
4045 $ref: "#/responses/ServerVersion"
4046 definitions:
4047 AddCollaboratorOption:
4048 description: "AddCollaboratorOption options when adding a user as a collaborator of a repository"
4049 type: "object"
4050 properties:
4051 permission:
4052 type: "string"
4053 x-go-name: "Permission"
4054 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4055 AddTimeOption:
4056 description: "AddTimeOption options for adding time to an issue"
4057 type: "object"
4058 required:
4059 - "time"
4060 properties:
4061 time:
4062 description: "time in seconds"
4063 type: "integer"
4064 format: "int64"
4065 x-go-name: "Time"
4066 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4067 Attachment:
4068 description: "Attachment a generic attachment"
4069 type: "object"
4070 properties:
4071 browser_download_url:
4072 type: "string"
4073 x-go-name: "DownloadURL"
4074 created_at:
4075 type: "string"
4076 format: "date-time"
4077 x-go-name: "Created"
4078 download_count:
4079 type: "integer"
4080 format: "int64"
4081 x-go-name: "DownloadCount"
4082 id:
4083 type: "integer"
4084 format: "int64"
4085 x-go-name: "ID"
4086 name:
4087 type: "string"
4088 x-go-name: "Name"
4089 size:
4090 type: "integer"
4091 format: "int64"
4092 x-go-name: "Size"
4093 uuid:
4094 type: "string"
4095 x-go-name: "UUID"
4096 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4097 Branch:
4098 description: "Branch represents a repository branch"
4099 type: "object"
4100 properties:
4101 commit:
4102 $ref: "#/definitions/PayloadCommit"
4103 name:
4104 type: "string"
4105 x-go-name: "Name"
4106 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4107 Comment:
4108 description: "Comment represents a comment on a commit or issue"
4109 type: "object"
4110 properties:
4111 body:
4112 type: "string"
4113 x-go-name: "Body"
4114 created_at:
4115 type: "string"
4116 format: "date-time"
4117 x-go-name: "Created"
4118 html_url:
4119 type: "string"
4120 x-go-name: "HTMLURL"
4121 id:
4122 type: "integer"
4123 format: "int64"
4124 x-go-name: "ID"
4125 issue_url:
4126 type: "string"
4127 x-go-name: "IssueURL"
4128 pull_request_url:
4129 type: "string"
4130 x-go-name: "PRURL"
4131 updated_at:
4132 type: "string"
4133 format: "date-time"
4134 x-go-name: "Updated"
4135 user:
4136 $ref: "#/definitions/User"
4137 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4138 CreateEmailOption:
4139 description: "CreateEmailOption options when creating email addresses"
4140 type: "object"
4141 properties:
4142 emails:
4143 description: "email addresses to add"
4144 type: "array"
4145 items:
4146 type: "string"
4147 x-go-name: "Emails"
4148 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4149 CreateForkOption:
4150 description: "CreateForkOption options for creating a fork"
4151 type: "object"
4152 properties:
4153 organization:
4154 description: "organization name, if forking into an organization"
4155 type: "string"
4156 x-go-name: "Organization"
4157 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4158 CreateGPGKeyOption:
4159 description: "CreateGPGKeyOption options create user GPG key"
4160 type: "object"
4161 required:
4162 - "armored_public_key"
4163 properties:
4164 armored_public_key:
4165 description: "An armored GPG key to add"
4166 type: "string"
4167 uniqueItems: true
4168 x-go-name: "ArmoredKey"
4169 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4170 CreateHookOption:
4171 description: "CreateHookOption options when create a hook"
4172 type: "object"
4173 required:
4174 - "type"
4175 - "config"
4176 properties:
4177 active:
4178 type: "boolean"
4179 default: false
4180 x-go-name: "Active"
4181 config:
4182 type: "object"
4183 additionalProperties:
4184 type: "string"
4185 x-go-name: "Config"
4186 events:
4187 type: "array"
4188 items:
4189 type: "string"
4190 x-go-name: "Events"
4191 type:
4192 type: "string"
4193 enum:
4194 - "gitea"
4195 - "gogs"
4196 - "slack"
4197 - "discord"
4198 x-go-name: "Type"
4199 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4200 CreateIssueCommentOption:
4201 description: "CreateIssueCommentOption options for creating a comment on an issue"
4202 type: "object"
4203 required:
4204 - "body"
4205 properties:
4206 body:
4207 type: "string"
4208 x-go-name: "Body"
4209 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4210 CreateIssueOption:
4211 description: "CreateIssueOption options to create one issue"
4212 type: "object"
4213 required:
4214 - "title"
4215 properties:
4216 assignee:
4217 description: "username of assignee"
4218 type: "string"
4219 x-go-name: "Assignee"
4220 assignees:
4221 type: "array"
4222 items:
4223 type: "string"
4224 x-go-name: "Assignees"
4225 body:
4226 type: "string"
4227 x-go-name: "Body"
4228 closed:
4229 type: "boolean"
4230 x-go-name: "Closed"
4231 due_date:
4232 type: "string"
4233 format: "date-time"
4234 x-go-name: "Deadline"
4235 labels:
4236 description: "list of label ids"
4237 type: "array"
4238 items:
4239 type: "integer"
4240 format: "int64"
4241 x-go-name: "Labels"
4242 milestone:
4243 description: "milestone id"
4244 type: "integer"
4245 format: "int64"
4246 x-go-name: "Milestone"
4247 title:
4248 type: "string"
4249 x-go-name: "Title"
4250 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4251 CreateKeyOption:
4252 description: "CreateKeyOption options when creating a key"
4253 type: "object"
4254 required:
4255 - "title"
4256 - "key"
4257 properties:
4258 key:
4259 description: "An armored SSH key to add"
4260 type: "string"
4261 uniqueItems: true
4262 x-go-name: "Key"
4263 read_only:
4264 description: "Describe if the key has only read access or read/write"
4265 type: "boolean"
4266 x-go-name: "ReadOnly"
4267 title:
4268 description: "Title of the key to add"
4269 type: "string"
4270 uniqueItems: true
4271 x-go-name: "Title"
4272 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4273 CreateLabelOption:
4274 description: "CreateLabelOption options for creating a label"
4275 type: "object"
4276 required:
4277 - "name"
4278 - "color"
4279 properties:
4280 color:
4281 type: "string"
4282 x-go-name: "Color"
4283 example: "#00aabb"
4284 name:
4285 type: "string"
4286 x-go-name: "Name"
4287 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4288 CreateMilestoneOption:
4289 description: "CreateMilestoneOption options for creating a milestone"
4290 type: "object"
4291 properties:
4292 description:
4293 type: "string"
4294 x-go-name: "Description"
4295 due_on:
4296 type: "string"
4297 format: "date-time"
4298 x-go-name: "Deadline"
4299 title:
4300 type: "string"
4301 x-go-name: "Title"
4302 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4303 CreateOrgOption:
4304 description: "CreateOrgOption options for creating an organization"
4305 type: "object"
4306 required:
4307 - "username"
4308 properties:
4309 description:
4310 type: "string"
4311 x-go-name: "Description"
4312 full_name:
4313 type: "string"
4314 x-go-name: "FullName"
4315 location:
4316 type: "string"
4317 x-go-name: "Location"
4318 username:
4319 type: "string"
4320 x-go-name: "UserName"
4321 website:
4322 type: "string"
4323 x-go-name: "Website"
4324 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4325 CreatePullRequestOption:
4326 description: "CreatePullRequestOption options when creating a pull request"
4327 type: "object"
4328 properties:
4329 assignee:
4330 type: "string"
4331 x-go-name: "Assignee"
4332 assignees:
4333 type: "array"
4334 items:
4335 type: "string"
4336 x-go-name: "Assignees"
4337 base:
4338 type: "string"
4339 x-go-name: "Base"
4340 body:
4341 type: "string"
4342 x-go-name: "Body"
4343 due_date:
4344 type: "string"
4345 format: "date-time"
4346 x-go-name: "Deadline"
4347 head:
4348 type: "string"
4349 x-go-name: "Head"
4350 labels:
4351 type: "array"
4352 items:
4353 type: "integer"
4354 format: "int64"
4355 x-go-name: "Labels"
4356 milestone:
4357 type: "integer"
4358 format: "int64"
4359 x-go-name: "Milestone"
4360 title:
4361 type: "string"
4362 x-go-name: "Title"
4363 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4364 CreateReleaseOption:
4365 description: "CreateReleaseOption options when creating a release"
4366 type: "object"
4367 required:
4368 - "tag_name"
4369 properties:
4370 body:
4371 type: "string"
4372 x-go-name: "Note"
4373 draft:
4374 type: "boolean"
4375 x-go-name: "IsDraft"
4376 name:
4377 type: "string"
4378 x-go-name: "Title"
4379 prerelease:
4380 type: "boolean"
4381 x-go-name: "IsPrerelease"
4382 tag_name:
4383 type: "string"
4384 x-go-name: "TagName"
4385 target_commitish:
4386 type: "string"
4387 x-go-name: "Target"
4388 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4389 CreateRepoOption:
4390 description: "CreateRepoOption options when creating repository"
4391 type: "object"
4392 required:
4393 - "name"
4394 properties:
4395 auto_init:
4396 description: "Whether the repository should be auto-intialized?"
4397 type: "boolean"
4398 x-go-name: "AutoInit"
4399 description:
4400 description: "Description of the repository to create"
4401 type: "string"
4402 x-go-name: "Description"
4403 gitignores:
4404 description: "Gitignores to use"
4405 type: "string"
4406 x-go-name: "Gitignores"
4407 license:
4408 description: "License to use"
4409 type: "string"
4410 x-go-name: "License"
4411 name:
4412 description: "Name of the repository to create"
4413 type: "string"
4414 uniqueItems: true
4415 x-go-name: "Name"
4416 private:
4417 description: "Whether the repository is private"
4418 type: "boolean"
4419 x-go-name: "Private"
4420 readme:
4421 description: "Readme of the repository to create"
4422 type: "string"
4423 x-go-name: "Readme"
4424 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4425 CreateStatusOption:
4426 description: "CreateStatusOption holds the information needed to create a new Status for a Commit"
4427 type: "object"
4428 properties:
4429 context:
4430 type: "string"
4431 x-go-name: "Context"
4432 description:
4433 type: "string"
4434 x-go-name: "Description"
4435 state:
4436 $ref: "#/definitions/StatusState"
4437 target_url:
4438 type: "string"
4439 x-go-name: "TargetURL"
4440 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4441 CreateTeamOption:
4442 description: "CreateTeamOption options for creating a team"
4443 type: "object"
4444 required:
4445 - "name"
4446 properties:
4447 description:
4448 type: "string"
4449 x-go-name: "Description"
4450 name:
4451 type: "string"
4452 x-go-name: "Name"
4453 permission:
4454 type: "string"
4455 enum:
4456 - "read"
4457 - "write"
4458 - "admin"
4459 x-go-name: "Permission"
4460 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4461 CreateUserOption:
4462 description: "CreateUserOption create user options"
4463 type: "object"
4464 required:
4465 - "username"
4466 - "email"
4467 - "password"
4468 properties:
4469 email:
4470 type: "string"
4471 format: "email"
4472 x-go-name: "Email"
4473 full_name:
4474 type: "string"
4475 x-go-name: "FullName"
4476 login_name:
4477 type: "string"
4478 x-go-name: "LoginName"
4479 password:
4480 type: "string"
4481 x-go-name: "Password"
4482 send_notify:
4483 type: "boolean"
4484 x-go-name: "SendNotify"
4485 source_id:
4486 type: "integer"
4487 format: "int64"
4488 x-go-name: "SourceID"
4489 username:
4490 type: "string"
4491 x-go-name: "Username"
4492 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4493 DeleteEmailOption:
4494 description: "DeleteEmailOption options when deleting email addresses"
4495 type: "object"
4496 properties:
4497 emails:
4498 description: "email addresses to delete"
4499 type: "array"
4500 items:
4501 type: "string"
4502 x-go-name: "Emails"
4503 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4504 DeployKey:
4505 description: "DeployKey a deploy key"
4506 type: "object"
4507 properties:
4508 created_at:
4509 type: "string"
4510 format: "date-time"
4511 x-go-name: "Created"
4512 id:
4513 type: "integer"
4514 format: "int64"
4515 x-go-name: "ID"
4516 key:
4517 type: "string"
4518 x-go-name: "Key"
4519 read_only:
4520 type: "boolean"
4521 x-go-name: "ReadOnly"
4522 title:
4523 type: "string"
4524 x-go-name: "Title"
4525 url:
4526 type: "string"
4527 x-go-name: "URL"
4528 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4529 EditAttachmentOptions:
4530 description: "EditAttachmentOptions options for editing attachments"
4531 type: "object"
4532 properties:
4533 name:
4534 type: "string"
4535 x-go-name: "Name"
4536 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4537 EditDeadlineOption:
4538 description: "EditDeadlineOption options for creating a deadline"
4539 type: "object"
4540 required:
4541 - "due_date"
4542 properties:
4543 due_date:
4544 type: "string"
4545 format: "date-time"
4546 x-go-name: "Deadline"
4547 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4548 EditHookOption:
4549 description: "EditHookOption options when modify one hook"
4550 type: "object"
4551 properties:
4552 active:
4553 type: "boolean"
4554 x-go-name: "Active"
4555 config:
4556 type: "object"
4557 additionalProperties:
4558 type: "string"
4559 x-go-name: "Config"
4560 events:
4561 type: "array"
4562 items:
4563 type: "string"
4564 x-go-name: "Events"
4565 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4566 EditIssueCommentOption:
4567 description: "EditIssueCommentOption options for editing a comment"
4568 type: "object"
4569 required:
4570 - "body"
4571 properties:
4572 body:
4573 type: "string"
4574 x-go-name: "Body"
4575 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4576 EditIssueOption:
4577 description: "EditIssueOption options for editing an issue"
4578 type: "object"
4579 properties:
4580 assignee:
4581 type: "string"
4582 x-go-name: "Assignee"
4583 assignees:
4584 type: "array"
4585 items:
4586 type: "string"
4587 x-go-name: "Assignees"
4588 body:
4589 type: "string"
4590 x-go-name: "Body"
4591 due_date:
4592 type: "string"
4593 format: "date-time"
4594 x-go-name: "Deadline"
4595 milestone:
4596 type: "integer"
4597 format: "int64"
4598 x-go-name: "Milestone"
4599 state:
4600 type: "string"
4601 x-go-name: "State"
4602 title:
4603 type: "string"
4604 x-go-name: "Title"
4605 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4606 EditLabelOption:
4607 description: "EditLabelOption options for editing a label"
4608 type: "object"
4609 properties:
4610 color:
4611 type: "string"
4612 x-go-name: "Color"
4613 name:
4614 type: "string"
4615 x-go-name: "Name"
4616 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4617 EditMilestoneOption:
4618 description: "EditMilestoneOption options for editing a milestone"
4619 type: "object"
4620 properties:
4621 description:
4622 type: "string"
4623 x-go-name: "Description"
4624 due_on:
4625 type: "string"
4626 format: "date-time"
4627 x-go-name: "Deadline"
4628 state:
4629 type: "string"
4630 x-go-name: "State"
4631 title:
4632 type: "string"
4633 x-go-name: "Title"
4634 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4635 EditOrgOption:
4636 description: "EditOrgOption options for editing an organization"
4637 type: "object"
4638 properties:
4639 description:
4640 type: "string"
4641 x-go-name: "Description"
4642 full_name:
4643 type: "string"
4644 x-go-name: "FullName"
4645 location:
4646 type: "string"
4647 x-go-name: "Location"
4648 website:
4649 type: "string"
4650 x-go-name: "Website"
4651 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4652 EditPullRequestOption:
4653 description: "EditPullRequestOption options when modify pull request"
4654 type: "object"
4655 properties:
4656 assignee:
4657 type: "string"
4658 x-go-name: "Assignee"
4659 assignees:
4660 type: "array"
4661 items:
4662 type: "string"
4663 x-go-name: "Assignees"
4664 body:
4665 type: "string"
4666 x-go-name: "Body"
4667 due_date:
4668 type: "string"
4669 format: "date-time"
4670 x-go-name: "Deadline"
4671 labels:
4672 type: "array"
4673 items:
4674 type: "integer"
4675 format: "int64"
4676 x-go-name: "Labels"
4677 milestone:
4678 type: "integer"
4679 format: "int64"
4680 x-go-name: "Milestone"
4681 state:
4682 type: "string"
4683 x-go-name: "State"
4684 title:
4685 type: "string"
4686 x-go-name: "Title"
4687 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4688 EditReleaseOption:
4689 description: "EditReleaseOption options when editing a release"
4690 type: "object"
4691 properties:
4692 body:
4693 type: "string"
4694 x-go-name: "Note"
4695 draft:
4696 type: "boolean"
4697 x-go-name: "IsDraft"
4698 name:
4699 type: "string"
4700 x-go-name: "Title"
4701 prerelease:
4702 type: "boolean"
4703 x-go-name: "IsPrerelease"
4704 tag_name:
4705 type: "string"
4706 x-go-name: "TagName"
4707 target_commitish:
4708 type: "string"
4709 x-go-name: "Target"
4710 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4711 EditTeamOption:
4712 description: "EditTeamOption options for editing a team"
4713 type: "object"
4714 required:
4715 - "name"
4716 properties:
4717 description:
4718 type: "string"
4719 x-go-name: "Description"
4720 name:
4721 type: "string"
4722 x-go-name: "Name"
4723 permission:
4724 type: "string"
4725 enum:
4726 - "read"
4727 - "write"
4728 - "admin"
4729 x-go-name: "Permission"
4730 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4731 EditUserOption:
4732 description: "EditUserOption edit user options"
4733 type: "object"
4734 required:
4735 - "email"
4736 properties:
4737 active:
4738 type: "boolean"
4739 x-go-name: "Active"
4740 admin:
4741 type: "boolean"
4742 x-go-name: "Admin"
4743 allow_git_hook:
4744 type: "boolean"
4745 x-go-name: "AllowGitHook"
4746 allow_import_local:
4747 type: "boolean"
4748 x-go-name: "AllowImportLocal"
4749 email:
4750 type: "string"
4751 format: "email"
4752 x-go-name: "Email"
4753 full_name:
4754 type: "string"
4755 x-go-name: "FullName"
4756 location:
4757 type: "string"
4758 x-go-name: "Location"
4759 login_name:
4760 type: "string"
4761 x-go-name: "LoginName"
4762 max_repo_creation:
4763 type: "integer"
4764 format: "int64"
4765 x-go-name: "MaxRepoCreation"
4766 password:
4767 type: "string"
4768 x-go-name: "Password"
4769 source_id:
4770 type: "integer"
4771 format: "int64"
4772 x-go-name: "SourceID"
4773 website:
4774 type: "string"
4775 x-go-name: "Website"
4776 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4777 Email:
4778 description: "Email an email address belonging to a user"
4779 type: "object"
4780 properties:
4781 email:
4782 type: "string"
4783 format: "email"
4784 x-go-name: "Email"
4785 primary:
4786 type: "boolean"
4787 x-go-name: "Primary"
4788 verified:
4789 type: "boolean"
4790 x-go-name: "Verified"
4791 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4792 GPGKey:
4793 description: "GPGKey a user GPG key to sign commit and tag in repository"
4794 type: "object"
4795 properties:
4796 can_certify:
4797 type: "boolean"
4798 x-go-name: "CanCertify"
4799 can_encrypt_comms:
4800 type: "boolean"
4801 x-go-name: "CanEncryptComms"
4802 can_encrypt_storage:
4803 type: "boolean"
4804 x-go-name: "CanEncryptStorage"
4805 can_sign:
4806 type: "boolean"
4807 x-go-name: "CanSign"
4808 created_at:
4809 type: "string"
4810 format: "date-time"
4811 x-go-name: "Created"
4812 emails:
4813 type: "array"
4814 items:
4815 $ref: "#/definitions/GPGKeyEmail"
4816 x-go-name: "Emails"
4817 expires_at:
4818 type: "string"
4819 format: "date-time"
4820 x-go-name: "Expires"
4821 id:
4822 type: "integer"
4823 format: "int64"
4824 x-go-name: "ID"
4825 key_id:
4826 type: "string"
4827 x-go-name: "KeyID"
4828 primary_key_id:
4829 type: "string"
4830 x-go-name: "PrimaryKeyID"
4831 public_key:
4832 type: "string"
4833 x-go-name: "PublicKey"
4834 subkeys:
4835 type: "array"
4836 items:
4837 $ref: "#/definitions/GPGKey"
4838 x-go-name: "SubsKey"
4839 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4840 GPGKeyEmail:
4841 description: "GPGKeyEmail an email attached to a GPGKey"
4842 type: "object"
4843 properties:
4844 email:
4845 type: "string"
4846 x-go-name: "Email"
4847 verified:
4848 type: "boolean"
4849 x-go-name: "Verified"
4850 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4851 Issue:
4852 description: "Issue represents an issue in a repository"
4853 type: "object"
4854 properties:
4855 assignee:
4856 $ref: "#/definitions/User"
4857 assignees:
4858 type: "array"
4859 items:
4860 $ref: "#/definitions/User"
4861 x-go-name: "Assignees"
4862 body:
4863 type: "string"
4864 x-go-name: "Body"
4865 closed_at:
4866 type: "string"
4867 format: "date-time"
4868 x-go-name: "Closed"
4869 comments:
4870 type: "integer"
4871 format: "int64"
4872 x-go-name: "Comments"
4873 created_at:
4874 type: "string"
4875 format: "date-time"
4876 x-go-name: "Created"
4877 due_date:
4878 type: "string"
4879 format: "date-time"
4880 x-go-name: "Deadline"
4881 id:
4882 type: "integer"
4883 format: "int64"
4884 x-go-name: "ID"
4885 labels:
4886 type: "array"
4887 items:
4888 $ref: "#/definitions/Label"
4889 x-go-name: "Labels"
4890 milestone:
4891 $ref: "#/definitions/Milestone"
4892 number:
4893 type: "integer"
4894 format: "int64"
4895 x-go-name: "Index"
4896 pull_request:
4897 $ref: "#/definitions/PullRequestMeta"
4898 state:
4899 $ref: "#/definitions/StateType"
4900 title:
4901 type: "string"
4902 x-go-name: "Title"
4903 updated_at:
4904 type: "string"
4905 format: "date-time"
4906 x-go-name: "Updated"
4907 url:
4908 type: "string"
4909 x-go-name: "URL"
4910 user:
4911 $ref: "#/definitions/User"
4912 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4913 IssueDeadline:
4914 description: "IssueDeadline represents an issue deadline"
4915 type: "object"
4916 properties:
4917 due_date:
4918 type: "string"
4919 format: "date-time"
4920 x-go-name: "Deadline"
4921 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4922 IssueLabelsOption:
4923 description: "IssueLabelsOption a collection of labels"
4924 type: "object"
4925 properties:
4926 labels:
4927 description: "list of label IDs"
4928 type: "array"
4929 items:
4930 type: "integer"
4931 format: "int64"
4932 x-go-name: "Labels"
4933 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4934 Label:
4935 description: "Label a label to an issue or a pr"
4936 type: "object"
4937 properties:
4938 color:
4939 type: "string"
4940 x-go-name: "Color"
4941 example: "00aabb"
4942 id:
4943 type: "integer"
4944 format: "int64"
4945 x-go-name: "ID"
4946 name:
4947 type: "string"
4948 x-go-name: "Name"
4949 url:
4950 type: "string"
4951 x-go-name: "URL"
4952 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4953 MarkdownOption:
4954 description: "MarkdownOption markdown options"
4955 type: "object"
4956 properties:
4957 Context:
4958 description: "Context to render\n\nin: body"
4959 type: "string"
4960 Mode:
4961 description: "Mode to render\n\nin: body"
4962 type: "string"
4963 Text:
4964 description: "Text markdown to render\n\nin: body"
4965 type: "string"
4966 Wiki:
4967 description: "Is it a wiki page ?\n\nin: body"
4968 type: "boolean"
4969 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
4970 MigrateRepoForm:
4971 description: "MigrateRepoForm form for migrating repository"
4972 type: "object"
4973 required:
4974 - "clone_addr"
4975 - "uid"
4976 - "repo_name"
4977 properties:
4978 auth_password:
4979 type: "string"
4980 x-go-name: "AuthPassword"
4981 auth_username:
4982 type: "string"
4983 x-go-name: "AuthUsername"
4984 clone_addr:
4985 type: "string"
4986 x-go-name: "CloneAddr"
4987 description:
4988 type: "string"
4989 x-go-name: "Description"
4990 mirror:
4991 type: "boolean"
4992 x-go-name: "Mirror"
4993 private:
4994 type: "boolean"
4995 x-go-name: "Private"
4996 repo_name:
4997 type: "string"
4998 x-go-name: "RepoName"
4999 uid:
5000 type: "integer"
5001 format: "int64"
5002 x-go-name: "UID"
5003 x-go-package: "code.gitea.io/gitea/modules/auth"
5004 Milestone:
5005 description: "Milestone milestone is a collection of issues on one repository"
5006 type: "object"
5007 properties:
5008 closed_at:
5009 type: "string"
5010 format: "date-time"
5011 x-go-name: "Closed"
5012 closed_issues:
5013 type: "integer"
5014 format: "int64"
5015 x-go-name: "ClosedIssues"
5016 description:
5017 type: "string"
5018 x-go-name: "Description"
5019 due_on:
5020 type: "string"
5021 format: "date-time"
5022 x-go-name: "Deadline"
5023 id:
5024 type: "integer"
5025 format: "int64"
5026 x-go-name: "ID"
5027 open_issues:
5028 type: "integer"
5029 format: "int64"
5030 x-go-name: "OpenIssues"
5031 state:
5032 $ref: "#/definitions/StateType"
5033 title:
5034 type: "string"
5035 x-go-name: "Title"
5036 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5037 Organization:
5038 description: "Organization represents an organization"
5039 type: "object"
5040 properties:
5041 avatar_url:
5042 type: "string"
5043 x-go-name: "AvatarURL"
5044 description:
5045 type: "string"
5046 x-go-name: "Description"
5047 full_name:
5048 type: "string"
5049 x-go-name: "FullName"
5050 id:
5051 type: "integer"
5052 format: "int64"
5053 x-go-name: "ID"
5054 location:
5055 type: "string"
5056 x-go-name: "Location"
5057 username:
5058 type: "string"
5059 x-go-name: "UserName"
5060 website:
5061 type: "string"
5062 x-go-name: "Website"
5063 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5064 PRBranchInfo:
5065 description: "PRBranchInfo information about a branch"
5066 type: "object"
5067 properties:
5068 label:
5069 type: "string"
5070 x-go-name: "Name"
5071 ref:
5072 type: "string"
5073 x-go-name: "Ref"
5074 repo:
5075 $ref: "#/definitions/Repository"
5076 repo_id:
5077 type: "integer"
5078 format: "int64"
5079 x-go-name: "RepoID"
5080 sha:
5081 type: "string"
5082 x-go-name: "Sha"
5083 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5084 PayloadCommit:
5085 description: "PayloadCommit represents a commit"
5086 type: "object"
5087 properties:
5088 author:
5089 $ref: "#/definitions/PayloadUser"
5090 committer:
5091 $ref: "#/definitions/PayloadUser"
5092 id:
5093 description: "sha1 hash of the commit"
5094 type: "string"
5095 x-go-name: "ID"
5096 message:
5097 type: "string"
5098 x-go-name: "Message"
5099 timestamp:
5100 type: "string"
5101 format: "date-time"
5102 x-go-name: "Timestamp"
5103 url:
5104 type: "string"
5105 x-go-name: "URL"
5106 verification:
5107 $ref: "#/definitions/PayloadCommitVerification"
5108 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5109 PayloadCommitVerification:
5110 description: "PayloadCommitVerification represents the GPG verification of a commit"
5111 type: "object"
5112 properties:
5113 payload:
5114 type: "string"
5115 x-go-name: "Payload"
5116 reason:
5117 type: "string"
5118 x-go-name: "Reason"
5119 signature:
5120 type: "string"
5121 x-go-name: "Signature"
5122 verified:
5123 type: "boolean"
5124 x-go-name: "Verified"
5125 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5126 PayloadUser:
5127 description: "PayloadUser represents the author or committer of a commit"
5128 type: "object"
5129 properties:
5130 email:
5131 type: "string"
5132 format: "email"
5133 x-go-name: "Email"
5134 name:
5135 description: "Full name of the commit author"
5136 type: "string"
5137 x-go-name: "Name"
5138 username:
5139 type: "string"
5140 x-go-name: "UserName"
5141 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5142 Permission:
5143 description: "Permission represents a set of permissions"
5144 type: "object"
5145 properties:
5146 admin:
5147 type: "boolean"
5148 x-go-name: "Admin"
5149 pull:
5150 type: "boolean"
5151 x-go-name: "Pull"
5152 push:
5153 type: "boolean"
5154 x-go-name: "Push"
5155 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5156 PublicKey:
5157 description: "PublicKey publickey is a user key to push code to repository"
5158 type: "object"
5159 properties:
5160 created_at:
5161 type: "string"
5162 format: "date-time"
5163 x-go-name: "Created"
5164 fingerprint:
5165 type: "string"
5166 x-go-name: "Fingerprint"
5167 id:
5168 type: "integer"
5169 format: "int64"
5170 x-go-name: "ID"
5171 key:
5172 type: "string"
5173 x-go-name: "Key"
5174 title:
5175 type: "string"
5176 x-go-name: "Title"
5177 url:
5178 type: "string"
5179 x-go-name: "URL"
5180 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5181 PullRequest:
5182 description: "PullRequest represents a pull request"
5183 type: "object"
5184 properties:
5185 assignee:
5186 $ref: "#/definitions/User"
5187 assignees:
5188 type: "array"
5189 items:
5190 $ref: "#/definitions/User"
5191 x-go-name: "Assignees"
5192 base:
5193 $ref: "#/definitions/PRBranchInfo"
5194 body:
5195 type: "string"
5196 x-go-name: "Body"
5197 closed_at:
5198 type: "string"
5199 format: "date-time"
5200 x-go-name: "Closed"
5201 comments:
5202 type: "integer"
5203 format: "int64"
5204 x-go-name: "Comments"
5205 created_at:
5206 type: "string"
5207 format: "date-time"
5208 x-go-name: "Created"
5209 diff_url:
5210 type: "string"
5211 x-go-name: "DiffURL"
5212 due_date:
5213 type: "string"
5214 format: "date-time"
5215 x-go-name: "Deadline"
5216 head:
5217 $ref: "#/definitions/PRBranchInfo"
5218 html_url:
5219 type: "string"
5220 x-go-name: "HTMLURL"
5221 id:
5222 type: "integer"
5223 format: "int64"
5224 x-go-name: "ID"
5225 labels:
5226 type: "array"
5227 items:
5228 $ref: "#/definitions/Label"
5229 x-go-name: "Labels"
5230 merge_base:
5231 type: "string"
5232 x-go-name: "MergeBase"
5233 merge_commit_sha:
5234 type: "string"
5235 x-go-name: "MergedCommitID"
5236 mergeable:
5237 type: "boolean"
5238 x-go-name: "Mergeable"
5239 merged:
5240 type: "boolean"
5241 x-go-name: "HasMerged"
5242 merged_at:
5243 type: "string"
5244 format: "date-time"
5245 x-go-name: "Merged"
5246 merged_by:
5247 $ref: "#/definitions/User"
5248 milestone:
5249 $ref: "#/definitions/Milestone"
5250 number:
5251 type: "integer"
5252 format: "int64"
5253 x-go-name: "Index"
5254 patch_url:
5255 type: "string"
5256 x-go-name: "PatchURL"
5257 state:
5258 $ref: "#/definitions/StateType"
5259 title:
5260 type: "string"
5261 x-go-name: "Title"
5262 updated_at:
5263 type: "string"
5264 format: "date-time"
5265 x-go-name: "Updated"
5266 url:
5267 type: "string"
5268 x-go-name: "URL"
5269 user:
5270 $ref: "#/definitions/User"
5271 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5272 PullRequestMeta:
5273 description: "PullRequestMeta PR info if an issue is a PR"
5274 type: "object"
5275 properties:
5276 merged:
5277 type: "boolean"
5278 x-go-name: "HasMerged"
5279 merged_at:
5280 type: "string"
5281 format: "date-time"
5282 x-go-name: "Merged"
5283 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5284 Release:
5285 description: "Release represents a repository release"
5286 type: "object"
5287 properties:
5288 assets:
5289 type: "array"
5290 items:
5291 $ref: "#/definitions/Attachment"
5292 x-go-name: "Attachments"
5293 author:
5294 $ref: "#/definitions/User"
5295 body:
5296 type: "string"
5297 x-go-name: "Note"
5298 created_at:
5299 type: "string"
5300 format: "date-time"
5301 x-go-name: "CreatedAt"
5302 draft:
5303 type: "boolean"
5304 x-go-name: "IsDraft"
5305 id:
5306 type: "integer"
5307 format: "int64"
5308 x-go-name: "ID"
5309 name:
5310 type: "string"
5311 x-go-name: "Title"
5312 prerelease:
5313 type: "boolean"
5314 x-go-name: "IsPrerelease"
5315 published_at:
5316 type: "string"
5317 format: "date-time"
5318 x-go-name: "PublishedAt"
5319 tag_name:
5320 type: "string"
5321 x-go-name: "TagName"
5322 tarball_url:
5323 type: "string"
5324 x-go-name: "TarURL"
5325 target_commitish:
5326 type: "string"
5327 x-go-name: "Target"
5328 url:
5329 type: "string"
5330 x-go-name: "URL"
5331 zipball_url:
5332 type: "string"
5333 x-go-name: "ZipURL"
5334 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5335 Repository:
5336 description: "Repository represents a repository"
5337 type: "object"
5338 properties:
5339 clone_url:
5340 type: "string"
5341 x-go-name: "CloneURL"
5342 created_at:
5343 type: "string"
5344 format: "date-time"
5345 x-go-name: "Created"
5346 default_branch:
5347 type: "string"
5348 x-go-name: "DefaultBranch"
5349 description:
5350 type: "string"
5351 x-go-name: "Description"
5352 empty:
5353 type: "boolean"
5354 x-go-name: "Empty"
5355 fork:
5356 type: "boolean"
5357 x-go-name: "Fork"
5358 forks_count:
5359 type: "integer"
5360 format: "int64"
5361 x-go-name: "Forks"
5362 full_name:
5363 type: "string"
5364 x-go-name: "FullName"
5365 html_url:
5366 type: "string"
5367 x-go-name: "HTMLURL"
5368 id:
5369 type: "integer"
5370 format: "int64"
5371 x-go-name: "ID"
5372 mirror:
5373 type: "boolean"
5374 x-go-name: "Mirror"
5375 name:
5376 type: "string"
5377 x-go-name: "Name"
5378 open_issues_count:
5379 type: "integer"
5380 format: "int64"
5381 x-go-name: "OpenIssues"
5382 owner:
5383 $ref: "#/definitions/User"
5384 parent:
5385 $ref: "#/definitions/Repository"
5386 permissions:
5387 $ref: "#/definitions/Permission"
5388 private:
5389 type: "boolean"
5390 x-go-name: "Private"
5391 size:
5392 type: "integer"
5393 format: "int64"
5394 x-go-name: "Size"
5395 ssh_url:
5396 type: "string"
5397 x-go-name: "SSHURL"
5398 stars_count:
5399 type: "integer"
5400 format: "int64"
5401 x-go-name: "Stars"
5402 updated_at:
5403 type: "string"
5404 format: "date-time"
5405 x-go-name: "Updated"
5406 watchers_count:
5407 type: "integer"
5408 format: "int64"
5409 x-go-name: "Watchers"
5410 website:
5411 type: "string"
5412 x-go-name: "Website"
5413 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5414 SearchResults:
5415 description: "SearchResults results of a successful search"
5416 type: "object"
5417 properties:
5418 data:
5419 type: "array"
5420 items:
5421 $ref: "#/definitions/Repository"
5422 x-go-name: "Data"
5423 ok:
5424 type: "boolean"
5425 x-go-name: "OK"
5426 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5427 ServerVersion:
5428 description: "ServerVersion wraps the version of the server"
5429 type: "object"
5430 properties:
5431 version:
5432 type: "string"
5433 x-go-name: "Version"
5434 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5435 StateType:
5436 description: "StateType issue state type"
5437 type: "string"
5438 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5439 Status:
5440 description: "Status holds a single Status of a single Commit"
5441 type: "object"
5442 properties:
5443 context:
5444 type: "string"
5445 x-go-name: "Context"
5446 created_at:
5447 type: "string"
5448 format: "date-time"
5449 x-go-name: "Created"
5450 creator:
5451 $ref: "#/definitions/User"
5452 description:
5453 type: "string"
5454 x-go-name: "Description"
5455 id:
5456 type: "integer"
5457 format: "int64"
5458 x-go-name: "ID"
5459 status:
5460 $ref: "#/definitions/StatusState"
5461 target_url:
5462 type: "string"
5463 x-go-name: "TargetURL"
5464 updated_at:
5465 type: "string"
5466 format: "date-time"
5467 x-go-name: "Updated"
5468 url:
5469 type: "string"
5470 x-go-name: "URL"
5471 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5472 StatusState:
5473 description: "StatusState holds the state of a Status\nIt can be \"pending\", \"success\", \"error\", \"failure\", and \"warning\""
5474 type: "string"
5475 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5476 Team:
5477 description: "Team represents a team in an organization"
5478 type: "object"
5479 properties:
5480 description:
5481 type: "string"
5482 x-go-name: "Description"
5483 id:
5484 type: "integer"
5485 format: "int64"
5486 x-go-name: "ID"
5487 name:
5488 type: "string"
5489 x-go-name: "Name"
5490 permission:
5491 type: "string"
5492 enum:
5493 - "none"
5494 - "read"
5495 - "write"
5496 - "admin"
5497 - "owner"
5498 x-go-name: "Permission"
5499 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5500 TrackedTime:
5501 description: "TrackedTime worked time for an issue / pr"
5502 type: "object"
5503 properties:
5504 created:
5505 type: "string"
5506 format: "date-time"
5507 x-go-name: "Created"
5508 id:
5509 type: "integer"
5510 format: "int64"
5511 x-go-name: "ID"
5512 issue_id:
5513 type: "integer"
5514 format: "int64"
5515 x-go-name: "IssueID"
5516 time:
5517 description: "Time in seconds"
5518 type: "integer"
5519 format: "int64"
5520 x-go-name: "Time"
5521 user_id:
5522 type: "integer"
5523 format: "int64"
5524 x-go-name: "UserID"
5525 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5526 User:
5527 description: "User represents a user"
5528 type: "object"
5529 properties:
5530 avatar_url:
5531 description: "URL to the user's avatar"
5532 type: "string"
5533 x-go-name: "AvatarURL"
5534 email:
5535 type: "string"
5536 format: "email"
5537 x-go-name: "Email"
5538 full_name:
5539 description: "the user's full name"
5540 type: "string"
5541 x-go-name: "FullName"
5542 id:
5543 description: "the user's id"
5544 type: "integer"
5545 format: "int64"
5546 x-go-name: "ID"
5547 language:
5548 description: "User locale"
5549 type: "string"
5550 x-go-name: "Language"
5551 login:
5552 description: "the user's username"
5553 type: "string"
5554 x-go-name: "UserName"
5555 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5556 WatchInfo:
5557 description: "WatchInfo represents an API watch status of one repository"
5558 type: "object"
5559 properties:
5560 created_at:
5561 type: "string"
5562 format: "date-time"
5563 x-go-name: "CreatedAt"
5564 ignored:
5565 type: "boolean"
5566 x-go-name: "Ignored"
5567 reason:
5568 type: "object"
5569 x-go-name: "Reason"
5570 repository_url:
5571 type: "string"
5572 x-go-name: "RepositoryURL"
5573 subscribed:
5574 type: "boolean"
5575 x-go-name: "Subscribed"
5576 url:
5577 type: "string"
5578 x-go-name: "URL"
5579 x-go-package: "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
5580 responses:
5581 AccessToken:
5582 description: "AccessToken represents a API access token."
5583 headers:
5584 id:
5585 type: "integer"
5586 format: "int64"
5587 name:
5588 type: "string"
5589 sha1:
5590 type: "string"
5591 AccessTokenList:
5592 description: "AccessTokenList represents a list of API access token."
5593 Attachment:
5594 description: "Attachment"
5595 schema:
5596 $ref: "#/definitions/Attachment"
5597 AttachmentList:
5598 description: "AttachmentList"
5599 schema:
5600 type: "array"
5601 items:
5602 $ref: "#/definitions/Attachment"
5603 Branch:
5604 description: "Branch"
5605 schema:
5606 $ref: "#/definitions/Branch"
5607 BranchList:
5608 description: "BranchList"
5609 schema:
5610 type: "array"
5611 items:
5612 $ref: "#/definitions/Branch"
5613 Comment:
5614 description: "Comment"
5615 schema:
5616 $ref: "#/definitions/Comment"
5617 CommentList:
5618 description: "CommentList"
5619 schema:
5620 type: "array"
5621 items:
5622 $ref: "#/definitions/Comment"
5623 DeployKey:
5624 description: "DeployKey"
5625 schema:
5626 $ref: "#/definitions/DeployKey"
5627 DeployKeyList:
5628 description: "DeployKeyList"
5629 schema:
5630 type: "array"
5631 items:
5632 $ref: "#/definitions/DeployKey"
5633 EmailList:
5634 description: "EmailList"
5635 schema:
5636 type: "array"
5637 items:
5638 $ref: "#/definitions/Email"
5639 GPGKey:
5640 description: "GPGKey"
5641 schema:
5642 $ref: "#/definitions/GPGKey"
5643 GPGKeyList:
5644 description: "GPGKeyList"
5645 schema:
5646 type: "array"
5647 items:
5648 $ref: "#/definitions/GPGKey"
5649 Hook:
5650 description: "Hook"
5651 schema:
5652 type: "array"
5653 items:
5654 $ref: "#/definitions/Branch"
5655 HookList:
5656 description: "HookList"
5657 schema:
5658 type: "array"
5659 items:
5660 $ref: "#/definitions/Branch"
5661 Issue:
5662 description: "Issue"
5663 schema:
5664 $ref: "#/definitions/Issue"
5665 IssueDeadline:
5666 description: "IssueDeadline"
5667 schema:
5668 $ref: "#/definitions/IssueDeadline"
5669 IssueList:
5670 description: "IssueList"
5671 schema:
5672 type: "array"
5673 items:
5674 $ref: "#/definitions/Issue"
5675 Label:
5676 description: "Label"
5677 schema:
5678 $ref: "#/definitions/Label"
5679 LabelList:
5680 description: "LabelList"
5681 schema:
5682 type: "array"
5683 items:
5684 $ref: "#/definitions/Label"
5685 MarkdownRender:
5686 description: "MarkdownRender is a rendered markdown document"
5687 Milestone:
5688 description: "Milestone"
5689 schema:
5690 $ref: "#/definitions/Milestone"
5691 MilestoneList:
5692 description: "MilestoneList"
5693 schema:
5694 type: "array"
5695 items:
5696 $ref: "#/definitions/Milestone"
5697 Organization:
5698 description: "Organization"
5699 schema:
5700 $ref: "#/definitions/Organization"
5701 OrganizationList:
5702 description: "OrganizationList"
5703 schema:
5704 type: "array"
5705 items:
5706 $ref: "#/definitions/Organization"
5707 PublicKey:
5708 description: "PublicKey"
5709 schema:
5710 $ref: "#/definitions/PublicKey"
5711 PublicKeyList:
5712 description: "PublicKeyList"
5713 schema:
5714 type: "array"
5715 items:
5716 $ref: "#/definitions/PublicKey"
5717 PullRequest:
5718 description: "PullRequest"
5719 schema:
5720 $ref: "#/definitions/PullRequest"
5721 PullRequestList:
5722 description: "PullRequestList"
5723 schema:
5724 type: "array"
5725 items:
5726 $ref: "#/definitions/PullRequest"
5727 Release:
5728 description: "Release"
5729 schema:
5730 $ref: "#/definitions/Release"
5731 ReleaseList:
5732 description: "ReleaseList"
5733 schema:
5734 type: "array"
5735 items:
5736 $ref: "#/definitions/Release"
5737 Repository:
5738 description: "Repository"
5739 schema:
5740 $ref: "#/definitions/Repository"
5741 RepositoryList:
5742 description: "RepositoryList"
5743 schema:
5744 type: "array"
5745 items:
5746 $ref: "#/definitions/Repository"
5747 SearchResults:
5748 description: "SearchResults"
5749 schema:
5750 $ref: "#/definitions/SearchResults"
5751 ServerVersion:
5752 description: "ServerVersion"
5753 schema:
5754 $ref: "#/definitions/ServerVersion"
5755 Status:
5756 description: "Status"
5757 schema:
5758 $ref: "#/definitions/Status"
5759 StatusList:
5760 description: "StatusList"
5761 schema:
5762 type: "array"
5763 items:
5764 $ref: "#/definitions/Status"
5765 Team:
5766 description: "Team"
5767 schema:
5768 $ref: "#/definitions/Team"
5769 TeamList:
5770 description: "TeamList"
5771 schema:
5772 type: "array"
5773 items:
5774 $ref: "#/definitions/Team"
5775 TrackedTime:
5776 description: "TrackedTime"
5777 schema:
5778 $ref: "#/definitions/TrackedTime"
5779 TrackedTimeList:
5780 description: "TrackedTimeList"
5781 schema:
5782 type: "array"
5783 items:
5784 $ref: "#/definitions/TrackedTime"
5785 User:
5786 description: "User"
5787 schema:
5788 $ref: "#/definitions/User"
5789 UserList:
5790 description: "UserList"
5791 schema:
5792 type: "array"
5793 items:
5794 $ref: "#/definitions/User"
5795 WatchInfo:
5796 description: "WatchInfo"
5797 schema:
5798 $ref: "#/definitions/WatchInfo"
5799 empty:
5800 description: "APIEmpty is an empty response"
5801 error:
5802 description: "APIError is error format response"
5803 headers:
5804 message:
5805 type: "string"
5806 url:
5807 type: "string"
5808 forbidden:
5809 description: "APIForbiddenError is a forbidden error response"
5810 headers:
5811 message:
5812 type: "string"
5813 url:
5814 type: "string"
5815 notFound:
5816 description: "APINotFound is a not found empty response"
5817 parameterBodies:
5818 description: "parameterBodies"
5819 schema:
5820 $ref: "#/definitions/EditAttachmentOptions"
5821 redirect:
5822 description: "APIRedirect is a redirect response"
5823 validationError:
5824 description: "APIValidationError is error format response related to input validation"
5825 headers:
5826 message:
5827 type: "string"
5828 url:
5829 type: "string"
5830 securityDefinitions:
5831 AccessToken:
5832 type: "apiKey"
5833 name: "access_token"
5834 in: "query"
5835 AuthorizationHeaderToken:
5836 type: "apiKey"
5837 name: "Authorization"
5838 in: "header"
5839 BasicAuth:
5840 type: "basic"
5841 Token:
5842 type: "apiKey"
5843 name: "token"
5844 in: "query"
5845 security:
5846 -
5847 BasicAuth: []
5848 -
5849 Token: []
5850 -
5851 AccessToken: []
5852 -
5853 AuthorizationHeaderToken: []
5854
View as plain text