UNPKG

296 kBJSONView Raw
1{
2 "authorization": {
3 "get": {
4 "url": "/authorizations/:id",
5 "method": "GET",
6 "params": {
7 "id": {
8 "type": "string",
9 "required": true
10 }
11 },
12 "description": "Get a single authorization."
13 },
14 "create": {
15 "url": "/authorizations",
16 "method": "POST",
17 "params": {
18 "scopes": {
19 "type": "string[]",
20 "description": "A list of scopes that this authorization is in."
21 },
22 "note": {
23 "type": "string",
24 "description": "A note to remind you what the OAuth token is for."
25 },
26 "note_url": {
27 "type": "string",
28 "description": "A URL to remind you what app the OAuth token is for."
29 },
30 "client_id": {
31 "type": "string",
32 "description": "The 20 character OAuth app client key for which to create the token."
33 },
34 "client_secret": {
35 "type": "string",
36 "description": "The 40 character OAuth app client secret for which to create the token."
37 },
38 "fingerprint": {
39 "type": "string",
40 "description": "A unique string to distinguish an authorization from others created for the same client ID and user."
41 }
42 },
43 "description": "Create a new authorization."
44 },
45 "update": {
46 "url": "/authorizations/:id",
47 "method": "PATCH",
48 "params": {
49 "id": {
50 "type": "string",
51 "required": true
52 },
53 "scopes": {
54 "type": "string[]",
55 "description": "A list of scopes that this authorization is in."
56 },
57 "add_scopes": {
58 "type": "string[]",
59 "description": "A list of scopes to add to this authorization."
60 },
61 "remove_scopes": {
62 "type": "string[]",
63 "description": "A list of scopes to remove from this authorization."
64 },
65 "note": {
66 "type": "string",
67 "description": "A note to remind you what the OAuth token is for."
68 },
69 "note_url": {
70 "type": "string",
71 "description": "A URL to remind you what app the OAuth token is for."
72 },
73 "fingerprint": {
74 "type": "string",
75 "description": "A unique string to distinguish an authorization from others created for the same client ID and user."
76 }
77 },
78 "description": "Update an existing authorization."
79 },
80 "delete": {
81 "url": "/authorizations/:id",
82 "method": "DELETE",
83 "params": {
84 "id": {
85 "type": "string",
86 "required": true
87 }
88 },
89 "description": "Delete an authorization."
90 },
91 "check": {
92 "url": "/applications/:client_id/tokens/:access_token",
93 "method": "GET",
94 "params": {
95 "client_id": {
96 "type": "string",
97 "description": "The 20 character OAuth app client key for which to create the token."
98 },
99 "access_token": {
100 "type": "string",
101 "required": true,
102 "description": "OAuth token"
103 }
104 },
105 "description": "Check an authorization"
106 },
107 "reset": {
108 "url": "/applications/:client_id/tokens/:access_token",
109 "method": "POST",
110 "params": {
111 "client_id": {
112 "type": "string",
113 "description": "The 20 character OAuth app client key for which to create the token."
114 },
115 "access_token": {
116 "type": "string",
117 "required": true,
118 "description": "OAuth token"
119 }
120 },
121 "description": "Reset an authorization"
122 },
123 "revoke": {
124 "url": "/applications/:client_id/tokens/:access_token",
125 "method": "DELETE",
126 "params": {
127 "client_id": {
128 "type": "string",
129 "description": "The 20 character OAuth app client key for which to create the token."
130 },
131 "access_token": {
132 "type": "string",
133 "required": true,
134 "description": "OAuth token"
135 }
136 },
137 "description": "Revoke an authorization for an application"
138 },
139 "getGrants": {
140 "url": "/applications/grants",
141 "method": "GET",
142 "params": {
143 "page": {
144 "type": "number",
145 "description": "Page number of the results to fetch."
146 },
147 "per_page": {
148 "type": "number",
149 "default": "30",
150 "description": "A custom page size up to 100. Default is 30."
151 }
152 },
153 "description": "List your grants."
154 },
155 "getGrant": {
156 "url": "/applications/grants/:id",
157 "method": "GET",
158 "params": {
159 "id": {
160 "type": "string",
161 "required": true
162 },
163 "page": {
164 "type": "number",
165 "description": "Page number of the results to fetch."
166 },
167 "per_page": {
168 "type": "number",
169 "default": "30",
170 "description": "A custom page size up to 100. Default is 30."
171 }
172 },
173 "description": "Get a single grant."
174 },
175 "deleteGrant": {
176 "url": "/applications/grants/:id",
177 "method": "DELETE",
178 "params": {
179 "id": {
180 "type": "string",
181 "required": true
182 }
183 },
184 "description": "Delete a grant."
185 },
186 "getAll": {
187 "url": "/authorizations",
188 "method": "GET",
189 "params": {
190 "page": {
191 "type": "number",
192 "description": "Page number of the results to fetch."
193 },
194 "per_page": {
195 "type": "number",
196 "default": "30",
197 "description": "A custom page size up to 100. Default is 30."
198 }
199 },
200 "description": "List your authorizations."
201 },
202 "getOrCreateAuthorizationForApp": {
203 "url": "/authorizations/clients/:client_id",
204 "method": "PUT",
205 "params": {
206 "client_id": {
207 "type": "string",
208 "description": "The 20 character OAuth app client key for which to create the token."
209 },
210 "client_secret": {
211 "type": "string",
212 "required": true,
213 "description": "The 40 character OAuth app client secret associated with the client ID specified in the URL."
214 },
215 "scopes": {
216 "type": "string[]",
217 "description": "A list of scopes that this authorization is in."
218 },
219 "note": {
220 "type": "string",
221 "description": "A note to remind you what the OAuth token is for."
222 },
223 "note_url": {
224 "type": "string",
225 "description": "A URL to remind you what app the OAuth token is for."
226 },
227 "fingerprint": {
228 "type": "string",
229 "description": "A unique string to distinguish an authorization from others created for the same client ID and user."
230 }
231 },
232 "description": "Get or create an authorization for a specific app."
233 },
234 "getOrCreateAuthorizationForAppAndFingerprint": {
235 "url": "/authorizations/clients/:client_id/:fingerprint",
236 "method": "PUT",
237 "params": {
238 "client_id": {
239 "type": "string",
240 "description": "The 20 character OAuth app client key for which to create the token."
241 },
242 "fingerprint": {
243 "type": "string",
244 "description": "A unique string to distinguish an authorization from others created for the same client ID and user."
245 },
246 "client_secret": {
247 "type": "string",
248 "required": true,
249 "description": "The 40 character OAuth app client secret associated with the client ID specified in the URL."
250 },
251 "scopes": {
252 "type": "string[]",
253 "description": "A list of scopes that this authorization is in."
254 },
255 "note": {
256 "type": "string",
257 "description": "A note to remind you what the OAuth token is for."
258 },
259 "note_url": {
260 "type": "string",
261 "description": "A URL to remind you what app the OAuth token is for."
262 }
263 },
264 "description": "Get or create an authorization for a specific app and fingerprint."
265 },
266 "revokeGrant": {
267 "url": "/applications/:client_id/grants/:access_token",
268 "method": "DELETE",
269 "params": {
270 "client_id": {
271 "type": "string",
272 "description": "The 20 character OAuth app client key for which to create the token."
273 },
274 "access_token": {
275 "type": "string",
276 "required": true,
277 "description": "OAuth token"
278 }
279 },
280 "description": "Revoke a grant for an application"
281 }
282 },
283 "activity": {
284 "getEvents": {
285 "url": "/events",
286 "method": "GET",
287 "params": {
288 "page": {
289 "type": "number",
290 "description": "Page number of the results to fetch."
291 },
292 "per_page": {
293 "type": "number",
294 "default": "30",
295 "description": "A custom page size up to 100. Default is 30."
296 }
297 },
298 "description": "List public events"
299 },
300 "getEventsForRepo": {
301 "url": "/repos/:owner/:repo/events",
302 "method": "GET",
303 "params": {
304 "owner": {
305 "type": "string",
306 "required": true
307 },
308 "repo": {
309 "type": "string",
310 "required": true
311 },
312 "page": {
313 "type": "number",
314 "description": "Page number of the results to fetch."
315 },
316 "per_page": {
317 "type": "number",
318 "default": "30",
319 "description": "A custom page size up to 100. Default is 30."
320 }
321 },
322 "description": "List repository events"
323 },
324 "getEventsForRepoIssues": {
325 "url": "/repos/:owner/:repo/issues/events",
326 "method": "GET",
327 "params": {
328 "owner": {
329 "type": "string",
330 "required": true
331 },
332 "repo": {
333 "type": "string",
334 "required": true
335 },
336 "page": {
337 "type": "number",
338 "description": "Page number of the results to fetch."
339 },
340 "per_page": {
341 "type": "number",
342 "default": "30",
343 "description": "A custom page size up to 100. Default is 30."
344 }
345 },
346 "description": "List issue events for a repository"
347 },
348 "getEventsForRepoNetwork": {
349 "url": "/networks/:owner/:repo/events",
350 "method": "GET",
351 "params": {
352 "owner": {
353 "type": "string",
354 "required": true
355 },
356 "repo": {
357 "type": "string",
358 "required": true
359 },
360 "page": {
361 "type": "number",
362 "description": "Page number of the results to fetch."
363 },
364 "per_page": {
365 "type": "number",
366 "default": "30",
367 "description": "A custom page size up to 100. Default is 30."
368 }
369 },
370 "description": "List public events for a network of repositories"
371 },
372 "getEventsForOrg": {
373 "url": "/orgs/:org/events",
374 "method": "GET",
375 "params": {
376 "org": {
377 "type": "string",
378 "required": true
379 },
380 "page": {
381 "type": "number",
382 "description": "Page number of the results to fetch."
383 },
384 "per_page": {
385 "type": "number",
386 "default": "30",
387 "description": "A custom page size up to 100. Default is 30."
388 }
389 },
390 "description": "List public events for an organization"
391 },
392 "getEventsReceived": {
393 "url": "/users/:username/received_events",
394 "method": "GET",
395 "params": {
396 "username": {
397 "type": "string",
398 "required": true
399 },
400 "page": {
401 "type": "number",
402 "description": "Page number of the results to fetch."
403 },
404 "per_page": {
405 "type": "number",
406 "default": "30",
407 "description": "A custom page size up to 100. Default is 30."
408 }
409 },
410 "description": "List events that a user has received"
411 },
412 "getEventsReceivedPublic": {
413 "url": "/users/:username/received_events/public",
414 "method": "GET",
415 "params": {
416 "username": {
417 "type": "string",
418 "required": true
419 },
420 "page": {
421 "type": "number",
422 "description": "Page number of the results to fetch."
423 },
424 "per_page": {
425 "type": "number",
426 "default": "30",
427 "description": "A custom page size up to 100. Default is 30."
428 }
429 },
430 "description": "List public events that a user has received"
431 },
432 "getEventsForUser": {
433 "url": "/users/:username/events",
434 "method": "GET",
435 "params": {
436 "username": {
437 "type": "string",
438 "required": true
439 },
440 "page": {
441 "type": "number",
442 "description": "Page number of the results to fetch."
443 },
444 "per_page": {
445 "type": "number",
446 "default": "30",
447 "description": "A custom page size up to 100. Default is 30."
448 }
449 },
450 "description": "List events performed by a user"
451 },
452 "getEventsForUserPublic": {
453 "url": "/users/:username/events/public",
454 "method": "GET",
455 "params": {
456 "username": {
457 "type": "string",
458 "required": true
459 },
460 "page": {
461 "type": "number",
462 "description": "Page number of the results to fetch."
463 },
464 "per_page": {
465 "type": "number",
466 "default": "30",
467 "description": "A custom page size up to 100. Default is 30."
468 }
469 },
470 "description": "List public events performed by a user"
471 },
472 "getEventsForUserOrg": {
473 "url": "/users/:username/events/orgs/:org",
474 "method": "GET",
475 "params": {
476 "username": {
477 "type": "string",
478 "required": true
479 },
480 "org": {
481 "type": "string",
482 "required": true
483 },
484 "page": {
485 "type": "number",
486 "description": "Page number of the results to fetch."
487 },
488 "per_page": {
489 "type": "number",
490 "default": "30",
491 "description": "A custom page size up to 100. Default is 30."
492 }
493 },
494 "description": "List events for a user's organization"
495 },
496 "getFeeds": {
497 "url": "/feeds",
498 "method": "GET",
499 "params": {},
500 "description": "Get all feeds available for the authenticated user."
501 },
502 "getNotifications": {
503 "url": "/notifications",
504 "method": "GET",
505 "params": {
506 "all": {
507 "type": "boolean",
508 "default": "false",
509 "description": "If true, show notifications marked as read. Default: false"
510 },
511 "participating": {
512 "type": "boolean",
513 "default": "false",
514 "description": "If true, only shows notifications in which the user is directly participating or mentioned. Default: false"
515 },
516 "since": {
517 "type": "date",
518 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
519 },
520 "before": {
521 "type": "string",
522 "description": "Only show notifications updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ."
523 }
524 },
525 "description": "Get all notifications for the current user, grouped by repository."
526 },
527 "getNotificationsForUser": {
528 "url": "/repos/:owner/:repo/notifications",
529 "method": "GET",
530 "params": {
531 "owner": {
532 "type": "string",
533 "required": true
534 },
535 "repo": {
536 "type": "string",
537 "required": true
538 },
539 "all": {
540 "type": "boolean",
541 "default": "false",
542 "description": "If true, show notifications marked as read. Default: false"
543 },
544 "participating": {
545 "type": "boolean",
546 "default": "false",
547 "description": "If true, only shows notifications in which the user is directly participating or mentioned. Default: false"
548 },
549 "since": {
550 "type": "date",
551 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
552 },
553 "before": {
554 "type": "string",
555 "description": "Only show notifications updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ."
556 }
557 },
558 "description": "Get all notifications for the given user."
559 },
560 "markNotificationsAsRead": {
561 "url": "/notifications",
562 "method": "PUT",
563 "params": {
564 "last_read_at": {
565 "type": "string",
566 "default": "Time.now",
567 "description": "Describes the last point that notifications were checked. Anything updated since this time will not be updated. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: Time.now"
568 }
569 },
570 "description": "Mark notifications as read for authenticated user."
571 },
572 "markNotificationsAsReadForRepo": {
573 "url": "/repos/:owner/:repo/notifications",
574 "method": "PUT",
575 "params": {
576 "owner": {
577 "type": "string",
578 "required": true
579 },
580 "repo": {
581 "type": "string",
582 "required": true
583 },
584 "last_read_at": {
585 "type": "string",
586 "default": "Time.now",
587 "description": "Describes the last point that notifications were checked. Anything updated since this time will not be updated. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: Time.now"
588 }
589 },
590 "description": "Mark notifications in a repo as read."
591 },
592 "getNotificationThread": {
593 "url": "/notifications/threads/:id",
594 "method": "GET",
595 "params": {
596 "id": {
597 "type": "string",
598 "required": true
599 }
600 },
601 "description": "View a single notification thread."
602 },
603 "markNotificationThreadAsRead": {
604 "url": "/notifications/threads/:id",
605 "method": "PATCH",
606 "params": {
607 "id": {
608 "type": "string",
609 "required": true
610 }
611 },
612 "description": "Mark a notification thread as read."
613 },
614 "checkNotificationThreadSubscription": {
615 "url": "/notifications/threads/:id/subscription",
616 "method": "GET",
617 "params": {
618 "id": {
619 "type": "string",
620 "required": true
621 }
622 },
623 "description": "Check to see if the current user is subscribed to a thread."
624 },
625 "setNotificationThreadSubscription": {
626 "url": "/notifications/threads/:id/subscription",
627 "method": "PUT",
628 "params": {
629 "id": {
630 "type": "string",
631 "required": true
632 },
633 "subscribed": {
634 "type": "boolean",
635 "description": "Determines if notifications should be received from this thread"
636 },
637 "ignored": {
638 "type": "boolean",
639 "description": "Determines if all notifications should be blocked from this thread"
640 }
641 },
642 "description": "This lets you subscribe or unsubscribe from a conversation. Unsubscribing from a conversation mutes all future notifications (until you comment or get @mentioned once more)."
643 },
644 "deleteNotificationThreadSubscription": {
645 "url": "/notifications/threads/:id/subscription",
646 "method": "DELETE",
647 "params": {
648 "id": {
649 "type": "string",
650 "required": true
651 }
652 },
653 "description": "Delete a notification thread subscription."
654 },
655 "getStargazersForRepo": {
656 "url": "/repos/:owner/:repo/stargazers",
657 "method": "GET",
658 "headers": {
659 "accept": "application/vnd.github.v3.star+json"
660 },
661 "params": {
662 "owner": {
663 "type": "string",
664 "required": true
665 },
666 "repo": {
667 "type": "string",
668 "required": true
669 },
670 "page": {
671 "type": "number",
672 "description": "Page number of the results to fetch."
673 },
674 "per_page": {
675 "type": "number",
676 "default": "30",
677 "description": "A custom page size up to 100. Default is 30."
678 }
679 },
680 "description": "List Stargazers"
681 },
682 "getStarredReposForUser": {
683 "url": "/users/:username/starred",
684 "method": "GET",
685 "headers": {
686 "accept": "application/vnd.github.v3.star+json"
687 },
688 "params": {
689 "username": {
690 "type": "string",
691 "required": true
692 },
693 "sort": {
694 "type": "string",
695 "enum": [
696 "created",
697 "updated"
698 ],
699 "default": "created"
700 },
701 "direction": {
702 "type": "string",
703 "enum": [
704 "asc",
705 "desc"
706 ],
707 "default": "desc"
708 },
709 "page": {
710 "type": "number",
711 "description": "Page number of the results to fetch."
712 },
713 "per_page": {
714 "type": "number",
715 "default": "30",
716 "description": "A custom page size up to 100. Default is 30."
717 }
718 },
719 "description": "List repositories being starred by a user"
720 },
721 "getStarredRepos": {
722 "url": "/user/starred",
723 "method": "GET",
724 "headers": {
725 "accept": "application/vnd.github.v3.star+json"
726 },
727 "params": {
728 "sort": {
729 "type": "string",
730 "enum": [
731 "created",
732 "updated"
733 ],
734 "default": "created"
735 },
736 "direction": {
737 "type": "string",
738 "enum": [
739 "asc",
740 "desc"
741 ],
742 "default": "desc"
743 },
744 "page": {
745 "type": "number",
746 "description": "Page number of the results to fetch."
747 },
748 "per_page": {
749 "type": "number",
750 "default": "30",
751 "description": "A custom page size up to 100. Default is 30."
752 }
753 },
754 "description": "List repositories being starred by the authenticated user"
755 },
756 "checkStarringRepo": {
757 "url": "/user/starred/:owner/:repo",
758 "method": "GET",
759 "params": {
760 "owner": {
761 "type": "string",
762 "required": true
763 },
764 "repo": {
765 "type": "string",
766 "required": true
767 },
768 "page": {
769 "type": "number",
770 "description": "Page number of the results to fetch."
771 },
772 "per_page": {
773 "type": "number",
774 "default": "30",
775 "description": "A custom page size up to 100. Default is 30."
776 }
777 },
778 "description": "Check if you are starring a repository"
779 },
780 "starRepo": {
781 "url": "/user/starred/:owner/:repo",
782 "method": "PUT",
783 "params": {
784 "owner": {
785 "type": "string",
786 "required": true
787 },
788 "repo": {
789 "type": "string",
790 "required": true
791 }
792 },
793 "description": "Star a repository"
794 },
795 "unstarRepo": {
796 "url": "/user/starred/:owner/:repo",
797 "method": "DELETE",
798 "params": {
799 "owner": {
800 "type": "string",
801 "required": true
802 },
803 "repo": {
804 "type": "string",
805 "required": true
806 }
807 },
808 "description": "Unstar a repository"
809 },
810 "getWatchersForRepo": {
811 "url": "/repos/:owner/:repo/subscribers",
812 "method": "GET",
813 "params": {
814 "owner": {
815 "type": "string",
816 "required": true
817 },
818 "repo": {
819 "type": "string",
820 "required": true
821 },
822 "page": {
823 "type": "number",
824 "description": "Page number of the results to fetch."
825 },
826 "per_page": {
827 "type": "number",
828 "default": "30",
829 "description": "A custom page size up to 100. Default is 30."
830 }
831 },
832 "description": "Get watchers for repository."
833 },
834 "getWatchedReposForUser": {
835 "url": "/users/:username/subscriptions",
836 "method": "GET",
837 "params": {
838 "username": {
839 "type": "string",
840 "required": true
841 },
842 "page": {
843 "type": "number",
844 "description": "Page number of the results to fetch."
845 },
846 "per_page": {
847 "type": "number",
848 "default": "30",
849 "description": "A custom page size up to 100. Default is 30."
850 }
851 },
852 "description": "List repositories being watched by a user."
853 },
854 "getWatchedRepos": {
855 "url": "/user/subscriptions",
856 "method": "GET",
857 "params": {
858 "page": {
859 "type": "number",
860 "description": "Page number of the results to fetch."
861 },
862 "per_page": {
863 "type": "number",
864 "default": "30",
865 "description": "A custom page size up to 100. Default is 30."
866 }
867 },
868 "description": "List repositories being watched by the authenticated user."
869 },
870 "getRepoSubscription": {
871 "url": "/repos/:owner/:repo/subscription",
872 "method": "GET",
873 "params": {
874 "owner": {
875 "type": "string",
876 "required": true
877 },
878 "repo": {
879 "type": "string",
880 "required": true
881 },
882 "page": {
883 "type": "number",
884 "description": "Page number of the results to fetch."
885 },
886 "per_page": {
887 "type": "number",
888 "default": "30",
889 "description": "A custom page size up to 100. Default is 30."
890 }
891 },
892 "description": "Get a Repository Subscription."
893 },
894 "setRepoSubscription": {
895 "url": "/repos/:owner/:repo/subscription",
896 "method": "PUT",
897 "params": {
898 "owner": {
899 "type": "string",
900 "required": true
901 },
902 "repo": {
903 "type": "string",
904 "required": true
905 },
906 "subscribed": {
907 "type": "boolean",
908 "description": "Determines if notifications should be received from this repository."
909 },
910 "ignored": {
911 "type": "boolean",
912 "description": "Determines if all notifications should be blocked from this repository."
913 }
914 },
915 "description": "Set a Repository Subscription"
916 },
917 "unwatchRepo": {
918 "url": "/repos/:owner/:repo/subscription",
919 "method": "DELETE",
920 "params": {
921 "owner": {
922 "type": "string",
923 "required": true
924 },
925 "repo": {
926 "type": "string",
927 "required": true
928 }
929 },
930 "description": "Unwatch a repository."
931 }
932 },
933 "gists": {
934 "get": {
935 "url": "/gists/:id",
936 "method": "GET",
937 "params": {
938 "id": {
939 "type": "string",
940 "required": true
941 }
942 },
943 "description": "Get a single gist"
944 },
945 "create": {
946 "url": "/gists",
947 "method": "POST",
948 "params": {
949 "files": {
950 "type": "json",
951 "required": true,
952 "description": "Files that make up this gist. The key of which should be a required string filename and the value another required hash with parameters: 'content'"
953 },
954 "description": {
955 "type": "string"
956 },
957 "public": {
958 "type": "boolean",
959 "required": true
960 }
961 },
962 "description": "Create a gist"
963 },
964 "edit": {
965 "url": "/gists/:id",
966 "method": "PATCH",
967 "params": {
968 "id": {
969 "type": "string",
970 "required": true
971 },
972 "description": {
973 "type": "string"
974 },
975 "files": {
976 "type": "json",
977 "required": true,
978 "description": "Files that make up this gist. The key of which should be a required string filename and the value another required hash with parameters: 'content'"
979 },
980 "content": {
981 "type": "string",
982 "description": "Updated file contents."
983 },
984 "filename": {
985 "type": "string",
986 "description": "New name for this file."
987 }
988 },
989 "description": "Edit a gist"
990 },
991 "star": {
992 "url": "/gists/:id/star",
993 "method": "PUT",
994 "params": {
995 "id": {
996 "type": "string",
997 "required": true
998 }
999 },
1000 "description": "Star a gist"
1001 },
1002 "unstar": {
1003 "url": "/gists/:id/star",
1004 "method": "DELETE",
1005 "params": {
1006 "id": {
1007 "type": "string",
1008 "required": true
1009 }
1010 },
1011 "description": "Unstar a gist"
1012 },
1013 "fork": {
1014 "url": "/gists/:id/forks",
1015 "method": "POST",
1016 "params": {
1017 "id": {
1018 "type": "string",
1019 "required": true
1020 }
1021 },
1022 "description": "Fork a gist"
1023 },
1024 "delete": {
1025 "url": "/gists/:id",
1026 "method": "DELETE",
1027 "params": {
1028 "id": {
1029 "type": "string",
1030 "required": true
1031 }
1032 },
1033 "description": "Delete a gist"
1034 },
1035 "getForUser": {
1036 "url": "/users/:username/gists",
1037 "method": "GET",
1038 "params": {
1039 "username": {
1040 "type": "string",
1041 "required": true
1042 },
1043 "since": {
1044 "type": "date",
1045 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
1046 },
1047 "page": {
1048 "type": "number",
1049 "description": "Page number of the results to fetch."
1050 },
1051 "per_page": {
1052 "type": "number",
1053 "default": "30",
1054 "description": "A custom page size up to 100. Default is 30."
1055 }
1056 },
1057 "description": "List a user's gists"
1058 },
1059 "getAll": {
1060 "url": "/gists",
1061 "method": "GET",
1062 "params": {
1063 "since": {
1064 "type": "date",
1065 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
1066 },
1067 "page": {
1068 "type": "number",
1069 "description": "Page number of the results to fetch."
1070 },
1071 "per_page": {
1072 "type": "number",
1073 "default": "30",
1074 "description": "A custom page size up to 100. Default is 30."
1075 }
1076 },
1077 "description": "List the authenticated user's gists or if called anonymously, this will return all public gists"
1078 },
1079 "getPublic": {
1080 "url": "/gists/public",
1081 "method": "GET",
1082 "params": {
1083 "since": {
1084 "type": "date",
1085 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
1086 }
1087 },
1088 "description": "List all public gists"
1089 },
1090 "getStarred": {
1091 "url": "/gists/starred",
1092 "method": "GET",
1093 "params": {
1094 "since": {
1095 "type": "date",
1096 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
1097 }
1098 },
1099 "description": "List the authenticated user's starred gists"
1100 },
1101 "getRevision": {
1102 "url": "/gists/:id/:sha",
1103 "method": "GET",
1104 "params": {
1105 "id": {
1106 "type": "string",
1107 "required": true
1108 },
1109 "sha": {
1110 "type": "string",
1111 "required": true
1112 }
1113 },
1114 "description": "Get a specific revision of a gist"
1115 },
1116 "getCommits": {
1117 "url": "/gists/:id/commits",
1118 "method": "GET",
1119 "params": {
1120 "id": {
1121 "type": "string",
1122 "required": true
1123 }
1124 },
1125 "description": "List gist commits"
1126 },
1127 "checkStar": {
1128 "url": "/gists/:id/star",
1129 "method": "GET",
1130 "params": {
1131 "id": {
1132 "type": "string",
1133 "required": true
1134 }
1135 },
1136 "description": "Check if a gist is starred"
1137 },
1138 "getForks": {
1139 "url": "/gists/:id/forks",
1140 "method": "GET",
1141 "params": {
1142 "id": {
1143 "type": "string",
1144 "required": true
1145 },
1146 "page": {
1147 "type": "number",
1148 "description": "Page number of the results to fetch."
1149 },
1150 "per_page": {
1151 "type": "number",
1152 "default": "30",
1153 "description": "A custom page size up to 100. Default is 30."
1154 }
1155 },
1156 "description": "List gist forks"
1157 },
1158 "getComments": {
1159 "url": "/gists/:gist_id/comments",
1160 "method": "GET",
1161 "params": {
1162 "gist_id": {
1163 "type": "string",
1164 "required": true,
1165 "description": "Id (SHA1 hash) of the gist."
1166 }
1167 },
1168 "description": "List comments on a gist"
1169 },
1170 "getComment": {
1171 "url": "/gists/:gist_id/comments/:id",
1172 "method": "GET",
1173 "params": {
1174 "gist_id": {
1175 "type": "string",
1176 "required": true,
1177 "description": "Id (SHA1 hash) of the gist."
1178 },
1179 "id": {
1180 "type": "string",
1181 "required": true
1182 }
1183 },
1184 "description": "Get a single comment"
1185 },
1186 "createComment": {
1187 "url": "/gists/:gist_id/comments",
1188 "method": "POST",
1189 "params": {
1190 "gist_id": {
1191 "type": "string",
1192 "required": true,
1193 "description": "Id (SHA1 hash) of the gist."
1194 },
1195 "body": {
1196 "type": "string",
1197 "required": true
1198 }
1199 },
1200 "description": "Create a comment"
1201 },
1202 "editComment": {
1203 "url": "/gists/:gist_id/comments/:id",
1204 "method": "PATCH",
1205 "params": {
1206 "gist_id": {
1207 "type": "string",
1208 "required": true,
1209 "description": "Id (SHA1 hash) of the gist."
1210 },
1211 "id": {
1212 "type": "string",
1213 "required": true
1214 },
1215 "body": {
1216 "type": "string",
1217 "required": true
1218 }
1219 },
1220 "description": "Edit a comment"
1221 },
1222 "deleteComment": {
1223 "url": "/gists/:gist_id/comments/:id",
1224 "method": "DELETE",
1225 "params": {
1226 "gist_id": {
1227 "type": "string",
1228 "required": true,
1229 "description": "Id (SHA1 hash) of the gist."
1230 },
1231 "id": {
1232 "type": "string",
1233 "required": true
1234 }
1235 },
1236 "description": "Delete a comment"
1237 }
1238 },
1239 "gitdata": {
1240 "getBlob": {
1241 "url": "/repos/:owner/:repo/git/blobs/:sha",
1242 "method": "GET",
1243 "params": {
1244 "owner": {
1245 "type": "string",
1246 "required": true
1247 },
1248 "repo": {
1249 "type": "string",
1250 "required": true
1251 },
1252 "sha": {
1253 "type": "string",
1254 "required": true
1255 },
1256 "page": {
1257 "type": "number",
1258 "description": "Page number of the results to fetch."
1259 },
1260 "per_page": {
1261 "type": "number",
1262 "default": "30",
1263 "description": "A custom page size up to 100. Default is 30."
1264 }
1265 },
1266 "description": "Get a Blob"
1267 },
1268 "createBlob": {
1269 "url": "/repos/:owner/:repo/git/blobs",
1270 "method": "POST",
1271 "params": {
1272 "owner": {
1273 "type": "string",
1274 "required": true
1275 },
1276 "repo": {
1277 "type": "string",
1278 "required": true
1279 },
1280 "content": {
1281 "type": "string",
1282 "required": true,
1283 "allow-empty": true
1284 },
1285 "encoding": {
1286 "type": "string",
1287 "required": true
1288 }
1289 },
1290 "description": "Create a Blob"
1291 },
1292 "getCommit": {
1293 "url": "/repos/:owner/:repo/git/commits/:sha",
1294 "method": "GET",
1295 "params": {
1296 "owner": {
1297 "type": "string",
1298 "required": true
1299 },
1300 "repo": {
1301 "type": "string",
1302 "required": true
1303 },
1304 "sha": {
1305 "type": "string",
1306 "required": true
1307 }
1308 },
1309 "description": "Get a Commit"
1310 },
1311 "createCommit": {
1312 "url": "/repos/:owner/:repo/git/commits",
1313 "method": "POST",
1314 "params": {
1315 "owner": {
1316 "type": "string",
1317 "required": true
1318 },
1319 "repo": {
1320 "type": "string",
1321 "required": true
1322 },
1323 "message": {
1324 "type": "string",
1325 "required": true,
1326 "description": "String of the commit message"
1327 },
1328 "tree": {
1329 "type": "string",
1330 "required": true,
1331 "description": "String of the SHA of the tree object this commit points to"
1332 },
1333 "parents": {
1334 "type": "string[]",
1335 "required": true,
1336 "description": "Array of the SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided, for a merge commit, an array of more than one should be provided."
1337 },
1338 "author": {
1339 "type": "json"
1340 },
1341 "committer": {
1342 "type": "json"
1343 }
1344 },
1345 "description": "Create a Commit"
1346 },
1347 "getCommitSignatureVerification": {
1348 "url": "/repos/:owner/:repo/git/commits/:sha",
1349 "method": "GET",
1350 "params": {
1351 "owner": {
1352 "type": "string",
1353 "required": true
1354 },
1355 "repo": {
1356 "type": "string",
1357 "required": true
1358 },
1359 "sha": {
1360 "type": "string",
1361 "required": true
1362 }
1363 },
1364 "description": "Get a Commit Signature Verification. (In preview period. See README.)"
1365 },
1366 "getReference": {
1367 "url": "/repos/:owner/:repo/git/refs/:ref",
1368 "method": "GET",
1369 "params": {
1370 "owner": {
1371 "type": "string",
1372 "required": true
1373 },
1374 "repo": {
1375 "type": "string",
1376 "required": true
1377 },
1378 "ref": {
1379 "type": "string",
1380 "required": true,
1381 "allow-empty": true,
1382 "description": "String of the name of the fully qualified reference (ie: heads/master). If it doesn’t have at least one slash, it will be rejected."
1383 }
1384 },
1385 "description": "Get a Reference"
1386 },
1387 "getReferences": {
1388 "url": "/repos/:owner/:repo/git/refs",
1389 "method": "GET",
1390 "params": {
1391 "owner": {
1392 "type": "string",
1393 "required": true
1394 },
1395 "repo": {
1396 "type": "string",
1397 "required": true
1398 },
1399 "page": {
1400 "type": "number",
1401 "description": "Page number of the results to fetch."
1402 },
1403 "per_page": {
1404 "type": "number",
1405 "default": "30",
1406 "description": "A custom page size up to 100. Default is 30."
1407 }
1408 },
1409 "description": "Get all References"
1410 },
1411 "getTags": {
1412 "url": "/repos/:owner/:repo/git/refs/tags",
1413 "method": "GET",
1414 "params": {
1415 "owner": {
1416 "type": "string",
1417 "required": true
1418 },
1419 "repo": {
1420 "type": "string",
1421 "required": true
1422 },
1423 "page": {
1424 "type": "number",
1425 "description": "Page number of the results to fetch."
1426 },
1427 "per_page": {
1428 "type": "number",
1429 "default": "30",
1430 "description": "A custom page size up to 100. Default is 30."
1431 }
1432 },
1433 "description": "Get all tag References"
1434 },
1435 "createReference": {
1436 "url": "/repos/:owner/:repo/git/refs",
1437 "method": "POST",
1438 "params": {
1439 "owner": {
1440 "type": "string",
1441 "required": true
1442 },
1443 "repo": {
1444 "type": "string",
1445 "required": true
1446 },
1447 "ref": {
1448 "type": "string",
1449 "required": true,
1450 "description": "The name of the fully qualified reference (ie: refs/heads/master). If it doesn't start with 'refs' and have at least two slashes, it will be rejected. NOTE: After creating the reference, on calling (get|update|delete)Reference, drop the leading 'refs/' when providing the 'ref' param."
1451 },
1452 "sha": {
1453 "type": "string",
1454 "required": true
1455 }
1456 },
1457 "description": "Create a Reference"
1458 },
1459 "updateReference": {
1460 "url": "/repos/:owner/:repo/git/refs/:ref",
1461 "method": "PATCH",
1462 "params": {
1463 "owner": {
1464 "type": "string",
1465 "required": true
1466 },
1467 "repo": {
1468 "type": "string",
1469 "required": true
1470 },
1471 "ref": {
1472 "type": "string",
1473 "required": true,
1474 "allow-empty": true,
1475 "description": "String of the name of the fully qualified reference (ie: heads/master). If it doesn’t have at least one slash, it will be rejected."
1476 },
1477 "sha": {
1478 "type": "string",
1479 "required": true
1480 },
1481 "force": {
1482 "type": "boolean",
1483 "default": "false",
1484 "description": "Boolean indicating whether to force the update or to make sure the update is a fast-forward update. The default is false, so leaving this out or setting it to false will make sure you’re not overwriting work."
1485 }
1486 },
1487 "description": "Update a Reference"
1488 },
1489 "deleteReference": {
1490 "url": "/repos/:owner/:repo/git/refs/:ref",
1491 "method": "DELETE",
1492 "params": {
1493 "owner": {
1494 "type": "string",
1495 "required": true
1496 },
1497 "repo": {
1498 "type": "string",
1499 "required": true
1500 },
1501 "ref": {
1502 "type": "string",
1503 "required": true,
1504 "allow-empty": true,
1505 "description": "String of the name of the fully qualified reference (ie: heads/master). If it doesn’t have at least one slash, it will be rejected."
1506 }
1507 },
1508 "description": "Delete a Reference"
1509 },
1510 "getTag": {
1511 "url": "/repos/:owner/:repo/git/tags/:sha",
1512 "method": "GET",
1513 "params": {
1514 "owner": {
1515 "type": "string",
1516 "required": true
1517 },
1518 "repo": {
1519 "type": "string",
1520 "required": true
1521 },
1522 "sha": {
1523 "type": "string",
1524 "required": true
1525 }
1526 },
1527 "description": "Get a Tag"
1528 },
1529 "createTag": {
1530 "url": "/repos/:owner/:repo/git/tags",
1531 "method": "POST",
1532 "params": {
1533 "owner": {
1534 "type": "string",
1535 "required": true
1536 },
1537 "repo": {
1538 "type": "string",
1539 "required": true
1540 },
1541 "tag": {
1542 "type": "string",
1543 "required": true,
1544 "description": "String of the tag"
1545 },
1546 "message": {
1547 "type": "string",
1548 "required": true,
1549 "description": "String of the tag message"
1550 },
1551 "object": {
1552 "type": "string",
1553 "required": true,
1554 "description": "String of the SHA of the git object this is tagging"
1555 },
1556 "type": {
1557 "type": "string",
1558 "required": true,
1559 "description": "String of the type of the object we’re tagging. Normally this is a commit but it can also be a tree or a blob."
1560 },
1561 "tagger": {
1562 "type": "json",
1563 "required": true,
1564 "description": "JSON object that contains the following keys: `name` - String of the name of the author of the tag, `email` - String of the email of the author of the tag, `date` - Timestamp of when this object was tagged"
1565 }
1566 },
1567 "description": "Create a Tag Object"
1568 },
1569 "getTagSignatureVerification": {
1570 "url": "/repos/:owner/:repo/git/tags/:sha",
1571 "method": "GET",
1572 "params": {
1573 "owner": {
1574 "type": "string",
1575 "required": true
1576 },
1577 "repo": {
1578 "type": "string",
1579 "required": true
1580 },
1581 "sha": {
1582 "type": "string",
1583 "required": true
1584 }
1585 },
1586 "description": "Get a Tag Signature Verification. (In preview period. See README.)"
1587 },
1588 "getTree": {
1589 "url": "/repos/:owner/:repo/git/trees/:sha",
1590 "method": "GET",
1591 "params": {
1592 "owner": {
1593 "type": "string",
1594 "required": true
1595 },
1596 "repo": {
1597 "type": "string",
1598 "required": true
1599 },
1600 "sha": {
1601 "type": "string",
1602 "required": true
1603 },
1604 "recursive": {
1605 "type": "boolean"
1606 }
1607 },
1608 "description": "Get a Tree"
1609 },
1610 "createTree": {
1611 "url": "/repos/:owner/:repo/git/trees",
1612 "method": "POST",
1613 "params": {
1614 "owner": {
1615 "type": "string",
1616 "required": true
1617 },
1618 "repo": {
1619 "type": "string",
1620 "required": true
1621 },
1622 "tree": {
1623 "type": "json",
1624 "required": true,
1625 "description": "Array of Hash objects (of path, mode, type and sha) specifying a tree structure"
1626 },
1627 "base_tree": {
1628 "type": "string",
1629 "description": "String of the SHA1 of the tree you want to update with new data"
1630 }
1631 },
1632 "description": "Create a Tree"
1633 }
1634 },
1635 "integrations": {
1636 "getInstallations": {
1637 "url": "/app/installations",
1638 "method": "GET",
1639 "deprecated": "`integrations` has been renamed to `apps`",
1640 "headers": {
1641 "accept": "application/vnd.github.machine-man-preview"
1642 },
1643 "params": {
1644 "page": {
1645 "type": "number",
1646 "description": "Page number of the results to fetch."
1647 },
1648 "per_page": {
1649 "type": "number",
1650 "default": "30",
1651 "description": "A custom page size up to 100. Default is 30."
1652 }
1653 },
1654 "description": "List the app's installations. (In preview period. See README.)"
1655 },
1656 "createInstallationToken": {
1657 "url": "/installations/:installation_id/access_tokens",
1658 "method": "POST",
1659 "deprecated": "`integrations` has been renamed to `apps`",
1660 "headers": {
1661 "accept": "application/vnd.github.machine-man-preview"
1662 },
1663 "params": {
1664 "installation_id": {
1665 "type": "string",
1666 "required": true
1667 },
1668 "user_id": {
1669 "type": "string",
1670 "description": "The id of the user for whom the app is acting on behalf of."
1671 }
1672 },
1673 "description": "Create a new installation token. (In preview period. See README.)"
1674 },
1675 "getInstallationRepositories": {
1676 "url": "/installation/repositories",
1677 "method": "GET",
1678 "deprecated": "`integrations` has been renamed to `apps`",
1679 "headers": {
1680 "accept": "application/vnd.github.machine-man-preview"
1681 },
1682 "params": {
1683 "user_id": {
1684 "type": "string",
1685 "description": "The integer ID of a user, to filter results to repositories that are visible to both the installation and the given user."
1686 }
1687 },
1688 "description": "List repositories that are accessible to the authenticated installation. (In preview period. See README.)"
1689 },
1690 "addRepoToInstallation": {
1691 "url": "/installations/:installation_id/repositories/:repository_id",
1692 "method": "PUT",
1693 "deprecated": "`integrations` has been renamed to `apps`",
1694 "headers": {
1695 "accept": "application/vnd.github.machine-man-preview"
1696 },
1697 "params": {
1698 "installation_id": {
1699 "type": "string",
1700 "required": true
1701 },
1702 "repository_id": {
1703 "type": "string",
1704 "required": true
1705 }
1706 },
1707 "description": "Add a single repository to an installation. (In preview period. See README.)"
1708 },
1709 "removeRepoFromInstallation": {
1710 "url": "/installations/:installation_id/repositories/:repository_id",
1711 "method": "DELETE",
1712 "deprecated": "`integrations` has been renamed to `apps`",
1713 "headers": {
1714 "accept": "application/vnd.github.machine-man-preview"
1715 },
1716 "params": {
1717 "installation_id": {
1718 "type": "string",
1719 "required": true
1720 },
1721 "repository_id": {
1722 "type": "string",
1723 "required": true
1724 }
1725 },
1726 "description": "Remove a single repository from an installation. (In preview period. See README.)"
1727 }
1728 },
1729 "apps": {
1730 "get": {
1731 "url": "/app",
1732 "method": "GET",
1733 "params": {},
1734 "description": "Get the authenticated GitHub App. (In preview period. See README.)"
1735 },
1736 "getForSlug": {
1737 "url": "/apps/:app_slug",
1738 "method": "GET",
1739 "headers": {
1740 "accept": "application/vnd.github.machine-man-preview"
1741 },
1742 "params": {
1743 "app_slug": {
1744 "type": "string",
1745 "required": true,
1746 "description": "The URL-friendly name of your GitHub App. You can find this on the settings page for your GitHub App (e.g., https://github.com/settings/apps/:app_slug)."
1747 }
1748 },
1749 "description": "Get a single GitHub App. (In preview period. See README.)"
1750 },
1751 "getInstallations": {
1752 "url": "/app/installations",
1753 "method": "GET",
1754 "headers": {
1755 "accept": "application/vnd.github.machine-man-preview"
1756 },
1757 "params": {
1758 "page": {
1759 "type": "number",
1760 "description": "Page number of the results to fetch."
1761 },
1762 "per_page": {
1763 "type": "number",
1764 "default": "30",
1765 "description": "A custom page size up to 100. Default is 30."
1766 }
1767 },
1768 "description": "List the app's installations. (In preview period. See README.)"
1769 },
1770 "getInstallation": {
1771 "url": "/app/installations/:installation_id",
1772 "method": "GET",
1773 "headers": {
1774 "accept": "application/vnd.github.machine-man-preview"
1775 },
1776 "params": {
1777 "installation_id": {
1778 "type": "string",
1779 "required": true
1780 }
1781 },
1782 "description": "Get a single installation. (In preview period. See README.)"
1783 },
1784 "createInstallationToken": {
1785 "url": "/installations/:installation_id/access_tokens",
1786 "method": "POST",
1787 "headers": {
1788 "accept": "application/vnd.github.machine-man-preview"
1789 },
1790 "params": {
1791 "installation_id": {
1792 "type": "string",
1793 "required": true
1794 },
1795 "user_id": {
1796 "type": "string",
1797 "description": "The id of the user for whom the app is acting on behalf of."
1798 }
1799 },
1800 "description": "Create a new installation token. (In preview period. See README.)"
1801 },
1802 "getInstallationRepositories": {
1803 "url": "/installation/repositories",
1804 "method": "GET",
1805 "headers": {
1806 "accept": "application/vnd.github.machine-man-preview"
1807 },
1808 "params": {
1809 "user_id": {
1810 "type": "string",
1811 "description": "The integer ID of a user, to filter results to repositories that are visible to both the installation and the given user."
1812 }
1813 },
1814 "description": "List repositories that are accessible to the authenticated installation. (In preview period. See README.)"
1815 },
1816 "addRepoToInstallation": {
1817 "url": "/installations/:installation_id/repositories/:repository_id",
1818 "method": "PUT",
1819 "headers": {
1820 "accept": "application/vnd.github.machine-man-preview"
1821 },
1822 "params": {
1823 "installation_id": {
1824 "type": "string",
1825 "required": true
1826 },
1827 "repository_id": {
1828 "type": "string",
1829 "required": true
1830 }
1831 },
1832 "description": "Add a single repository to an installation. (In preview period. See README.)"
1833 },
1834 "removeRepoFromInstallation": {
1835 "url": "/installations/:installation_id/repositories/:repository_id",
1836 "method": "DELETE",
1837 "headers": {
1838 "accept": "application/vnd.github.machine-man-preview"
1839 },
1840 "params": {
1841 "installation_id": {
1842 "type": "string",
1843 "required": true
1844 },
1845 "repository_id": {
1846 "type": "string",
1847 "required": true
1848 }
1849 },
1850 "description": "Remove a single repository from an installation. (In preview period. See README.)"
1851 },
1852 "getMarketplaceListingPlans": {
1853 "url": "/marketplace_listing/plans",
1854 "method": "GET",
1855 "headers": {
1856 "accept": "application/vnd.github.valkyrie-preview+json"
1857 },
1858 "params": {
1859 "page": {
1860 "type": "number",
1861 "description": "Page number of the results to fetch."
1862 },
1863 "per_page": {
1864 "type": "number",
1865 "default": "30",
1866 "description": "A custom page size up to 100. Default is 30."
1867 }
1868 },
1869 "description": "List all plans for your Marketplace listing. (In preview period. See README.)"
1870 },
1871 "getMarketplaceListingStubbedPlans": {
1872 "url": "/marketplace_listing/stubbed/plans",
1873 "method": "GET",
1874 "headers": {
1875 "accept": "application/vnd.github.valkyrie-preview+json"
1876 },
1877 "params": {
1878 "page": {
1879 "type": "number",
1880 "description": "Page number of the results to fetch."
1881 },
1882 "per_page": {
1883 "type": "number",
1884 "default": "30",
1885 "description": "A custom page size up to 100. Default is 30."
1886 }
1887 },
1888 "description": "List all stubbed plans for your Marketplace listing. (In preview period. See README.)"
1889 },
1890 "getMarketplaceListingPlanAccounts": {
1891 "url": "/marketplace_listing/plans/:id/accounts",
1892 "method": "GET",
1893 "headers": {
1894 "accept": "application/vnd.github.valkyrie-preview+json"
1895 },
1896 "params": {
1897 "id": {
1898 "type": "string",
1899 "required": true
1900 },
1901 "page": {
1902 "type": "number",
1903 "description": "Page number of the results to fetch."
1904 },
1905 "per_page": {
1906 "type": "number",
1907 "default": "30",
1908 "description": "A custom page size up to 100. Default is 30."
1909 }
1910 },
1911 "description": "List all GitHub accounts (user or organization) on a specific plan. (In preview period. See README.)"
1912 },
1913 "getMarketplaceListingStubbedPlanAccounts": {
1914 "url": "/marketplace_listing/stubbed/plans/:id/accounts",
1915 "method": "GET",
1916 "headers": {
1917 "accept": "application/vnd.github.valkyrie-preview+json"
1918 },
1919 "params": {
1920 "id": {
1921 "type": "string",
1922 "required": true
1923 },
1924 "page": {
1925 "type": "number",
1926 "description": "Page number of the results to fetch."
1927 },
1928 "per_page": {
1929 "type": "number",
1930 "default": "30",
1931 "description": "A custom page size up to 100. Default is 30."
1932 }
1933 },
1934 "description": "List all GitHub accounts (user or organization) on a specific stubbed plan. (In preview period. See README.)"
1935 },
1936 "checkMarketplaceListingAccount": {
1937 "url": "/marketplace_listing/accounts/:id",
1938 "method": "GET",
1939 "headers": {
1940 "accept": "application/vnd.github.valkyrie-preview+json"
1941 },
1942 "params": {
1943 "id": {
1944 "type": "string",
1945 "required": true
1946 }
1947 },
1948 "description": "Check if a GitHub account is associated with any Marketplace listing. (In preview period. See README.)"
1949 },
1950 "checkMarketplaceListingStubbedAccount": {
1951 "url": "/marketplace_listing/stubbed/accounts/:id",
1952 "method": "GET",
1953 "headers": {
1954 "accept": "application/vnd.github.valkyrie-preview+json"
1955 },
1956 "params": {
1957 "id": {
1958 "type": "string",
1959 "required": true
1960 }
1961 },
1962 "description": "Check if a stubbed GitHub account is associated with any Marketplace listing. (In preview period. See README.)"
1963 }
1964 },
1965 "issues": {
1966 "get": {
1967 "url": "/repos/:owner/:repo/issues/:number",
1968 "method": "GET",
1969 "headers": {
1970 "accept": "application/vnd.github.squirrel-girl-preview"
1971 },
1972 "params": {
1973 "owner": {
1974 "type": "string",
1975 "required": true
1976 },
1977 "repo": {
1978 "type": "string",
1979 "required": true
1980 },
1981 "number": {
1982 "type": "number",
1983 "required": true
1984 }
1985 },
1986 "description": "Get a single issue"
1987 },
1988 "create": {
1989 "url": "/repos/:owner/:repo/issues",
1990 "method": "POST",
1991 "headers": {
1992 "accept": "application/vnd.github.squirrel-girl-preview"
1993 },
1994 "params": {
1995 "owner": {
1996 "type": "string",
1997 "required": true
1998 },
1999 "repo": {
2000 "type": "string",
2001 "required": true
2002 },
2003 "title": {
2004 "type": "string",
2005 "required": true
2006 },
2007 "body": {
2008 "type": "string"
2009 },
2010 "assignee": {
2011 "type": "string",
2012 "description": "Login for the user that this issue should be assigned to."
2013 },
2014 "milestone": {
2015 "type": "number",
2016 "description": "Milestone to associate this issue with."
2017 },
2018 "labels": {
2019 "type": "string[]",
2020 "description": "Array of strings - Labels to associate with this issue."
2021 },
2022 "assignees": {
2023 "type": "string[]",
2024 "description": "Logins for Users to assign to this issue. NOTE: Only users with push access can set assignees for new issues. Assignees are silently dropped otherwise."
2025 }
2026 },
2027 "description": "Create an issue"
2028 },
2029 "edit": {
2030 "url": "/repos/:owner/:repo/issues/:number",
2031 "method": "PATCH",
2032 "headers": {
2033 "accept": "application/vnd.github.squirrel-girl-preview"
2034 },
2035 "params": {
2036 "owner": {
2037 "type": "string",
2038 "required": true
2039 },
2040 "repo": {
2041 "type": "string",
2042 "required": true
2043 },
2044 "number": {
2045 "type": "number",
2046 "required": true
2047 },
2048 "title": {
2049 "type": "string"
2050 },
2051 "body": {
2052 "type": "string"
2053 },
2054 "assignee": {
2055 "type": "string",
2056 "description": "Login for the user that this issue should be assigned to."
2057 },
2058 "state": {
2059 "type": "string",
2060 "enum": [
2061 "open",
2062 "closed"
2063 ],
2064 "default": "open",
2065 "description": "open or closed"
2066 },
2067 "milestone": {
2068 "type": "number",
2069 "description": "Milestone to associate this issue with."
2070 },
2071 "labels": {
2072 "type": "string[]",
2073 "description": "Array of strings - Labels to associate with this issue."
2074 },
2075 "assignees": {
2076 "type": "string[]",
2077 "description": "Logins for Users to assign to this issue. NOTE: Only users with push access can set assignees for new issues. Assignees are silently dropped otherwise."
2078 }
2079 },
2080 "description": "Edit an issue"
2081 },
2082 "lock": {
2083 "url": "/repos/:owner/:repo/issues/:number/lock",
2084 "method": "PUT",
2085 "params": {
2086 "owner": {
2087 "type": "string",
2088 "required": true
2089 },
2090 "repo": {
2091 "type": "string",
2092 "required": true
2093 },
2094 "number": {
2095 "type": "number",
2096 "required": true
2097 }
2098 },
2099 "description": "Users with push access can lock an issue's conversation."
2100 },
2101 "unlock": {
2102 "url": "/repos/:owner/:repo/issues/:number/lock",
2103 "method": "DELETE",
2104 "params": {
2105 "owner": {
2106 "type": "string",
2107 "required": true
2108 },
2109 "repo": {
2110 "type": "string",
2111 "required": true
2112 },
2113 "number": {
2114 "type": "number",
2115 "required": true
2116 }
2117 },
2118 "description": "Users with push access can unlock an issue's conversation."
2119 },
2120 "getAll": {
2121 "url": "/issues",
2122 "method": "GET",
2123 "headers": {
2124 "accept": "application/vnd.github.squirrel-girl-preview"
2125 },
2126 "params": {
2127 "filter": {
2128 "type": "string",
2129 "enum": [
2130 "all",
2131 "assigned",
2132 "created",
2133 "mentioned",
2134 "subscribed"
2135 ]
2136 },
2137 "state": {
2138 "type": "string",
2139 "enum": [
2140 "open",
2141 "closed",
2142 "all"
2143 ],
2144 "default": "open",
2145 "description": "open, closed, or all"
2146 },
2147 "labels": {
2148 "type": "string",
2149 "description": "String list of comma separated Label names. Example: bug,ui,@high"
2150 },
2151 "sort": {
2152 "type": "string",
2153 "enum": [
2154 "created",
2155 "updated",
2156 "comments"
2157 ],
2158 "default": "created"
2159 },
2160 "direction": {
2161 "type": "string",
2162 "enum": [
2163 "asc",
2164 "desc"
2165 ],
2166 "default": "desc"
2167 },
2168 "since": {
2169 "type": "date",
2170 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
2171 },
2172 "page": {
2173 "type": "number",
2174 "description": "Page number of the results to fetch."
2175 },
2176 "per_page": {
2177 "type": "number",
2178 "default": "30",
2179 "description": "A custom page size up to 100. Default is 30."
2180 }
2181 },
2182 "description": "List all issues across all the authenticated user's visible repositories including owned repositories, member repositories, and organization repositories"
2183 },
2184 "getForUser": {
2185 "url": "/user/issues",
2186 "method": "GET",
2187 "headers": {
2188 "accept": "application/vnd.github.squirrel-girl-preview"
2189 },
2190 "params": {
2191 "filter": {
2192 "type": "string",
2193 "enum": [
2194 "all",
2195 "assigned",
2196 "created",
2197 "mentioned",
2198 "subscribed"
2199 ]
2200 },
2201 "state": {
2202 "type": "string",
2203 "enum": [
2204 "open",
2205 "closed",
2206 "all"
2207 ],
2208 "default": "open",
2209 "description": "open, closed, or all"
2210 },
2211 "labels": {
2212 "type": "string",
2213 "description": "String list of comma separated Label names. Example: bug,ui,@high"
2214 },
2215 "sort": {
2216 "type": "string",
2217 "enum": [
2218 "created",
2219 "updated",
2220 "comments"
2221 ],
2222 "default": "created"
2223 },
2224 "direction": {
2225 "type": "string",
2226 "enum": [
2227 "asc",
2228 "desc"
2229 ],
2230 "default": "desc"
2231 },
2232 "since": {
2233 "type": "date",
2234 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
2235 },
2236 "page": {
2237 "type": "number",
2238 "description": "Page number of the results to fetch."
2239 },
2240 "per_page": {
2241 "type": "number",
2242 "default": "30",
2243 "description": "A custom page size up to 100. Default is 30."
2244 }
2245 },
2246 "description": "List all issues across owned and member repositories for the authenticated user"
2247 },
2248 "getForOrg": {
2249 "url": "/orgs/:org/issues",
2250 "method": "GET",
2251 "headers": {
2252 "accept": "application/vnd.github.squirrel-girl-preview"
2253 },
2254 "params": {
2255 "org": {
2256 "type": "string",
2257 "required": true
2258 },
2259 "filter": {
2260 "type": "string",
2261 "enum": [
2262 "all",
2263 "assigned",
2264 "created",
2265 "mentioned",
2266 "subscribed"
2267 ]
2268 },
2269 "state": {
2270 "type": "string",
2271 "enum": [
2272 "open",
2273 "closed",
2274 "all"
2275 ],
2276 "default": "open",
2277 "description": "open, closed, or all"
2278 },
2279 "labels": {
2280 "type": "string",
2281 "description": "String list of comma separated Label names. Example: bug,ui,@high"
2282 },
2283 "sort": {
2284 "type": "string",
2285 "enum": [
2286 "created",
2287 "updated",
2288 "comments"
2289 ],
2290 "default": "created"
2291 },
2292 "direction": {
2293 "type": "string",
2294 "enum": [
2295 "asc",
2296 "desc"
2297 ],
2298 "default": "desc"
2299 },
2300 "since": {
2301 "type": "date",
2302 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
2303 },
2304 "page": {
2305 "type": "number",
2306 "description": "Page number of the results to fetch."
2307 },
2308 "per_page": {
2309 "type": "number",
2310 "default": "30",
2311 "description": "A custom page size up to 100. Default is 30."
2312 }
2313 },
2314 "description": "List all issues for a given organization for the authenticated user"
2315 },
2316 "getForRepo": {
2317 "url": "/repos/:owner/:repo/issues",
2318 "method": "GET",
2319 "headers": {
2320 "accept": "application/vnd.github.squirrel-girl-preview"
2321 },
2322 "params": {
2323 "owner": {
2324 "type": "string",
2325 "required": true
2326 },
2327 "repo": {
2328 "type": "string",
2329 "required": true
2330 },
2331 "milestone": {
2332 "type": "string",
2333 "validation": "^([0-9]+|none|\\*)$"
2334 },
2335 "state": {
2336 "type": "string",
2337 "enum": [
2338 "open",
2339 "closed",
2340 "all"
2341 ],
2342 "default": "open",
2343 "description": "open, closed, or all"
2344 },
2345 "assignee": {
2346 "type": "string",
2347 "description": "String User login, `none` for Issues with no assigned User. `*` for Issues with any assigned User."
2348 },
2349 "creator": {
2350 "type": "string",
2351 "description": "The user that created the issue."
2352 },
2353 "mentioned": {
2354 "type": "string",
2355 "description": "String User login."
2356 },
2357 "labels": {
2358 "type": "string",
2359 "description": "String list of comma separated Label names. Example: bug,ui,@high"
2360 },
2361 "sort": {
2362 "type": "string",
2363 "enum": [
2364 "created",
2365 "updated",
2366 "comments"
2367 ],
2368 "default": "created"
2369 },
2370 "direction": {
2371 "type": "string",
2372 "enum": [
2373 "asc",
2374 "desc"
2375 ],
2376 "default": "desc"
2377 },
2378 "since": {
2379 "type": "date",
2380 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
2381 },
2382 "page": {
2383 "type": "number",
2384 "description": "Page number of the results to fetch."
2385 },
2386 "per_page": {
2387 "type": "number",
2388 "default": "30",
2389 "description": "A custom page size up to 100. Default is 30."
2390 }
2391 },
2392 "description": "List issues for a repository"
2393 },
2394 "getAssignees": {
2395 "url": "/repos/:owner/:repo/assignees",
2396 "method": "GET",
2397 "params": {
2398 "owner": {
2399 "type": "string",
2400 "required": true
2401 },
2402 "repo": {
2403 "type": "string",
2404 "required": true
2405 }
2406 },
2407 "description": "List assignees"
2408 },
2409 "checkAssignee": {
2410 "url": "/repos/:owner/:repo/assignees/:assignee",
2411 "method": "GET",
2412 "params": {
2413 "owner": {
2414 "type": "string",
2415 "required": true
2416 },
2417 "repo": {
2418 "type": "string",
2419 "required": true
2420 },
2421 "assignee": {
2422 "type": "string",
2423 "required": true,
2424 "description": "Login for the user that this issue should be assigned to."
2425 }
2426 },
2427 "description": "Check assignee"
2428 },
2429 "addAssigneesToIssue": {
2430 "url": "/repos/:owner/:repo/issues/:number/assignees",
2431 "method": "POST",
2432 "params": {
2433 "owner": {
2434 "type": "string",
2435 "required": true
2436 },
2437 "repo": {
2438 "type": "string",
2439 "required": true
2440 },
2441 "number": {
2442 "type": "number",
2443 "required": true
2444 },
2445 "assignees": {
2446 "type": "string[]",
2447 "required": true,
2448 "description": "Logins for the users that should be added to the issue."
2449 }
2450 },
2451 "description": "Add assignees to an issue."
2452 },
2453 "removeAssigneesFromIssue": {
2454 "url": "/repos/:owner/:repo/issues/:number/assignees",
2455 "method": "DELETE",
2456 "params": {
2457 "owner": {
2458 "type": "string",
2459 "required": true
2460 },
2461 "repo": {
2462 "type": "string",
2463 "required": true
2464 },
2465 "number": {
2466 "type": "number",
2467 "required": true
2468 },
2469 "body": {
2470 "type": "json",
2471 "required": true
2472 }
2473 },
2474 "description": "Remove assignees from an issue."
2475 },
2476 "getComments": {
2477 "url": "/repos/:owner/:repo/issues/:number/comments",
2478 "method": "GET",
2479 "headers": {
2480 "accept": "application/vnd.github.squirrel-girl-preview"
2481 },
2482 "params": {
2483 "owner": {
2484 "type": "string",
2485 "required": true
2486 },
2487 "repo": {
2488 "type": "string",
2489 "required": true
2490 },
2491 "number": {
2492 "type": "number",
2493 "required": true
2494 },
2495 "since": {
2496 "type": "date",
2497 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
2498 },
2499 "page": {
2500 "type": "number",
2501 "description": "Page number of the results to fetch."
2502 },
2503 "per_page": {
2504 "type": "number",
2505 "default": "30",
2506 "description": "A custom page size up to 100. Default is 30."
2507 }
2508 },
2509 "description": "List comments on an issue"
2510 },
2511 "getCommentsForRepo": {
2512 "url": "/repos/:owner/:repo/issues/comments",
2513 "method": "GET",
2514 "headers": {
2515 "accept": "application/vnd.github.squirrel-girl-preview"
2516 },
2517 "params": {
2518 "owner": {
2519 "type": "string",
2520 "required": true
2521 },
2522 "repo": {
2523 "type": "string",
2524 "required": true
2525 },
2526 "sort": {
2527 "type": "string",
2528 "enum": [
2529 "created",
2530 "updated"
2531 ],
2532 "default": "created"
2533 },
2534 "direction": {
2535 "type": "string",
2536 "enum": [
2537 "asc",
2538 "desc"
2539 ],
2540 "default": "desc"
2541 },
2542 "since": {
2543 "type": "date",
2544 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
2545 },
2546 "page": {
2547 "type": "number",
2548 "description": "Page number of the results to fetch."
2549 },
2550 "per_page": {
2551 "type": "number",
2552 "default": "30",
2553 "description": "A custom page size up to 100. Default is 30."
2554 }
2555 },
2556 "description": "List comments in a repository"
2557 },
2558 "getComment": {
2559 "url": "/repos/:owner/:repo/issues/comments/:id",
2560 "method": "GET",
2561 "headers": {
2562 "accept": "application/vnd.github.squirrel-girl-preview"
2563 },
2564 "params": {
2565 "owner": {
2566 "type": "string",
2567 "required": true
2568 },
2569 "repo": {
2570 "type": "string",
2571 "required": true
2572 },
2573 "id": {
2574 "type": "string",
2575 "required": true
2576 }
2577 },
2578 "description": "Get a single comment"
2579 },
2580 "createComment": {
2581 "url": "/repos/:owner/:repo/issues/:number/comments",
2582 "method": "POST",
2583 "headers": {
2584 "accept": "application/vnd.github.squirrel-girl-preview"
2585 },
2586 "params": {
2587 "owner": {
2588 "type": "string",
2589 "required": true
2590 },
2591 "repo": {
2592 "type": "string",
2593 "required": true
2594 },
2595 "number": {
2596 "type": "number",
2597 "required": true
2598 },
2599 "body": {
2600 "type": "string",
2601 "required": true
2602 }
2603 },
2604 "description": "Create a comment"
2605 },
2606 "editComment": {
2607 "url": "/repos/:owner/:repo/issues/comments/:id",
2608 "method": "PATCH",
2609 "headers": {
2610 "accept": "application/vnd.github.squirrel-girl-preview"
2611 },
2612 "params": {
2613 "owner": {
2614 "type": "string",
2615 "required": true
2616 },
2617 "repo": {
2618 "type": "string",
2619 "required": true
2620 },
2621 "id": {
2622 "type": "string",
2623 "required": true
2624 },
2625 "body": {
2626 "type": "string",
2627 "required": true
2628 }
2629 },
2630 "description": "Edit a comment"
2631 },
2632 "deleteComment": {
2633 "url": "/repos/:owner/:repo/issues/comments/:id",
2634 "method": "DELETE",
2635 "headers": {
2636 "accept": "application/vnd.github.squirrel-girl-preview"
2637 },
2638 "params": {
2639 "owner": {
2640 "type": "string",
2641 "required": true
2642 },
2643 "repo": {
2644 "type": "string",
2645 "required": true
2646 },
2647 "id": {
2648 "type": "string",
2649 "required": true
2650 }
2651 },
2652 "description": "Delete a comment"
2653 },
2654 "getEvents": {
2655 "url": "/repos/:owner/:repo/issues/:issue_number/events",
2656 "method": "GET",
2657 "params": {
2658 "owner": {
2659 "type": "string",
2660 "required": true
2661 },
2662 "repo": {
2663 "type": "string",
2664 "required": true
2665 },
2666 "issue_number": {
2667 "type": "number",
2668 "required": true
2669 },
2670 "page": {
2671 "type": "number",
2672 "description": "Page number of the results to fetch."
2673 },
2674 "per_page": {
2675 "type": "number",
2676 "default": "30",
2677 "description": "A custom page size up to 100. Default is 30."
2678 }
2679 },
2680 "description": "List events for an issue"
2681 },
2682 "getEventsForRepo": {
2683 "url": "/repos/:owner/:repo/issues/events",
2684 "method": "GET",
2685 "params": {
2686 "owner": {
2687 "type": "string",
2688 "required": true
2689 },
2690 "repo": {
2691 "type": "string",
2692 "required": true
2693 },
2694 "page": {
2695 "type": "number",
2696 "description": "Page number of the results to fetch."
2697 },
2698 "per_page": {
2699 "type": "number",
2700 "default": "30",
2701 "description": "A custom page size up to 100. Default is 30."
2702 }
2703 },
2704 "description": "List events for a repository"
2705 },
2706 "getEvent": {
2707 "url": "/repos/:owner/:repo/issues/events/:id",
2708 "method": "GET",
2709 "params": {
2710 "owner": {
2711 "type": "string",
2712 "required": true
2713 },
2714 "repo": {
2715 "type": "string",
2716 "required": true
2717 },
2718 "id": {
2719 "type": "string",
2720 "required": true
2721 }
2722 },
2723 "description": "Get a single event"
2724 },
2725 "getLabels": {
2726 "url": "/repos/:owner/:repo/labels",
2727 "method": "GET",
2728 "params": {
2729 "owner": {
2730 "type": "string",
2731 "required": true
2732 },
2733 "repo": {
2734 "type": "string",
2735 "required": true
2736 },
2737 "page": {
2738 "type": "number",
2739 "description": "Page number of the results to fetch."
2740 },
2741 "per_page": {
2742 "type": "number",
2743 "default": "30",
2744 "description": "A custom page size up to 100. Default is 30."
2745 }
2746 },
2747 "description": "List all labels for this repository"
2748 },
2749 "getLabel": {
2750 "url": "/repos/:owner/:repo/labels/:name",
2751 "method": "GET",
2752 "params": {
2753 "owner": {
2754 "type": "string",
2755 "required": true
2756 },
2757 "repo": {
2758 "type": "string",
2759 "required": true
2760 },
2761 "name": {
2762 "type": "string",
2763 "required": true
2764 }
2765 },
2766 "description": "Get a single label"
2767 },
2768 "createLabel": {
2769 "url": "/repos/:owner/:repo/labels",
2770 "method": "POST",
2771 "params": {
2772 "owner": {
2773 "type": "string",
2774 "required": true
2775 },
2776 "repo": {
2777 "type": "string",
2778 "required": true
2779 },
2780 "name": {
2781 "type": "string",
2782 "required": true
2783 },
2784 "color": {
2785 "type": "string",
2786 "required": true,
2787 "description": "6 character hex code, without a leading #."
2788 }
2789 },
2790 "description": "Create a label"
2791 },
2792 "updateLabel": {
2793 "url": "/repos/:owner/:repo/labels/:oldname",
2794 "method": "PATCH",
2795 "params": {
2796 "owner": {
2797 "type": "string",
2798 "required": true
2799 },
2800 "repo": {
2801 "type": "string",
2802 "required": true
2803 },
2804 "oldname": {
2805 "type": "string",
2806 "required": true,
2807 "description": "The old name of the label."
2808 },
2809 "name": {
2810 "type": "string",
2811 "required": true,
2812 "description": "The new name of the label."
2813 },
2814 "color": {
2815 "type": "string",
2816 "required": true,
2817 "description": "6 character hex code, without a leading #."
2818 }
2819 },
2820 "description": "Update a label"
2821 },
2822 "deleteLabel": {
2823 "url": "/repos/:owner/:repo/labels/:name",
2824 "method": "DELETE",
2825 "params": {
2826 "owner": {
2827 "type": "string",
2828 "required": true
2829 },
2830 "repo": {
2831 "type": "string",
2832 "required": true
2833 },
2834 "name": {
2835 "type": "string",
2836 "required": true
2837 }
2838 },
2839 "description": "Delete a label"
2840 },
2841 "getIssueLabels": {
2842 "url": "/repos/:owner/:repo/issues/:number/labels",
2843 "method": "GET",
2844 "params": {
2845 "owner": {
2846 "type": "string",
2847 "required": true
2848 },
2849 "repo": {
2850 "type": "string",
2851 "required": true
2852 },
2853 "number": {
2854 "type": "number",
2855 "required": true
2856 }
2857 },
2858 "description": "List labels on an issue"
2859 },
2860 "addLabels": {
2861 "url": "/repos/:owner/:repo/issues/:number/labels",
2862 "method": "POST",
2863 "params": {
2864 "owner": {
2865 "type": "string",
2866 "required": true
2867 },
2868 "repo": {
2869 "type": "string",
2870 "required": true
2871 },
2872 "number": {
2873 "type": "number",
2874 "required": true
2875 },
2876 "labels": {
2877 "type": "string[]",
2878 "required": true,
2879 "mapTo": "input"
2880 }
2881 },
2882 "description": "Add labels to an issue"
2883 },
2884 "removeLabel": {
2885 "url": "/repos/:owner/:repo/issues/:number/labels/:name",
2886 "method": "DELETE",
2887 "params": {
2888 "owner": {
2889 "type": "string",
2890 "required": true
2891 },
2892 "repo": {
2893 "type": "string",
2894 "required": true
2895 },
2896 "number": {
2897 "type": "number",
2898 "required": true
2899 },
2900 "name": {
2901 "type": "string",
2902 "required": true
2903 }
2904 },
2905 "description": "Remove a label from an issue"
2906 },
2907 "replaceAllLabels": {
2908 "url": "/repos/:owner/:repo/issues/:number/labels",
2909 "method": "PUT",
2910 "params": {
2911 "owner": {
2912 "type": "string",
2913 "required": true
2914 },
2915 "repo": {
2916 "type": "string",
2917 "required": true
2918 },
2919 "number": {
2920 "type": "number",
2921 "required": true
2922 },
2923 "labels": {
2924 "type": "string[]",
2925 "required": true,
2926 "mapTo": "input",
2927 "description": "Sending an empty array ([]) will remove all Labels from the Issue."
2928 }
2929 },
2930 "description": "Replace all labels for an issue"
2931 },
2932 "removeAllLabels": {
2933 "url": "/repos/:owner/:repo/issues/:number/labels",
2934 "method": "DELETE",
2935 "params": {
2936 "owner": {
2937 "type": "string",
2938 "required": true
2939 },
2940 "repo": {
2941 "type": "string",
2942 "required": true
2943 },
2944 "number": {
2945 "type": "number",
2946 "required": true
2947 }
2948 },
2949 "description": "Remove all labels from an issue"
2950 },
2951 "getMilestoneLabels": {
2952 "url": "/repos/:owner/:repo/milestones/:number/labels",
2953 "method": "GET",
2954 "params": {
2955 "owner": {
2956 "type": "string",
2957 "required": true
2958 },
2959 "repo": {
2960 "type": "string",
2961 "required": true
2962 },
2963 "number": {
2964 "type": "number",
2965 "required": true
2966 }
2967 },
2968 "description": "Get labels for every issue in a milestone"
2969 },
2970 "getMilestones": {
2971 "url": "/repos/:owner/:repo/milestones",
2972 "method": "GET",
2973 "params": {
2974 "owner": {
2975 "type": "string",
2976 "required": true
2977 },
2978 "repo": {
2979 "type": "string",
2980 "required": true
2981 },
2982 "state": {
2983 "type": "string",
2984 "enum": [
2985 "open",
2986 "closed",
2987 "all"
2988 ],
2989 "default": "open"
2990 },
2991 "sort": {
2992 "type": "string",
2993 "enum": [
2994 "due_on",
2995 "completeness"
2996 ],
2997 "default": "due_on",
2998 "description": "due_on, completeness, default: due_on"
2999 },
3000 "direction": {
3001 "type": "string",
3002 "enum": [
3003 "asc",
3004 "desc"
3005 ],
3006 "default": "asc"
3007 },
3008 "page": {
3009 "type": "number",
3010 "description": "Page number of the results to fetch."
3011 },
3012 "per_page": {
3013 "type": "number",
3014 "default": "30",
3015 "description": "A custom page size up to 100. Default is 30."
3016 }
3017 },
3018 "description": "List milestones for a repository"
3019 },
3020 "getMilestone": {
3021 "url": "/repos/:owner/:repo/milestones/:number",
3022 "method": "GET",
3023 "params": {
3024 "owner": {
3025 "type": "string",
3026 "required": true
3027 },
3028 "repo": {
3029 "type": "string",
3030 "required": true
3031 },
3032 "number": {
3033 "type": "number",
3034 "required": true
3035 }
3036 },
3037 "description": "Get a single milestone"
3038 },
3039 "createMilestone": {
3040 "url": "/repos/:owner/:repo/milestones",
3041 "method": "POST",
3042 "params": {
3043 "owner": {
3044 "type": "string",
3045 "required": true
3046 },
3047 "repo": {
3048 "type": "string",
3049 "required": true
3050 },
3051 "title": {
3052 "type": "string",
3053 "required": true
3054 },
3055 "state": {
3056 "type": "string",
3057 "enum": [
3058 "open",
3059 "closed",
3060 "all"
3061 ],
3062 "default": "open"
3063 },
3064 "description": {
3065 "type": "string"
3066 },
3067 "due_on": {
3068 "type": "date",
3069 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
3070 }
3071 },
3072 "description": "Create a milestone"
3073 },
3074 "updateMilestone": {
3075 "url": "/repos/:owner/:repo/milestones/:number",
3076 "method": "PATCH",
3077 "params": {
3078 "owner": {
3079 "type": "string",
3080 "required": true
3081 },
3082 "repo": {
3083 "type": "string",
3084 "required": true
3085 },
3086 "number": {
3087 "type": "number",
3088 "required": true
3089 },
3090 "title": {
3091 "type": "string",
3092 "required": true
3093 },
3094 "state": {
3095 "type": "string",
3096 "enum": [
3097 "open",
3098 "closed",
3099 "all"
3100 ],
3101 "default": "open"
3102 },
3103 "description": {
3104 "type": "string"
3105 },
3106 "due_on": {
3107 "type": "date",
3108 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
3109 }
3110 },
3111 "description": "Update a milestone"
3112 },
3113 "deleteMilestone": {
3114 "url": "/repos/:owner/:repo/milestones/:number",
3115 "method": "DELETE",
3116 "params": {
3117 "owner": {
3118 "type": "string",
3119 "required": true
3120 },
3121 "repo": {
3122 "type": "string",
3123 "required": true
3124 },
3125 "number": {
3126 "type": "number",
3127 "required": true
3128 }
3129 },
3130 "description": "Delete a milestone"
3131 },
3132 "getEventsTimeline": {
3133 "url": "/repos/:owner/:repo/issues/:issue_number/timeline",
3134 "method": "GET",
3135 "headers": {
3136 "accept": "application/vnd.github.mockingbird-preview"
3137 },
3138 "params": {
3139 "owner": {
3140 "type": "string",
3141 "required": true
3142 },
3143 "repo": {
3144 "type": "string",
3145 "required": true
3146 },
3147 "issue_number": {
3148 "type": "number",
3149 "required": true
3150 },
3151 "page": {
3152 "type": "number",
3153 "description": "Page number of the results to fetch."
3154 },
3155 "per_page": {
3156 "type": "number",
3157 "default": "30",
3158 "description": "A custom page size up to 100. Default is 30."
3159 }
3160 },
3161 "description": "List events for an issue. (In preview period. See README.)"
3162 }
3163 },
3164 "migrations": {
3165 "startMigration": {
3166 "url": "/orgs/:org/migrations",
3167 "method": "POST",
3168 "headers": {
3169 "accept": "application/vnd.github.wyandotte-preview+json"
3170 },
3171 "params": {
3172 "org": {
3173 "type": "string",
3174 "required": true
3175 },
3176 "repositories": {
3177 "type": "string[]",
3178 "required": true,
3179 "description": "A list of arrays indicating which repositories should be migrated."
3180 },
3181 "lock_repositories": {
3182 "type": "boolean",
3183 "default": "false",
3184 "description": "Indicates whether repositories should be locked (to prevent manipulation) while migrating data. Default: false."
3185 },
3186 "exclude_attachments": {
3187 "type": "boolean",
3188 "default": "false",
3189 "description": "Indicates whether attachments should be excluded from the migration (to reduce migration archive file size). Default: false."
3190 }
3191 },
3192 "description": "Start a migration. (In preview period. See README.)"
3193 },
3194 "getMigrations": {
3195 "url": "/orgs/:org/migrations",
3196 "method": "GET",
3197 "headers": {
3198 "accept": "application/vnd.github.wyandotte-preview+json"
3199 },
3200 "params": {
3201 "org": {
3202 "type": "string",
3203 "required": true
3204 },
3205 "page": {
3206 "type": "number",
3207 "description": "Page number of the results to fetch."
3208 },
3209 "per_page": {
3210 "type": "number",
3211 "default": "30",
3212 "description": "A custom page size up to 100. Default is 30."
3213 }
3214 },
3215 "description": "Get a list of migrations. (In preview period. See README.)"
3216 },
3217 "getMigrationStatus": {
3218 "url": "/orgs/:org/migrations/:id",
3219 "method": "GET",
3220 "headers": {
3221 "accept": "application/vnd.github.wyandotte-preview+json"
3222 },
3223 "params": {
3224 "org": {
3225 "type": "string",
3226 "required": true
3227 },
3228 "id": {
3229 "type": "string",
3230 "required": true
3231 }
3232 },
3233 "description": "Get the status of a migration. (In preview period. See README.)"
3234 },
3235 "getMigrationArchiveLink": {
3236 "url": "/orgs/:org/migrations/:id/archive",
3237 "method": "GET",
3238 "headers": {
3239 "accept": "application/vnd.github.wyandotte-preview+json"
3240 },
3241 "params": {
3242 "org": {
3243 "type": "string",
3244 "required": true
3245 },
3246 "id": {
3247 "type": "string",
3248 "required": true
3249 }
3250 },
3251 "description": "Get the URL to a migration archive. (In preview period. See README.)"
3252 },
3253 "deleteMigrationArchive": {
3254 "url": "/orgs/:org/migrations/:id/archive",
3255 "method": "DELETE",
3256 "headers": {
3257 "accept": "application/vnd.github.wyandotte-preview+json"
3258 },
3259 "params": {
3260 "org": {
3261 "type": "string",
3262 "required": true
3263 },
3264 "id": {
3265 "type": "string",
3266 "required": true
3267 }
3268 },
3269 "description": "Delete a migration archive. (In preview period. See README.)"
3270 },
3271 "unlockRepoLockedForMigration": {
3272 "url": "/orgs/:org/migrations/:id/repos/:repo_name/lock",
3273 "method": "DELETE",
3274 "headers": {
3275 "accept": "application/vnd.github.wyandotte-preview+json"
3276 },
3277 "params": {
3278 "org": {
3279 "type": "string",
3280 "required": true
3281 },
3282 "id": {
3283 "type": "string",
3284 "required": true
3285 },
3286 "repo_name": {
3287 "type": "string",
3288 "required": true
3289 }
3290 },
3291 "description": "Unlock a repository that was locked for migration. (In preview period. See README.)"
3292 },
3293 "startImport": {
3294 "url": "/repos/:owner/:repo/import",
3295 "method": "PUT",
3296 "headers": {
3297 "accept": "application/vnd.github.barred-rock-preview"
3298 },
3299 "params": {
3300 "owner": {
3301 "type": "string",
3302 "required": true
3303 },
3304 "repo": {
3305 "type": "string",
3306 "required": true
3307 },
3308 "vcs_url": {
3309 "type": "string",
3310 "required": true,
3311 "description": "The URL of the originating repository."
3312 },
3313 "vcs": {
3314 "type": "string",
3315 "enum": [
3316 "subversion",
3317 "git",
3318 "mercurial",
3319 "tfvc"
3320 ],
3321 "description": "The originating VCS type. Please be aware that without this parameter, the import job will take additional time to detect the VCS type before beginning the import. This detection step will be reflected in the response."
3322 },
3323 "vcs_username": {
3324 "type": "string",
3325 "description": "If authentication is required, the username to provide to vcs_url."
3326 },
3327 "vcs_password": {
3328 "type": "string",
3329 "description": "If authentication is required, the password to provide to vcs_url."
3330 },
3331 "tfvc_project": {
3332 "type": "string",
3333 "description": "For a tfvc import, the name of the project that is being imported."
3334 }
3335 },
3336 "description": "Start an import. (In preview period. See README.)"
3337 },
3338 "getImportProgress": {
3339 "url": "/repos/:owner/:repo/import",
3340 "method": "GET",
3341 "headers": {
3342 "accept": "application/vnd.github.barred-rock-preview"
3343 },
3344 "params": {
3345 "owner": {
3346 "type": "string",
3347 "required": true
3348 },
3349 "repo": {
3350 "type": "string",
3351 "required": true
3352 }
3353 },
3354 "description": "Get import progress. (In preview period. See README.)"
3355 },
3356 "updateImport": {
3357 "url": "/repos/:owner/:repo/import",
3358 "method": "PATCH",
3359 "headers": {
3360 "accept": "application/vnd.github.barred-rock-preview"
3361 },
3362 "params": {
3363 "owner": {
3364 "type": "string",
3365 "required": true
3366 },
3367 "repo": {
3368 "type": "string",
3369 "required": true
3370 },
3371 "vcs_username": {
3372 "type": "string",
3373 "description": "The username to provide to the originating repository."
3374 },
3375 "vcs_password": {
3376 "type": "string",
3377 "description": "The password to provide to the originating repository."
3378 }
3379 },
3380 "description": "Update existing import. (In preview period. See README.)"
3381 },
3382 "getImportCommitAuthors": {
3383 "url": "/repos/:owner/:repo/import/authors",
3384 "method": "GET",
3385 "headers": {
3386 "accept": "application/vnd.github.barred-rock-preview"
3387 },
3388 "params": {
3389 "owner": {
3390 "type": "string",
3391 "required": true
3392 },
3393 "repo": {
3394 "type": "string",
3395 "required": true
3396 },
3397 "since": {
3398 "type": "string",
3399 "description": "Only authors found after this id are returned. Provide the highest author ID you've seen so far. New authors may be added to the list at any point while the importer is performing the raw step."
3400 }
3401 },
3402 "description": "Get import commit authors. (In preview period. See README.)"
3403 },
3404 "mapImportCommitAuthor": {
3405 "url": "/repos/:owner/:repo/import/authors/:author_id",
3406 "method": "PATCH",
3407 "headers": {
3408 "accept": "application/vnd.github.barred-rock-preview"
3409 },
3410 "params": {
3411 "owner": {
3412 "type": "string",
3413 "required": true
3414 },
3415 "repo": {
3416 "type": "string",
3417 "required": true
3418 },
3419 "author_id": {
3420 "type": "string",
3421 "required": true,
3422 "description": "The commit author id."
3423 },
3424 "email": {
3425 "type": "string",
3426 "description": "The new Git author email."
3427 },
3428 "name": {
3429 "type": "string",
3430 "description": "The new Git author name."
3431 }
3432 },
3433 "description": "Map a commit author. (In preview period. See README.)"
3434 },
3435 "setImportLfsPreference": {
3436 "url": "/:owner/:name/import/lfs",
3437 "method": "PATCH",
3438 "headers": {
3439 "accept": "application/vnd.github.barred-rock-preview"
3440 },
3441 "params": {
3442 "owner": {
3443 "type": "string",
3444 "required": true
3445 },
3446 "name": {
3447 "type": "string",
3448 "required": true
3449 },
3450 "use_lfs": {
3451 "type": "string",
3452 "required": true,
3453 "description": "Can be one of `opt_in` (large files will be stored using Git LFS) or `opt_out` (large files will be removed during the import)."
3454 }
3455 },
3456 "description": "Set import LFS preference. (In preview period. See README.)"
3457 },
3458 "getLargeImportFiles": {
3459 "url": "/:owner/:name/import/large_files",
3460 "method": "GET",
3461 "headers": {
3462 "accept": "application/vnd.github.barred-rock-preview"
3463 },
3464 "params": {
3465 "owner": {
3466 "type": "string",
3467 "required": true
3468 },
3469 "name": {
3470 "type": "string",
3471 "required": true
3472 }
3473 },
3474 "description": "List files larger than 100MB found during the import. (In preview period. See README.)"
3475 },
3476 "cancelImport": {
3477 "url": "/repos/:owner/:repo/import",
3478 "method": "DELETE",
3479 "headers": {
3480 "accept": "application/vnd.github.barred-rock-preview"
3481 },
3482 "params": {
3483 "owner": {
3484 "type": "string",
3485 "required": true
3486 },
3487 "repo": {
3488 "type": "string",
3489 "required": true
3490 }
3491 },
3492 "description": "Cancel an import. (In preview period. See README.)"
3493 }
3494 },
3495 "misc": {
3496 "getCodesOfConduct": {
3497 "url": "/codes_of_conduct",
3498 "method": "GET",
3499 "headers": {
3500 "accept": "application/vnd.github.scarlet-witch-preview+json"
3501 },
3502 "params": {},
3503 "description": "List all codes of conduct. (In preview period. See README.)"
3504 },
3505 "getCodeOfConduct": {
3506 "url": "/codes_of_conduct/:key",
3507 "method": "GET",
3508 "headers": {
3509 "accept": "application/vnd.github.scarlet-witch-preview+json"
3510 },
3511 "params": {
3512 "key": {
3513 "type": "string",
3514 "required": true,
3515 "description": "Ex: contributor_covenant"
3516 }
3517 },
3518 "description": "Get an code of conduct. (In preview period. See README.)"
3519 },
3520 "getRepoCodeOfConduct": {
3521 "url": "/repos/:owner/:repo/community/code_of_conduct",
3522 "method": "GET",
3523 "headers": {
3524 "accept": "application/vnd.github.scarlet-witch-preview+json"
3525 },
3526 "params": {
3527 "owner": {
3528 "type": "string",
3529 "required": true
3530 },
3531 "repo": {
3532 "type": "string",
3533 "required": true
3534 }
3535 },
3536 "description": "Get the contents of a repository's code of conduct. (In preview period. See README.)"
3537 },
3538 "getEmojis": {
3539 "url": "/emojis",
3540 "method": "GET",
3541 "params": {},
3542 "description": "Lists all the emojis available to use on GitHub."
3543 },
3544 "getGitignoreTemplates": {
3545 "url": "/gitignore/templates",
3546 "method": "GET",
3547 "params": {},
3548 "description": "Lists available gitignore templates"
3549 },
3550 "getGitignoreTemplate": {
3551 "url": "/gitignore/templates/:name",
3552 "method": "GET",
3553 "params": {
3554 "name": {
3555 "type": "string",
3556 "required": true,
3557 "description": "The name of the .gitignore template to get e.g. 'C'"
3558 }
3559 },
3560 "description": "Get a single gitignore template"
3561 },
3562 "getLicenses": {
3563 "url": "/licenses",
3564 "method": "GET",
3565 "headers": {
3566 "accept": "application/vnd.github.drax-preview+json"
3567 },
3568 "params": {},
3569 "description": "List all licenses. (In preview period. See README.)"
3570 },
3571 "getLicense": {
3572 "url": "/licenses/:license",
3573 "method": "GET",
3574 "headers": {
3575 "accept": "application/vnd.github.drax-preview+json"
3576 },
3577 "params": {
3578 "license": {
3579 "type": "string",
3580 "required": true,
3581 "description": "Ex: /licenses/mit"
3582 }
3583 },
3584 "description": "Get an individual license. (In preview period. See README.)"
3585 },
3586 "getRepoLicense": {
3587 "url": "/repos/:owner/:repo/license",
3588 "method": "GET",
3589 "headers": {
3590 "accept": "application/vnd.github.drax-preview+json"
3591 },
3592 "params": {
3593 "owner": {
3594 "type": "string",
3595 "required": true
3596 },
3597 "repo": {
3598 "type": "string",
3599 "required": true
3600 }
3601 },
3602 "description": "Get the contents of a repository's license. (In preview period. See README.)"
3603 },
3604 "renderMarkdown": {
3605 "url": "/markdown",
3606 "method": "POST",
3607 "params": {
3608 "text": {
3609 "type": "string",
3610 "required": true,
3611 "description": "The Markdown text to render"
3612 },
3613 "mode": {
3614 "type": "string",
3615 "enum": [
3616 "markdown",
3617 "gfm"
3618 ],
3619 "default": "markdown",
3620 "description": "The rendering mode, `markdown` to render a document as plain Markdown, just like README files are rendered. `gfm` to render a document as user-content, e.g. like user comments or issues are rendered. In GFM mode, hard line breaks are always taken into account, and issue and user mentions are linked accordingly."
3621 },
3622 "context": {
3623 "type": "string",
3624 "description": "The repository context. Only taken into account when rendering as `gfm`"
3625 }
3626 },
3627 "description": "Render an arbitrary Markdown document"
3628 },
3629 "renderMarkdownRaw": {
3630 "url": "/markdown/raw",
3631 "method": "POST",
3632 "headers": {
3633 "content-type": "text/plain; charset=utf-8"
3634 },
3635 "params": {
3636 "data": {
3637 "type": "string",
3638 "required": true,
3639 "mapTo": "input",
3640 "description": "Raw data to send as the body of the request"
3641 }
3642 },
3643 "description": "Render a Markdown document in raw mode"
3644 },
3645 "getMeta": {
3646 "url": "/meta",
3647 "method": "GET",
3648 "params": {},
3649 "description": "This endpoint provides information about GitHub.com, the service. Or, if you access this endpoint on your organization's GitHub Enterprise installation, this endpoint provides information about that installation."
3650 },
3651 "getRateLimit": {
3652 "url": "/rate_limit",
3653 "method": "GET",
3654 "params": {},
3655 "description": "Get your current rate limit status"
3656 }
3657 },
3658 "orgs": {
3659 "get": {
3660 "url": "/orgs/:org",
3661 "method": "GET",
3662 "params": {
3663 "org": {
3664 "type": "string",
3665 "required": true
3666 },
3667 "page": {
3668 "type": "number",
3669 "description": "Page number of the results to fetch."
3670 },
3671 "per_page": {
3672 "type": "number",
3673 "default": "30",
3674 "description": "A custom page size up to 100. Default is 30."
3675 }
3676 },
3677 "description": "Get an organization"
3678 },
3679 "update": {
3680 "url": "/orgs/:org",
3681 "method": "PATCH",
3682 "params": {
3683 "org": {
3684 "type": "string",
3685 "required": true
3686 },
3687 "billing_email": {
3688 "type": "string",
3689 "description": "Billing email address. This address is not publicized."
3690 },
3691 "company": {
3692 "type": "string",
3693 "description": "The company name."
3694 },
3695 "email": {
3696 "type": "string",
3697 "description": "The publicly visible email address."
3698 },
3699 "location": {
3700 "type": "string",
3701 "description": "The location."
3702 },
3703 "name": {
3704 "type": "string",
3705 "description": "The shorthand name of the company."
3706 },
3707 "description": {
3708 "type": "string",
3709 "description": "The description of the company."
3710 },
3711 "default_repository_permission": {
3712 "type": "string",
3713 "enum": [
3714 "read",
3715 "write",
3716 "admin",
3717 "none"
3718 ],
3719 "default": "read",
3720 "description": "Default permission level members have for organization repositories."
3721 },
3722 "members_can_create_repositories": {
3723 "type": "boolean",
3724 "default": true,
3725 "description": "Toggles ability of non-admin organization members to create repositories."
3726 }
3727 },
3728 "description": "Edit an organization"
3729 },
3730 "getAll": {
3731 "url": "/organizations",
3732 "method": "GET",
3733 "params": {
3734 "since": {
3735 "type": "string",
3736 "description": "The integer ID of the last Organization that you've seen."
3737 },
3738 "page": {
3739 "type": "number",
3740 "description": "Page number of the results to fetch."
3741 },
3742 "per_page": {
3743 "type": "number",
3744 "default": "30",
3745 "description": "A custom page size up to 100. Default is 30."
3746 }
3747 },
3748 "description": "List all organizations"
3749 },
3750 "getForUser": {
3751 "url": "/users/:username/orgs",
3752 "method": "GET",
3753 "params": {
3754 "username": {
3755 "type": "string",
3756 "required": true
3757 },
3758 "page": {
3759 "type": "number",
3760 "description": "Page number of the results to fetch."
3761 },
3762 "per_page": {
3763 "type": "number",
3764 "default": "30",
3765 "description": "A custom page size up to 100. Default is 30."
3766 }
3767 },
3768 "description": "List public organization memberships for the specified user."
3769 },
3770 "getMembers": {
3771 "url": "/orgs/:org/members",
3772 "method": "GET",
3773 "params": {
3774 "org": {
3775 "type": "string",
3776 "required": true
3777 },
3778 "filter": {
3779 "type": "string",
3780 "enum": [
3781 "all",
3782 "2fa_disabled"
3783 ],
3784 "default": "all",
3785 "description": "Filter members returned in the list."
3786 },
3787 "role": {
3788 "type": "string",
3789 "enum": [
3790 "all",
3791 "admin",
3792 "member"
3793 ],
3794 "default": "all",
3795 "description": "Filter members returned by their role."
3796 },
3797 "page": {
3798 "type": "number",
3799 "description": "Page number of the results to fetch."
3800 },
3801 "per_page": {
3802 "type": "number",
3803 "default": "30",
3804 "description": "A custom page size up to 100. Default is 30."
3805 }
3806 },
3807 "description": "Members list"
3808 },
3809 "checkMembership": {
3810 "url": "/orgs/:org/members/:username",
3811 "method": "GET",
3812 "params": {
3813 "org": {
3814 "type": "string",
3815 "required": true
3816 },
3817 "username": {
3818 "type": "string",
3819 "required": true
3820 }
3821 },
3822 "description": "Check membership"
3823 },
3824 "removeMember": {
3825 "url": "/orgs/:org/members/:username",
3826 "method": "DELETE",
3827 "params": {
3828 "org": {
3829 "type": "string",
3830 "required": true
3831 },
3832 "username": {
3833 "type": "string",
3834 "required": true
3835 }
3836 },
3837 "description": "Remove a member"
3838 },
3839 "getPublicMembers": {
3840 "url": "/orgs/:org/public_members",
3841 "method": "GET",
3842 "params": {
3843 "org": {
3844 "type": "string",
3845 "required": true
3846 }
3847 },
3848 "description": "Public members list"
3849 },
3850 "checkPublicMembership": {
3851 "url": "/orgs/:org/public_members/:username",
3852 "method": "GET",
3853 "params": {
3854 "org": {
3855 "type": "string",
3856 "required": true
3857 },
3858 "username": {
3859 "type": "string",
3860 "required": true
3861 }
3862 },
3863 "description": "Check public membership"
3864 },
3865 "publicizeMembership": {
3866 "url": "/orgs/:org/public_members/:username",
3867 "method": "PUT",
3868 "params": {
3869 "org": {
3870 "type": "string",
3871 "required": true
3872 },
3873 "username": {
3874 "type": "string",
3875 "required": true
3876 }
3877 },
3878 "description": "Publicize a user's membership"
3879 },
3880 "concealMembership": {
3881 "url": "/orgs/:org/public_members/:username",
3882 "method": "DELETE",
3883 "params": {
3884 "org": {
3885 "type": "string",
3886 "required": true
3887 },
3888 "username": {
3889 "type": "string",
3890 "required": true
3891 }
3892 },
3893 "description": "Conceal a user's membership"
3894 },
3895 "getOrgMembership": {
3896 "url": "/orgs/:org/memberships/:username",
3897 "method": "GET",
3898 "params": {
3899 "org": {
3900 "type": "string",
3901 "required": true
3902 },
3903 "username": {
3904 "type": "string",
3905 "required": true
3906 }
3907 },
3908 "description": "Get organization membership"
3909 },
3910 "addOrgMembership": {
3911 "url": "/orgs/:org/memberships/:username",
3912 "method": "PUT",
3913 "params": {
3914 "org": {
3915 "type": "string",
3916 "required": true
3917 },
3918 "username": {
3919 "type": "string",
3920 "required": true
3921 },
3922 "role": {
3923 "type": "string",
3924 "required": true,
3925 "enum": [
3926 "admin",
3927 "member"
3928 ],
3929 "default": "member",
3930 "description": "The role to give the user in the organization."
3931 }
3932 },
3933 "description": "Add or update organization membership"
3934 },
3935 "removeOrgMembership": {
3936 "url": "/orgs/:org/memberships/:username",
3937 "method": "DELETE",
3938 "params": {
3939 "org": {
3940 "type": "string",
3941 "required": true
3942 },
3943 "username": {
3944 "type": "string",
3945 "required": true
3946 }
3947 },
3948 "description": "Remove organization membership"
3949 },
3950 "getPendingOrgInvites": {
3951 "url": "/orgs/:org/invitations",
3952 "method": "GET",
3953 "params": {
3954 "org": {
3955 "type": "string",
3956 "required": true
3957 }
3958 },
3959 "description": "List pending organization invites."
3960 },
3961 "getOutsideCollaborators": {
3962 "url": "/orgs/:org/outside_collaborators",
3963 "method": "GET",
3964 "params": {
3965 "org": {
3966 "type": "string",
3967 "required": true
3968 },
3969 "filter": {
3970 "type": "string",
3971 "enum": [
3972 "all",
3973 "2fa_disabled"
3974 ],
3975 "default": "all",
3976 "description": "Filter the list of outside collaborators."
3977 },
3978 "page": {
3979 "type": "number",
3980 "description": "Page number of the results to fetch."
3981 },
3982 "per_page": {
3983 "type": "number",
3984 "default": "30",
3985 "description": "A custom page size up to 100. Default is 30."
3986 }
3987 },
3988 "description": "List all users who are outside collaborators of an organization."
3989 },
3990 "removeOutsideCollaborator": {
3991 "url": "/orgs/:org/outside_collaborators/:username",
3992 "method": "DELETE",
3993 "params": {
3994 "org": {
3995 "type": "string",
3996 "required": true
3997 },
3998 "username": {
3999 "type": "string",
4000 "required": true
4001 }
4002 },
4003 "description": "Remove outside collaborator."
4004 },
4005 "convertMemberToOutsideCollaborator": {
4006 "url": "/orgs/:org/outside_collaborators/:username",
4007 "method": "PUT",
4008 "params": {
4009 "org": {
4010 "type": "string",
4011 "required": true
4012 },
4013 "username": {
4014 "type": "string",
4015 "required": true
4016 }
4017 },
4018 "description": "Convert member to outside collaborator."
4019 },
4020 "getTeams": {
4021 "url": "/orgs/:org/teams",
4022 "method": "GET",
4023 "headers": {
4024 "accept": "application/vnd.github.hellcat-preview+json"
4025 },
4026 "params": {
4027 "org": {
4028 "type": "string",
4029 "required": true
4030 },
4031 "page": {
4032 "type": "number",
4033 "description": "Page number of the results to fetch."
4034 },
4035 "per_page": {
4036 "type": "number",
4037 "default": "30",
4038 "description": "A custom page size up to 100. Default is 30."
4039 }
4040 },
4041 "description": "List teams"
4042 },
4043 "getTeam": {
4044 "url": "/teams/:id",
4045 "method": "GET",
4046 "headers": {
4047 "accept": "application/vnd.github.hellcat-preview+json"
4048 },
4049 "params": {
4050 "id": {
4051 "type": "string",
4052 "required": true
4053 }
4054 },
4055 "description": "Get team"
4056 },
4057 "createTeam": {
4058 "url": "/orgs/:org/teams",
4059 "method": "POST",
4060 "headers": {
4061 "accept": "application/vnd.github.hellcat-preview+json"
4062 },
4063 "params": {
4064 "org": {
4065 "type": "string",
4066 "required": true
4067 },
4068 "name": {
4069 "type": "string",
4070 "required": true
4071 },
4072 "description": {
4073 "type": "string",
4074 "description": "The description of the team."
4075 },
4076 "maintainers": {
4077 "type": "string[]",
4078 "description": "The logins of organization members to add as maintainers of the team."
4079 },
4080 "repo_names": {
4081 "type": "string[]",
4082 "description": "The full name (e.g., \"organization-name/repository-name\") of repositories to add the team to."
4083 },
4084 "privacy": {
4085 "type": "string",
4086 "enum": [
4087 "secret",
4088 "closed"
4089 ],
4090 "default": "secret",
4091 "description": "The level of privacy this team should have."
4092 },
4093 "parent_team_id": {
4094 "type": "string",
4095 "description": "The ID of a team to set as the parent team."
4096 }
4097 },
4098 "description": "Create team"
4099 },
4100 "editTeam": {
4101 "url": "/teams/:id",
4102 "method": "PATCH",
4103 "headers": {
4104 "accept": "application/vnd.github.hellcat-preview+json"
4105 },
4106 "params": {
4107 "id": {
4108 "type": "string",
4109 "required": true
4110 },
4111 "name": {
4112 "type": "string",
4113 "required": true
4114 },
4115 "description": {
4116 "type": "string",
4117 "description": "The description of the team."
4118 },
4119 "privacy": {
4120 "type": "string",
4121 "enum": [
4122 "secret",
4123 "closed"
4124 ],
4125 "default": "secret",
4126 "description": "The level of privacy this team should have."
4127 },
4128 "parent_team_id": {
4129 "type": "string",
4130 "description": "The ID of a team to set as the parent team."
4131 }
4132 },
4133 "description": "Edit team"
4134 },
4135 "deleteTeam": {
4136 "url": "/teams/:id",
4137 "method": "DELETE",
4138 "headers": {
4139 "accept": "application/vnd.github.hellcat-preview+json"
4140 },
4141 "params": {
4142 "id": {
4143 "type": "string",
4144 "required": true
4145 }
4146 },
4147 "description": "Delete team"
4148 },
4149 "getTeamMembers": {
4150 "url": "/teams/:id/members",
4151 "method": "GET",
4152 "headers": {
4153 "accept": "application/vnd.github.hellcat-preview+json"
4154 },
4155 "params": {
4156 "id": {
4157 "type": "string",
4158 "required": true
4159 },
4160 "role": {
4161 "type": "string",
4162 "enum": [
4163 "member",
4164 "maintainer",
4165 "all"
4166 ],
4167 "default": "all",
4168 "description": "Filters members returned by their role in the team."
4169 },
4170 "page": {
4171 "type": "number",
4172 "description": "Page number of the results to fetch."
4173 },
4174 "per_page": {
4175 "type": "number",
4176 "default": "30",
4177 "description": "A custom page size up to 100. Default is 30."
4178 }
4179 },
4180 "description": "List team members"
4181 },
4182 "getChildTeams": {
4183 "url": "/teams/:id/teams",
4184 "method": "GET",
4185 "headers": {
4186 "accept": "application/vnd.github.hellcat-preview+json"
4187 },
4188 "params": {
4189 "id": {
4190 "type": "string",
4191 "required": true
4192 },
4193 "page": {
4194 "type": "number",
4195 "description": "Page number of the results to fetch."
4196 },
4197 "per_page": {
4198 "type": "number",
4199 "default": "30",
4200 "description": "A custom page size up to 100. Default is 30."
4201 }
4202 },
4203 "description": "List child teams"
4204 },
4205 "getTeamMembership": {
4206 "url": "/teams/:id/memberships/:username",
4207 "method": "GET",
4208 "headers": {
4209 "accept": "application/vnd.github.hellcat-preview+json"
4210 },
4211 "params": {
4212 "id": {
4213 "type": "string",
4214 "required": true
4215 },
4216 "username": {
4217 "type": "string",
4218 "required": true
4219 }
4220 },
4221 "description": "Get team membership"
4222 },
4223 "addTeamMembership": {
4224 "url": "/teams/:id/memberships/:username",
4225 "method": "PUT",
4226 "headers": {
4227 "accept": "application/vnd.github.hellcat-preview+json"
4228 },
4229 "params": {
4230 "id": {
4231 "type": "string",
4232 "required": true
4233 },
4234 "username": {
4235 "type": "string",
4236 "required": true
4237 },
4238 "role": {
4239 "type": "string",
4240 "enum": [
4241 "member",
4242 "maintainer"
4243 ],
4244 "default": "member",
4245 "description": "The role that this user should have in the team."
4246 }
4247 },
4248 "description": "Add team membership"
4249 },
4250 "removeTeamMembership": {
4251 "url": "/teams/:id/memberships/:username",
4252 "method": "DELETE",
4253 "headers": {
4254 "accept": "application/vnd.github.hellcat-preview+json"
4255 },
4256 "params": {
4257 "id": {
4258 "type": "string",
4259 "required": true
4260 },
4261 "username": {
4262 "type": "string",
4263 "required": true
4264 }
4265 },
4266 "description": "Remove team membership"
4267 },
4268 "getTeamRepos": {
4269 "url": "/teams/:id/repos",
4270 "method": "GET",
4271 "headers": {
4272 "accept": "application/vnd.github.hellcat-preview+json"
4273 },
4274 "params": {
4275 "id": {
4276 "type": "string",
4277 "required": true
4278 },
4279 "page": {
4280 "type": "number",
4281 "description": "Page number of the results to fetch."
4282 },
4283 "per_page": {
4284 "type": "number",
4285 "default": "30",
4286 "description": "A custom page size up to 100. Default is 30."
4287 }
4288 },
4289 "description": "Get team repos"
4290 },
4291 "getPendingTeamInvites": {
4292 "url": "/teams/:id/invitations",
4293 "method": "GET",
4294 "params": {
4295 "id": {
4296 "type": "string",
4297 "required": true
4298 },
4299 "page": {
4300 "type": "number",
4301 "description": "Page number of the results to fetch."
4302 },
4303 "per_page": {
4304 "type": "number",
4305 "default": "30",
4306 "description": "A custom page size up to 100. Default is 30."
4307 }
4308 },
4309 "description": "List pending team invitations."
4310 },
4311 "checkTeamRepo": {
4312 "url": "/teams/:id/repos/:owner/:repo",
4313 "method": "GET",
4314 "headers": {
4315 "accept": "application/vnd.github.hellcat-preview+json"
4316 },
4317 "params": {
4318 "id": {
4319 "type": "string",
4320 "required": true
4321 },
4322 "owner": {
4323 "type": "string",
4324 "required": true
4325 },
4326 "repo": {
4327 "type": "string",
4328 "required": true
4329 }
4330 },
4331 "description": "Check if a team manages a repository"
4332 },
4333 "addTeamRepo": {
4334 "url": "/teams/:id/repos/:org/:repo",
4335 "method": "PUT",
4336 "headers": {
4337 "accept": "application/vnd.github.hellcat-preview+json"
4338 },
4339 "params": {
4340 "id": {
4341 "type": "string",
4342 "required": true
4343 },
4344 "org": {
4345 "type": "string",
4346 "required": true
4347 },
4348 "repo": {
4349 "type": "string",
4350 "required": true
4351 },
4352 "permission": {
4353 "type": "string",
4354 "enum": [
4355 "pull",
4356 "push",
4357 "admin"
4358 ],
4359 "description": "`pull` - team members can pull, but not push or administer this repository, `push` - team members can pull and push, but not administer this repository, `admin` - team members can pull, push and administer this repository."
4360 }
4361 },
4362 "description": "Add team repository"
4363 },
4364 "deleteTeamRepo": {
4365 "url": "/teams/:id/repos/:owner/:repo",
4366 "method": "DELETE",
4367 "headers": {
4368 "accept": "application/vnd.github.hellcat-preview+json"
4369 },
4370 "params": {
4371 "id": {
4372 "type": "string",
4373 "required": true
4374 },
4375 "owner": {
4376 "type": "string",
4377 "required": true
4378 },
4379 "repo": {
4380 "type": "string",
4381 "required": true
4382 }
4383 },
4384 "description": "Remove team repository"
4385 },
4386 "getHooks": {
4387 "url": "/orgs/:org/hooks",
4388 "method": "GET",
4389 "params": {
4390 "org": {
4391 "type": "string",
4392 "required": true
4393 },
4394 "page": {
4395 "type": "number",
4396 "description": "Page number of the results to fetch."
4397 },
4398 "per_page": {
4399 "type": "number",
4400 "default": "30",
4401 "description": "A custom page size up to 100. Default is 30."
4402 }
4403 },
4404 "description": "List hooks"
4405 },
4406 "getHook": {
4407 "url": "/orgs/:org/hooks/:id",
4408 "method": "GET",
4409 "params": {
4410 "org": {
4411 "type": "string",
4412 "required": true
4413 },
4414 "id": {
4415 "type": "string",
4416 "required": true
4417 }
4418 },
4419 "description": "Get single hook"
4420 },
4421 "createHook": {
4422 "url": "/orgs/:org/hooks",
4423 "method": "POST",
4424 "params": {
4425 "org": {
4426 "type": "string",
4427 "required": true
4428 },
4429 "name": {
4430 "type": "string",
4431 "required": true,
4432 "description": "Must be passed as \"web\"."
4433 },
4434 "config": {
4435 "type": "json",
4436 "required": true,
4437 "description": "Key/value pairs to provide settings for this webhook"
4438 },
4439 "events": {
4440 "type": "string[]",
4441 "default": "[\"push\"]",
4442 "description": "Determines what events the hook is triggered for. Default: [\"push\"]."
4443 },
4444 "active": {
4445 "type": "boolean",
4446 "description": "Determines whether the hook is actually triggered on pushes."
4447 }
4448 },
4449 "description": "Create a hook"
4450 },
4451 "editHook": {
4452 "url": "/orgs/:org/hooks/:id",
4453 "method": "PATCH",
4454 "params": {
4455 "org": {
4456 "type": "string",
4457 "required": true
4458 },
4459 "id": {
4460 "type": "string",
4461 "required": true
4462 },
4463 "config": {
4464 "type": "json",
4465 "required": true,
4466 "description": "Key/value pairs to provide settings for this webhook"
4467 },
4468 "events": {
4469 "type": "string[]",
4470 "default": "[\"push\"]",
4471 "description": "Determines what events the hook is triggered for. Default: [\"push\"]."
4472 },
4473 "active": {
4474 "type": "boolean",
4475 "description": "Determines whether the hook is actually triggered on pushes."
4476 }
4477 },
4478 "description": "Edit a hook"
4479 },
4480 "pingHook": {
4481 "url": "/orgs/:org/hooks/:id/pings",
4482 "method": "POST",
4483 "params": {
4484 "org": {
4485 "type": "string",
4486 "required": true
4487 },
4488 "id": {
4489 "type": "string",
4490 "required": true
4491 }
4492 },
4493 "description": "Ping a hook"
4494 },
4495 "deleteHook": {
4496 "url": "/orgs/:org/hooks/:id",
4497 "method": "DELETE",
4498 "params": {
4499 "org": {
4500 "type": "string",
4501 "required": true
4502 },
4503 "id": {
4504 "type": "string",
4505 "required": true
4506 }
4507 },
4508 "description": "Delete a hook"
4509 },
4510 "getBlockedUsers": {
4511 "url": "/orgs/:org/blocks",
4512 "method": "GET",
4513 "headers": {
4514 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
4515 },
4516 "params": {
4517 "org": {
4518 "type": "string",
4519 "required": true
4520 },
4521 "page": {
4522 "type": "number",
4523 "description": "Page number of the results to fetch."
4524 },
4525 "per_page": {
4526 "type": "number",
4527 "default": "30",
4528 "description": "A custom page size up to 100. Default is 30."
4529 }
4530 },
4531 "description": "List blocked users. (In preview period. See README.)"
4532 },
4533 "checkBlockedUser": {
4534 "url": "/orgs/:org/blocks/:username",
4535 "method": "GET",
4536 "headers": {
4537 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
4538 },
4539 "params": {
4540 "org": {
4541 "type": "string",
4542 "required": true
4543 },
4544 "username": {
4545 "type": "string",
4546 "required": true
4547 }
4548 },
4549 "description": "Check whether you've blocked a user. (In preview period. See README.)"
4550 },
4551 "blockUser": {
4552 "url": "/orgs/:org/blocks/:username",
4553 "method": "PUT",
4554 "headers": {
4555 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
4556 },
4557 "params": {
4558 "org": {
4559 "type": "string",
4560 "required": true
4561 },
4562 "username": {
4563 "type": "string",
4564 "required": true
4565 }
4566 },
4567 "description": "Block a user. (In preview period. See README.)"
4568 },
4569 "unblockUser": {
4570 "url": "/orgs/:org/blocks/:username",
4571 "method": "DELETE",
4572 "headers": {
4573 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
4574 },
4575 "params": {
4576 "org": {
4577 "type": "string",
4578 "required": true
4579 },
4580 "username": {
4581 "type": "string",
4582 "required": true
4583 }
4584 },
4585 "description": "Unblock a user. (In preview period. See README.)"
4586 }
4587 },
4588 "projects": {
4589 "getRepoProjects": {
4590 "url": "/repos/:owner/:repo/projects",
4591 "method": "GET",
4592 "headers": {
4593 "accept": "application/vnd.github.inertia-preview+json"
4594 },
4595 "params": {
4596 "owner": {
4597 "type": "string",
4598 "required": true
4599 },
4600 "repo": {
4601 "type": "string",
4602 "required": true
4603 },
4604 "state": {
4605 "type": "string",
4606 "enum": [
4607 "open",
4608 "closed",
4609 "all"
4610 ],
4611 "default": "open"
4612 }
4613 },
4614 "description": "List repository projects. (In preview period. See README.)"
4615 },
4616 "getOrgProjects": {
4617 "url": "/orgs/:org/projects",
4618 "method": "GET",
4619 "headers": {
4620 "accept": "application/vnd.github.inertia-preview+json"
4621 },
4622 "params": {
4623 "org": {
4624 "type": "string",
4625 "required": true
4626 },
4627 "state": {
4628 "type": "string",
4629 "enum": [
4630 "open",
4631 "closed",
4632 "all"
4633 ],
4634 "default": "open"
4635 }
4636 },
4637 "description": "List organization projects. (In preview period. See README.)"
4638 },
4639 "getProject": {
4640 "url": "/projects/:id",
4641 "method": "GET",
4642 "headers": {
4643 "accept": "application/vnd.github.inertia-preview+json"
4644 },
4645 "params": {
4646 "id": {
4647 "type": "string",
4648 "required": true
4649 }
4650 },
4651 "description": "Get a project. (In preview period. See README.)"
4652 },
4653 "createRepoProject": {
4654 "url": "/repos/:owner/:repo/projects",
4655 "method": "POST",
4656 "headers": {
4657 "accept": "application/vnd.github.inertia-preview+json"
4658 },
4659 "params": {
4660 "owner": {
4661 "type": "string",
4662 "required": true
4663 },
4664 "repo": {
4665 "type": "string",
4666 "required": true
4667 },
4668 "name": {
4669 "type": "string",
4670 "required": true
4671 },
4672 "body": {
4673 "type": "string"
4674 }
4675 },
4676 "description": "Create a repository project. (In preview period. See README.)"
4677 },
4678 "createOrgProject": {
4679 "url": "/orgs/:org/projects",
4680 "method": "POST",
4681 "headers": {
4682 "accept": "application/vnd.github.inertia-preview+json"
4683 },
4684 "params": {
4685 "org": {
4686 "type": "string",
4687 "required": true
4688 },
4689 "name": {
4690 "type": "string",
4691 "required": true
4692 },
4693 "body": {
4694 "type": "string"
4695 }
4696 },
4697 "description": "Create an organization project. (In preview period. See README.)"
4698 },
4699 "updateProject": {
4700 "url": "/projects/:id",
4701 "method": "PATCH",
4702 "headers": {
4703 "accept": "application/vnd.github.inertia-preview+json"
4704 },
4705 "params": {
4706 "id": {
4707 "type": "string",
4708 "required": true
4709 },
4710 "name": {
4711 "type": "string",
4712 "required": true
4713 },
4714 "body": {
4715 "type": "string"
4716 },
4717 "state": {
4718 "type": "string",
4719 "enum": [
4720 "open",
4721 "closed",
4722 "all"
4723 ],
4724 "default": "open"
4725 }
4726 },
4727 "description": "Update a project. (In preview period. See README.)"
4728 },
4729 "deleteProject": {
4730 "url": "/projects/:id",
4731 "method": "DELETE",
4732 "headers": {
4733 "accept": "application/vnd.github.inertia-preview+json"
4734 },
4735 "params": {
4736 "id": {
4737 "type": "string",
4738 "required": true
4739 }
4740 },
4741 "description": "Delete a project. (In preview period. See README.)"
4742 },
4743 "getProjectCards": {
4744 "url": "/projects/columns/:column_id/cards",
4745 "method": "GET",
4746 "headers": {
4747 "accept": "application/vnd.github.inertia-preview+json"
4748 },
4749 "params": {
4750 "column_id": {
4751 "type": "string",
4752 "required": true
4753 }
4754 },
4755 "description": "List project cards. (In preview period. See README.)"
4756 },
4757 "getProjectCard": {
4758 "url": "/projects/columns/cards/:id",
4759 "method": "GET",
4760 "headers": {
4761 "accept": "application/vnd.github.inertia-preview+json"
4762 },
4763 "params": {
4764 "id": {
4765 "type": "string",
4766 "required": true
4767 }
4768 },
4769 "description": "Get project card. (In preview period. See README.)"
4770 },
4771 "createProjectCard": {
4772 "url": "/projects/columns/:column_id/cards",
4773 "method": "POST",
4774 "headers": {
4775 "accept": "application/vnd.github.inertia-preview+json"
4776 },
4777 "params": {
4778 "column_id": {
4779 "type": "string",
4780 "required": true
4781 },
4782 "note": {
4783 "type": "string",
4784 "description": "The note of the card."
4785 },
4786 "content_id": {
4787 "type": "string",
4788 "description": "The id of the Issue or Pull Request to associate with this card."
4789 },
4790 "content_type": {
4791 "type": "string",
4792 "description": "The type of content to associate with this card. Can be either 'Issue' or 'PullRequest'."
4793 }
4794 },
4795 "description": "Create a project card. (In preview period. See README.)"
4796 },
4797 "updateProjectCard": {
4798 "url": "/projects/columns/cards/:id",
4799 "method": "PATCH",
4800 "headers": {
4801 "accept": "application/vnd.github.inertia-preview+json"
4802 },
4803 "params": {
4804 "id": {
4805 "type": "string",
4806 "required": true
4807 },
4808 "note": {
4809 "type": "string",
4810 "description": "The note of the card."
4811 }
4812 },
4813 "description": "Update a project card. (In preview period. See README.)"
4814 },
4815 "deleteProjectCard": {
4816 "url": "/projects/columns/cards/:id",
4817 "method": "DELETE",
4818 "headers": {
4819 "accept": "application/vnd.github.inertia-preview+json"
4820 },
4821 "params": {
4822 "id": {
4823 "type": "string",
4824 "required": true
4825 }
4826 },
4827 "description": "Delete a project card. (In preview period. See README.)"
4828 },
4829 "moveProjectCard": {
4830 "url": "/projects/columns/cards/:id/moves",
4831 "method": "POST",
4832 "headers": {
4833 "accept": "application/vnd.github.inertia-preview+json"
4834 },
4835 "params": {
4836 "id": {
4837 "type": "string",
4838 "required": true
4839 },
4840 "position": {
4841 "type": "string",
4842 "required": true,
4843 "validation": "^(top|bottom|after:\\d+)$",
4844 "description": "Can be one of top, bottom, or after:<card-id>, where <card-id> is the id value of a card in the same project."
4845 },
4846 "column_id": {
4847 "type": "string",
4848 "description": "The id value of a column in the same project."
4849 }
4850 },
4851 "description": "Move a project card. (In preview period. See README.)"
4852 },
4853 "getProjectColumns": {
4854 "url": "/projects/:project_id/columns",
4855 "method": "GET",
4856 "headers": {
4857 "accept": "application/vnd.github.inertia-preview+json"
4858 },
4859 "params": {
4860 "project_id": {
4861 "type": "string",
4862 "required": true
4863 }
4864 },
4865 "description": "List project columns. (In preview period. See README.)"
4866 },
4867 "getProjectColumn": {
4868 "url": "/projects/columns/:id",
4869 "method": "GET",
4870 "headers": {
4871 "accept": "application/vnd.github.inertia-preview+json"
4872 },
4873 "params": {
4874 "id": {
4875 "type": "string",
4876 "required": true
4877 }
4878 },
4879 "description": "Get a project column. (In preview period. See README.)"
4880 },
4881 "createProjectColumn": {
4882 "url": "/projects/:project_id/columns",
4883 "method": "POST",
4884 "headers": {
4885 "accept": "application/vnd.github.inertia-preview+json"
4886 },
4887 "params": {
4888 "project_id": {
4889 "type": "string",
4890 "required": true
4891 },
4892 "name": {
4893 "type": "string",
4894 "required": true
4895 }
4896 },
4897 "description": "Create a project column. (In preview period. See README.)"
4898 },
4899 "updateProjectColumn": {
4900 "url": "/projects/columns/:id",
4901 "method": "PATCH",
4902 "headers": {
4903 "accept": "application/vnd.github.inertia-preview+json"
4904 },
4905 "params": {
4906 "id": {
4907 "type": "string",
4908 "required": true
4909 },
4910 "name": {
4911 "type": "string",
4912 "required": true
4913 }
4914 },
4915 "description": "Update a project column. (In preview period. See README.)"
4916 },
4917 "deleteProjectColumn": {
4918 "url": "/projects/columns/:id",
4919 "method": "DELETE",
4920 "headers": {
4921 "accept": "application/vnd.github.inertia-preview+json"
4922 },
4923 "params": {
4924 "id": {
4925 "type": "string",
4926 "required": true
4927 }
4928 },
4929 "description": "Delete a project column. (In preview period. See README.)"
4930 },
4931 "moveProjectColumn": {
4932 "url": "/projects/columns/:id/moves",
4933 "method": "POST",
4934 "headers": {
4935 "accept": "application/vnd.github.inertia-preview+json"
4936 },
4937 "params": {
4938 "id": {
4939 "type": "string",
4940 "required": true
4941 },
4942 "position": {
4943 "type": "string",
4944 "required": true,
4945 "validation": "^(first|last|after:\\d+)$",
4946 "description": "Can be one of first, last, or after:<column-id>, where <column-id> is the id value of a column in the same project."
4947 }
4948 },
4949 "description": "Move a project column. (In preview period. See README.)"
4950 }
4951 },
4952 "pullRequests": {
4953 "get": {
4954 "url": "/repos/:owner/:repo/pulls/:number",
4955 "method": "GET",
4956 "params": {
4957 "owner": {
4958 "type": "string",
4959 "required": true
4960 },
4961 "repo": {
4962 "type": "string",
4963 "required": true
4964 },
4965 "number": {
4966 "type": "number",
4967 "required": true
4968 }
4969 },
4970 "description": "Get a single pull request"
4971 },
4972 "create": {
4973 "url": "/repos/:owner/:repo/pulls",
4974 "method": "POST",
4975 "params": {
4976 "owner": {
4977 "type": "string",
4978 "required": true
4979 },
4980 "repo": {
4981 "type": "string",
4982 "required": true
4983 },
4984 "head": {
4985 "type": "string",
4986 "required": true,
4987 "description": "The branch (or git ref) where your changes are implemented."
4988 },
4989 "base": {
4990 "type": "string",
4991 "required": true,
4992 "description": "The branch (or git ref) you want your changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repo that requests a merge to a base of another repo."
4993 }
4994 },
4995 "description": "Create a pull request"
4996 },
4997 "update": {
4998 "url": "/repos/:owner/:repo/pulls/:number",
4999 "method": "PATCH",
5000 "params": {
5001 "owner": {
5002 "type": "string",
5003 "required": true
5004 },
5005 "repo": {
5006 "type": "string",
5007 "required": true
5008 },
5009 "number": {
5010 "type": "number",
5011 "required": true
5012 },
5013 "title": {
5014 "type": "string",
5015 "description": "The title of the pull request."
5016 },
5017 "body": {
5018 "type": "string",
5019 "description": "The contents of the pull request."
5020 },
5021 "state": {
5022 "type": "string",
5023 "enum": [
5024 "open",
5025 "closed"
5026 ],
5027 "description": "open or closed"
5028 },
5029 "base": {
5030 "type": "string",
5031 "description": "The branch (or git ref) you want your changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repo that requests a merge to a base of another repo."
5032 },
5033 "maintainer_can_modify": {
5034 "type": "boolean",
5035 "default": "true",
5036 "description": "Indicates whether maintainers can modify the pull request."
5037 }
5038 },
5039 "description": "Update a pull request"
5040 },
5041 "merge": {
5042 "url": "/repos/:owner/:repo/pulls/:number/merge",
5043 "method": "PUT",
5044 "headers": {
5045 "accept": "application/vnd.github.polaris-preview"
5046 },
5047 "params": {
5048 "owner": {
5049 "type": "string",
5050 "required": true
5051 },
5052 "repo": {
5053 "type": "string",
5054 "required": true
5055 },
5056 "number": {
5057 "type": "number",
5058 "required": true
5059 },
5060 "commit_title": {
5061 "type": "string",
5062 "description": "Title for the automatic commit message. (In preview period. See README.)"
5063 },
5064 "commit_message": {
5065 "type": "string",
5066 "description": "Extra detail to append to automatic commit message."
5067 },
5068 "sha": {
5069 "type": "string",
5070 "description": "SHA that pull request head must match to allow merge"
5071 },
5072 "merge_method": {
5073 "type": "string",
5074 "enum": [
5075 "merge",
5076 "squash",
5077 "rebase"
5078 ],
5079 "default": "merge",
5080 "description": "Merge method to use. Possible values are `merge`, `squash`, or `rebase`. (In preview period. See README.)"
5081 }
5082 },
5083 "description": "Merge a pull request (Merge Button)"
5084 },
5085 "getAll": {
5086 "url": "/repos/:owner/:repo/pulls",
5087 "method": "GET",
5088 "params": {
5089 "owner": {
5090 "type": "string",
5091 "required": true
5092 },
5093 "repo": {
5094 "type": "string",
5095 "required": true
5096 },
5097 "state": {
5098 "type": "string",
5099 "enum": [
5100 "open",
5101 "closed",
5102 "all"
5103 ],
5104 "default": "open"
5105 },
5106 "head": {
5107 "type": "string",
5108 "description": "Filter pulls by head user and branch name in the format of user:ref-name. Example: github:new-script-format."
5109 },
5110 "base": {
5111 "type": "string",
5112 "description": "Filter pulls by base branch name. Example: gh-pages."
5113 },
5114 "sort": {
5115 "type": "string",
5116 "enum": [
5117 "created",
5118 "updated",
5119 "popularity",
5120 "long-running"
5121 ],
5122 "default": "created",
5123 "description": "Possible values are: `created`, `updated`, `popularity`, `long-running`, Default: `created`"
5124 },
5125 "direction": {
5126 "type": "string",
5127 "enum": [
5128 "asc",
5129 "desc"
5130 ],
5131 "default": "desc"
5132 },
5133 "page": {
5134 "type": "number",
5135 "description": "Page number of the results to fetch."
5136 },
5137 "per_page": {
5138 "type": "number",
5139 "default": "30",
5140 "description": "A custom page size up to 100. Default is 30."
5141 }
5142 },
5143 "description": "List pull requests"
5144 },
5145 "createFromIssue": {
5146 "url": "/repos/:owner/:repo/pulls",
5147 "method": "POST",
5148 "params": {
5149 "owner": {
5150 "type": "string",
5151 "required": true
5152 },
5153 "repo": {
5154 "type": "string",
5155 "required": true
5156 },
5157 "issue": {
5158 "type": "number",
5159 "required": true,
5160 "description": "The issue number in this repository to turn into a Pull Request."
5161 },
5162 "head": {
5163 "type": "string",
5164 "required": true,
5165 "description": "The branch (or git ref) where your changes are implemented."
5166 },
5167 "base": {
5168 "type": "string",
5169 "required": true,
5170 "description": "The branch (or git ref) you want your changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repo that requests a merge to a base of another repo."
5171 }
5172 },
5173 "description": "Create a pull request from an existing issue"
5174 },
5175 "getCommits": {
5176 "url": "/repos/:owner/:repo/pulls/:number/commits",
5177 "method": "GET",
5178 "params": {
5179 "owner": {
5180 "type": "string",
5181 "required": true
5182 },
5183 "repo": {
5184 "type": "string",
5185 "required": true
5186 },
5187 "number": {
5188 "type": "number",
5189 "required": true
5190 },
5191 "page": {
5192 "type": "number",
5193 "description": "Page number of the results to fetch."
5194 },
5195 "per_page": {
5196 "type": "number",
5197 "default": "30",
5198 "description": "A custom page size up to 100. Default is 30."
5199 }
5200 },
5201 "description": "List commits on a pull request"
5202 },
5203 "getFiles": {
5204 "url": "/repos/:owner/:repo/pulls/:number/files",
5205 "method": "GET",
5206 "params": {
5207 "owner": {
5208 "type": "string",
5209 "required": true
5210 },
5211 "repo": {
5212 "type": "string",
5213 "required": true
5214 },
5215 "number": {
5216 "type": "number",
5217 "required": true
5218 },
5219 "page": {
5220 "type": "number",
5221 "description": "Page number of the results to fetch."
5222 },
5223 "per_page": {
5224 "type": "number",
5225 "default": "30",
5226 "description": "A custom page size up to 100. Default is 30."
5227 }
5228 },
5229 "description": "List pull requests files"
5230 },
5231 "checkMerged": {
5232 "url": "/repos/:owner/:repo/pulls/:number/merge",
5233 "method": "GET",
5234 "headers": {
5235 "accept": "application/vnd.github.polaris-preview"
5236 },
5237 "params": {
5238 "owner": {
5239 "type": "string",
5240 "required": true
5241 },
5242 "repo": {
5243 "type": "string",
5244 "required": true
5245 },
5246 "number": {
5247 "type": "number",
5248 "required": true
5249 },
5250 "page": {
5251 "type": "number",
5252 "description": "Page number of the results to fetch."
5253 },
5254 "per_page": {
5255 "type": "number",
5256 "default": "30",
5257 "description": "A custom page size up to 100. Default is 30."
5258 }
5259 },
5260 "description": "Get if a pull request has been merged"
5261 },
5262 "getReviews": {
5263 "url": "/repos/:owner/:repo/pulls/:number/reviews",
5264 "method": "GET",
5265 "params": {
5266 "owner": {
5267 "type": "string",
5268 "required": true
5269 },
5270 "repo": {
5271 "type": "string",
5272 "required": true
5273 },
5274 "number": {
5275 "type": "number",
5276 "required": true
5277 },
5278 "page": {
5279 "type": "number",
5280 "description": "Page number of the results to fetch."
5281 },
5282 "per_page": {
5283 "type": "number",
5284 "default": "30",
5285 "description": "A custom page size up to 100. Default is 30."
5286 }
5287 },
5288 "description": "List reviews on a pull request."
5289 },
5290 "getReview": {
5291 "url": "/repos/:owner/:repo/pulls/:number/reviews/:id",
5292 "method": "GET",
5293 "params": {
5294 "owner": {
5295 "type": "string",
5296 "required": true
5297 },
5298 "repo": {
5299 "type": "string",
5300 "required": true
5301 },
5302 "number": {
5303 "type": "number",
5304 "required": true
5305 },
5306 "id": {
5307 "type": "string",
5308 "required": true
5309 }
5310 },
5311 "description": "Get a single pull request review."
5312 },
5313 "deletePendingReview": {
5314 "url": "/repos/:owner/:repo/pulls/:number/reviews/:id",
5315 "method": "DELETE",
5316 "params": {
5317 "owner": {
5318 "type": "string",
5319 "required": true
5320 },
5321 "repo": {
5322 "type": "string",
5323 "required": true
5324 },
5325 "number": {
5326 "type": "number",
5327 "required": true
5328 },
5329 "id": {
5330 "type": "string",
5331 "required": true
5332 }
5333 },
5334 "description": "Delete a pending pull request review."
5335 },
5336 "getReviewComments": {
5337 "url": "/repos/:owner/:repo/pulls/:number/reviews/:id/comments",
5338 "method": "GET",
5339 "params": {
5340 "owner": {
5341 "type": "string",
5342 "required": true
5343 },
5344 "repo": {
5345 "type": "string",
5346 "required": true
5347 },
5348 "number": {
5349 "type": "number",
5350 "required": true
5351 },
5352 "id": {
5353 "type": "string",
5354 "required": true
5355 },
5356 "page": {
5357 "type": "number",
5358 "description": "Page number of the results to fetch."
5359 },
5360 "per_page": {
5361 "type": "number",
5362 "default": "30",
5363 "description": "A custom page size up to 100. Default is 30."
5364 }
5365 },
5366 "description": "Get comments for a pull request review."
5367 },
5368 "createReview": {
5369 "url": "/repos/:owner/:repo/pulls/:number/reviews",
5370 "method": "POST",
5371 "params": {
5372 "owner": {
5373 "type": "string",
5374 "required": true
5375 },
5376 "repo": {
5377 "type": "string",
5378 "required": true
5379 },
5380 "number": {
5381 "type": "number",
5382 "required": true
5383 },
5384 "commit_id": {
5385 "type": "string",
5386 "description": "Sha of the commit to comment on."
5387 },
5388 "body": {
5389 "type": "string",
5390 "description": "The body text of the pull request review."
5391 },
5392 "event": {
5393 "type": "string",
5394 "enum": [
5395 "APPROVE",
5396 "REQUEST_CHANGES",
5397 "COMMENT",
5398 "PENDING"
5399 ],
5400 "default": "PENDING",
5401 "description": "The event to perform on the review upon submission, can be one of APPROVE, REQUEST_CHANGES, or COMMENT. If left blank, the review will be in the PENDING state."
5402 },
5403 "comments": {
5404 "type": "string[]",
5405 "description": "An array of draft review comment objects. Draft review comments must include a `path`, `position`, and `body`."
5406 }
5407 },
5408 "description": "Create a pull request review."
5409 },
5410 "submitReview": {
5411 "url": "/repos/:owner/:repo/pulls/:number/reviews/:id/events",
5412 "method": "POST",
5413 "params": {
5414 "owner": {
5415 "type": "string",
5416 "required": true
5417 },
5418 "repo": {
5419 "type": "string",
5420 "required": true
5421 },
5422 "number": {
5423 "type": "number",
5424 "required": true
5425 },
5426 "id": {
5427 "type": "string",
5428 "required": true
5429 },
5430 "body": {
5431 "type": "string",
5432 "description": "The body text of the pull request review."
5433 },
5434 "event": {
5435 "type": "string",
5436 "enum": [
5437 "APPROVE",
5438 "REQUEST_CHANGES",
5439 "COMMENT",
5440 "PENDING"
5441 ],
5442 "default": "PENDING",
5443 "description": "The event to perform on the review upon submission, can be one of APPROVE, REQUEST_CHANGES, or COMMENT. If left blank, the review will be in the PENDING state."
5444 }
5445 },
5446 "description": "Submit a pull request review."
5447 },
5448 "dismissReview": {
5449 "url": "/repos/:owner/:repo/pulls/:number/reviews/:id/dismissals",
5450 "method": "PUT",
5451 "params": {
5452 "owner": {
5453 "type": "string",
5454 "required": true
5455 },
5456 "repo": {
5457 "type": "string",
5458 "required": true
5459 },
5460 "number": {
5461 "type": "number",
5462 "required": true
5463 },
5464 "id": {
5465 "type": "string",
5466 "required": true
5467 },
5468 "message": {
5469 "type": "string",
5470 "description": "The message for the pull request review dismissal."
5471 },
5472 "page": {
5473 "type": "number",
5474 "description": "Page number of the results to fetch."
5475 },
5476 "per_page": {
5477 "type": "number",
5478 "default": "30",
5479 "description": "A custom page size up to 100. Default is 30."
5480 }
5481 },
5482 "description": "Dismiss a pull request review."
5483 },
5484 "getComments": {
5485 "url": "/repos/:owner/:repo/pulls/:number/comments",
5486 "method": "GET",
5487 "headers": {
5488 "accept": "application/vnd.github.squirrel-girl-preview"
5489 },
5490 "params": {
5491 "owner": {
5492 "type": "string",
5493 "required": true
5494 },
5495 "repo": {
5496 "type": "string",
5497 "required": true
5498 },
5499 "number": {
5500 "type": "number",
5501 "required": true
5502 },
5503 "page": {
5504 "type": "number",
5505 "description": "Page number of the results to fetch."
5506 },
5507 "per_page": {
5508 "type": "number",
5509 "default": "30",
5510 "description": "A custom page size up to 100. Default is 30."
5511 }
5512 },
5513 "description": "List comments on a pull request"
5514 },
5515 "getCommentsForRepo": {
5516 "url": "/repos/:owner/:repo/pulls/comments",
5517 "method": "GET",
5518 "headers": {
5519 "accept": "application/vnd.github.squirrel-girl-preview"
5520 },
5521 "params": {
5522 "owner": {
5523 "type": "string",
5524 "required": true
5525 },
5526 "repo": {
5527 "type": "string",
5528 "required": true
5529 },
5530 "sort": {
5531 "type": "string",
5532 "enum": [
5533 "created",
5534 "updated"
5535 ],
5536 "default": "created",
5537 "description": "Possible values are: `created`, `updated`, Default: `created`"
5538 },
5539 "direction": {
5540 "type": "string",
5541 "enum": [
5542 "asc",
5543 "desc"
5544 ],
5545 "default": "desc"
5546 },
5547 "since": {
5548 "type": "date",
5549 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
5550 },
5551 "page": {
5552 "type": "number",
5553 "description": "Page number of the results to fetch."
5554 },
5555 "per_page": {
5556 "type": "number",
5557 "default": "30",
5558 "description": "A custom page size up to 100. Default is 30."
5559 }
5560 },
5561 "description": "List comments in a repository"
5562 },
5563 "getComment": {
5564 "url": "/repos/:owner/:repo/pulls/comments/:id",
5565 "method": "GET",
5566 "headers": {
5567 "accept": "application/vnd.github.squirrel-girl-preview"
5568 },
5569 "params": {
5570 "owner": {
5571 "type": "string",
5572 "required": true
5573 },
5574 "repo": {
5575 "type": "string",
5576 "required": true
5577 },
5578 "id": {
5579 "type": "string",
5580 "required": true
5581 }
5582 },
5583 "description": "Get a single comment"
5584 },
5585 "createComment": {
5586 "url": "/repos/:owner/:repo/pulls/:number/comments",
5587 "method": "POST",
5588 "headers": {
5589 "accept": "application/vnd.github.squirrel-girl-preview"
5590 },
5591 "params": {
5592 "owner": {
5593 "type": "string",
5594 "required": true
5595 },
5596 "repo": {
5597 "type": "string",
5598 "required": true
5599 },
5600 "number": {
5601 "type": "number",
5602 "required": true
5603 },
5604 "body": {
5605 "type": "string",
5606 "required": true
5607 }
5608 },
5609 "description": "Create a comment"
5610 },
5611 "createCommentReply": {
5612 "url": "/repos/:owner/:repo/pulls/:number/comments",
5613 "method": "POST",
5614 "headers": {
5615 "accept": "application/vnd.github.squirrel-girl-preview"
5616 },
5617 "params": {
5618 "owner": {
5619 "type": "string",
5620 "required": true
5621 },
5622 "repo": {
5623 "type": "string",
5624 "required": true
5625 },
5626 "number": {
5627 "type": "number",
5628 "required": true
5629 },
5630 "body": {
5631 "type": "string",
5632 "required": true
5633 },
5634 "in_reply_to": {
5635 "type": "number",
5636 "required": true,
5637 "description": "The comment id to reply to."
5638 }
5639 },
5640 "description": "Reply to existing pull request comment"
5641 },
5642 "editComment": {
5643 "url": "/repos/:owner/:repo/pulls/comments/:id",
5644 "method": "PATCH",
5645 "headers": {
5646 "accept": "application/vnd.github.squirrel-girl-preview"
5647 },
5648 "params": {
5649 "owner": {
5650 "type": "string",
5651 "required": true
5652 },
5653 "repo": {
5654 "type": "string",
5655 "required": true
5656 },
5657 "id": {
5658 "type": "string",
5659 "required": true
5660 },
5661 "body": {
5662 "type": "string",
5663 "required": true
5664 }
5665 },
5666 "description": "Edit a comment"
5667 },
5668 "deleteComment": {
5669 "url": "/repos/:owner/:repo/pulls/comments/:id",
5670 "method": "DELETE",
5671 "headers": {
5672 "accept": "application/vnd.github.squirrel-girl-preview"
5673 },
5674 "params": {
5675 "owner": {
5676 "type": "string",
5677 "required": true
5678 },
5679 "repo": {
5680 "type": "string",
5681 "required": true
5682 },
5683 "id": {
5684 "type": "string",
5685 "required": true
5686 }
5687 },
5688 "description": "Delete a comment"
5689 },
5690 "getReviewRequests": {
5691 "url": "/repos/:owner/:repo/pulls/:number/requested_reviewers",
5692 "method": "GET",
5693 "headers": {
5694 "accept": "application/vnd.github.thor-preview+json"
5695 },
5696 "params": {
5697 "owner": {
5698 "type": "string",
5699 "required": true
5700 },
5701 "repo": {
5702 "type": "string",
5703 "required": true
5704 },
5705 "number": {
5706 "type": "number",
5707 "required": true
5708 },
5709 "page": {
5710 "type": "number",
5711 "description": "Page number of the results to fetch."
5712 },
5713 "per_page": {
5714 "type": "number",
5715 "default": "30",
5716 "description": "A custom page size up to 100. Default is 30."
5717 }
5718 },
5719 "description": "List review requests. (In preview period. See README.)"
5720 },
5721 "createReviewRequest": {
5722 "url": "/repos/:owner/:repo/pulls/:number/requested_reviewers",
5723 "method": "POST",
5724 "headers": {
5725 "accept": "application/vnd.github.thor-preview+json"
5726 },
5727 "params": {
5728 "owner": {
5729 "type": "string",
5730 "required": true
5731 },
5732 "repo": {
5733 "type": "string",
5734 "required": true
5735 },
5736 "number": {
5737 "type": "number",
5738 "required": true
5739 },
5740 "reviewers": {
5741 "type": "string[]",
5742 "description": "An array of user logins that will be requested."
5743 },
5744 "team_reviewers": {
5745 "type": "string[]",
5746 "description": "An array of team slugs that will be requested."
5747 }
5748 },
5749 "description": "Create a review request. (In preview period. See README.)"
5750 },
5751 "deleteReviewRequest": {
5752 "url": "/repos/:owner/:repo/pulls/:number/requested_reviewers",
5753 "method": "DELETE",
5754 "headers": {
5755 "accept": "application/vnd.github.thor-preview+json"
5756 },
5757 "params": {
5758 "owner": {
5759 "type": "string",
5760 "required": true
5761 },
5762 "repo": {
5763 "type": "string",
5764 "required": true
5765 },
5766 "number": {
5767 "type": "number",
5768 "required": true
5769 },
5770 "reviewers": {
5771 "type": "string[]",
5772 "description": "An array of user logins that will be requested."
5773 },
5774 "team_reviewers": {
5775 "type": "string[]",
5776 "description": "An array of team slugs that will be requested."
5777 }
5778 },
5779 "description": "Delete a review request. (In preview period. See README.)"
5780 }
5781 },
5782 "reactions": {
5783 "delete": {
5784 "url": "/reactions/:id",
5785 "method": "DELETE",
5786 "headers": {
5787 "accept": "application/vnd.github.squirrel-girl-preview"
5788 },
5789 "params": {
5790 "id": {
5791 "type": "string",
5792 "required": true
5793 }
5794 },
5795 "description": "Delete a reaction. (In preview period. See README.)"
5796 },
5797 "getForCommitComment": {
5798 "url": "/repos/:owner/:repo/comments/:id/reactions",
5799 "method": "GET",
5800 "headers": {
5801 "accept": "application/vnd.github.squirrel-girl-preview"
5802 },
5803 "params": {
5804 "owner": {
5805 "type": "string",
5806 "required": true
5807 },
5808 "repo": {
5809 "type": "string",
5810 "required": true
5811 },
5812 "id": {
5813 "type": "string",
5814 "required": true
5815 },
5816 "content": {
5817 "type": "string",
5818 "enum": [
5819 "+1",
5820 "-1",
5821 "laugh",
5822 "confused",
5823 "heart",
5824 "hooray"
5825 ],
5826 "description": "Indicates which type of reaction to return."
5827 }
5828 },
5829 "description": "List reactions for a commit comment. (In preview period. See README.)"
5830 },
5831 "createForCommitComment": {
5832 "url": "/repos/:owner/:repo/comments/:id/reactions",
5833 "method": "POST",
5834 "headers": {
5835 "accept": "application/vnd.github.squirrel-girl-preview"
5836 },
5837 "params": {
5838 "owner": {
5839 "type": "string",
5840 "required": true
5841 },
5842 "repo": {
5843 "type": "string",
5844 "required": true
5845 },
5846 "id": {
5847 "type": "string",
5848 "required": true
5849 },
5850 "content": {
5851 "type": "string",
5852 "required": true,
5853 "enum": [
5854 "+1",
5855 "-1",
5856 "laugh",
5857 "confused",
5858 "heart",
5859 "hooray"
5860 ],
5861 "description": "The reaction type."
5862 }
5863 },
5864 "description": "Create reaction for a commit comment. (In preview period. See README.)"
5865 },
5866 "getForIssue": {
5867 "url": "/repos/:owner/:repo/issues/:number/reactions",
5868 "method": "GET",
5869 "headers": {
5870 "accept": "application/vnd.github.squirrel-girl-preview"
5871 },
5872 "params": {
5873 "owner": {
5874 "type": "string",
5875 "required": true
5876 },
5877 "repo": {
5878 "type": "string",
5879 "required": true
5880 },
5881 "number": {
5882 "type": "number",
5883 "required": true
5884 },
5885 "content": {
5886 "type": "string",
5887 "enum": [
5888 "+1",
5889 "-1",
5890 "laugh",
5891 "confused",
5892 "heart",
5893 "hooray"
5894 ],
5895 "description": "Indicates which type of reaction to return."
5896 }
5897 },
5898 "description": "List reactions for an issue. (In preview period. See README.)"
5899 },
5900 "createForIssue": {
5901 "url": "/repos/:owner/:repo/issues/:number/reactions",
5902 "method": "POST",
5903 "headers": {
5904 "accept": "application/vnd.github.squirrel-girl-preview"
5905 },
5906 "params": {
5907 "owner": {
5908 "type": "string",
5909 "required": true
5910 },
5911 "repo": {
5912 "type": "string",
5913 "required": true
5914 },
5915 "number": {
5916 "type": "number",
5917 "required": true
5918 },
5919 "content": {
5920 "type": "string",
5921 "required": true,
5922 "enum": [
5923 "+1",
5924 "-1",
5925 "laugh",
5926 "confused",
5927 "heart",
5928 "hooray"
5929 ],
5930 "description": "The reaction type."
5931 }
5932 },
5933 "description": "Create reaction for an issue. (In preview period. See README.)"
5934 },
5935 "getForIssueComment": {
5936 "url": "/repos/:owner/:repo/issues/comments/:id/reactions",
5937 "method": "GET",
5938 "headers": {
5939 "accept": "application/vnd.github.squirrel-girl-preview"
5940 },
5941 "params": {
5942 "owner": {
5943 "type": "string",
5944 "required": true
5945 },
5946 "repo": {
5947 "type": "string",
5948 "required": true
5949 },
5950 "id": {
5951 "type": "string",
5952 "required": true
5953 },
5954 "content": {
5955 "type": "string",
5956 "enum": [
5957 "+1",
5958 "-1",
5959 "laugh",
5960 "confused",
5961 "heart",
5962 "hooray"
5963 ],
5964 "description": "Indicates which type of reaction to return."
5965 }
5966 },
5967 "description": "List reactions for an issue comment. (In preview period. See README.)"
5968 },
5969 "createForIssueComment": {
5970 "url": "/repos/:owner/:repo/issues/comments/:id/reactions",
5971 "method": "POST",
5972 "headers": {
5973 "accept": "application/vnd.github.squirrel-girl-preview"
5974 },
5975 "params": {
5976 "owner": {
5977 "type": "string",
5978 "required": true
5979 },
5980 "repo": {
5981 "type": "string",
5982 "required": true
5983 },
5984 "id": {
5985 "type": "string",
5986 "required": true
5987 },
5988 "content": {
5989 "type": "string",
5990 "required": true,
5991 "enum": [
5992 "+1",
5993 "-1",
5994 "laugh",
5995 "confused",
5996 "heart",
5997 "hooray"
5998 ],
5999 "description": "The reaction type."
6000 }
6001 },
6002 "description": "Create reaction for an issue comment. (In preview period. See README.)"
6003 },
6004 "getForPullRequestReviewComment": {
6005 "url": "/repos/:owner/:repo/pulls/comments/:id/reactions",
6006 "method": "GET",
6007 "headers": {
6008 "accept": "application/vnd.github.squirrel-girl-preview"
6009 },
6010 "params": {
6011 "owner": {
6012 "type": "string",
6013 "required": true
6014 },
6015 "repo": {
6016 "type": "string",
6017 "required": true
6018 },
6019 "id": {
6020 "type": "string",
6021 "required": true
6022 },
6023 "content": {
6024 "type": "string",
6025 "enum": [
6026 "+1",
6027 "-1",
6028 "laugh",
6029 "confused",
6030 "heart",
6031 "hooray"
6032 ],
6033 "description": "Indicates which type of reaction to return."
6034 }
6035 },
6036 "description": "List reactions for a pull request review comment. (In preview period. See README.)"
6037 },
6038 "createForPullRequestReviewComment": {
6039 "url": "/repos/:owner/:repo/pulls/comments/:id/reactions",
6040 "method": "POST",
6041 "headers": {
6042 "accept": "application/vnd.github.squirrel-girl-preview"
6043 },
6044 "params": {
6045 "owner": {
6046 "type": "string",
6047 "required": true
6048 },
6049 "repo": {
6050 "type": "string",
6051 "required": true
6052 },
6053 "id": {
6054 "type": "string",
6055 "required": true
6056 },
6057 "content": {
6058 "type": "string",
6059 "required": true,
6060 "enum": [
6061 "+1",
6062 "-1",
6063 "laugh",
6064 "confused",
6065 "heart",
6066 "hooray"
6067 ],
6068 "description": "The reaction type."
6069 }
6070 },
6071 "description": "Create reaction for a pull request review comment. (In preview period. See README.)"
6072 }
6073 },
6074 "repos": {
6075 "create": {
6076 "url": "/user/repos",
6077 "method": "POST",
6078 "params": {
6079 "name": {
6080 "type": "string",
6081 "required": true
6082 },
6083 "description": {
6084 "type": "string"
6085 },
6086 "homepage": {
6087 "type": "string"
6088 },
6089 "private": {
6090 "type": "boolean",
6091 "default": "false",
6092 "description": "True to create a private repository, false to create a public one. Creating private repositories requires a paid GitHub account. Default is false."
6093 },
6094 "has_issues": {
6095 "type": "boolean",
6096 "default": "true",
6097 "description": "True to enable issues for this repository, false to disable them. Default is true."
6098 },
6099 "has_projects": {
6100 "type": "boolean",
6101 "default": "true",
6102 "description": "True to enable projects for this repository, false to disable them. Default is true."
6103 },
6104 "has_wiki": {
6105 "type": "boolean",
6106 "default": "true",
6107 "description": "True to enable the wiki for this repository, false to disable it. Default is true."
6108 },
6109 "team_id": {
6110 "type": "number",
6111 "description": "The id of the team that will be granted access to this repository. This is only valid when creating a repository in an organization."
6112 },
6113 "auto_init": {
6114 "type": "boolean",
6115 "default": "false",
6116 "description": "True to create an initial commit with empty README. Default is false"
6117 },
6118 "gitignore_template": {
6119 "type": "string",
6120 "description": "Desired language or platform .gitignore template to apply. Ignored if auto_init parameter is not provided."
6121 },
6122 "license_template": {
6123 "type": "string",
6124 "description": "Desired LICENSE template to apply. Use the name of the template without the extension. For example, \"mit\" or \"mozilla\"."
6125 },
6126 "allow_squash_merge": {
6127 "type": "boolean",
6128 "default": "true",
6129 "description": "Either true to allow squash-merging pull requests, or false to prevent squash-merging. Default: true. (In preview period. See README.)"
6130 },
6131 "allow_merge_commit": {
6132 "type": "boolean",
6133 "default": "true",
6134 "description": "Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Default: true. (In preview period. See README.)"
6135 },
6136 "allow_rebase_merge": {
6137 "type": "boolean",
6138 "default": "true",
6139 "description": "Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Default: true. (In preview period. See README.)"
6140 }
6141 },
6142 "description": "Create a new repository for the authenticated user."
6143 },
6144 "get": {
6145 "url": "/repos/:owner/:repo",
6146 "method": "GET",
6147 "headers": {
6148 "accept": "application/vnd.github.drax-preview+json"
6149 },
6150 "params": {
6151 "owner": {
6152 "type": "string",
6153 "required": true
6154 },
6155 "repo": {
6156 "type": "string",
6157 "required": true
6158 }
6159 },
6160 "description": "Get a repo for a user."
6161 },
6162 "edit": {
6163 "url": "/repos/:owner/:repo",
6164 "method": "PATCH",
6165 "headers": {
6166 "accept": "application/vnd.github.drax-preview+json"
6167 },
6168 "params": {
6169 "owner": {
6170 "type": "string",
6171 "required": true
6172 },
6173 "repo": {
6174 "type": "string",
6175 "required": true
6176 },
6177 "name": {
6178 "type": "string",
6179 "required": true
6180 },
6181 "description": {
6182 "type": "string"
6183 },
6184 "homepage": {
6185 "type": "string"
6186 },
6187 "private": {
6188 "type": "boolean",
6189 "default": "false",
6190 "description": "True to create a private repository, false to create a public one. Creating private repositories requires a paid GitHub account. Default is false."
6191 },
6192 "has_issues": {
6193 "type": "boolean",
6194 "default": "true",
6195 "description": "True to enable issues for this repository, false to disable them. Default is true."
6196 },
6197 "has_projects": {
6198 "type": "boolean",
6199 "default": "true",
6200 "description": "True to enable projects for this repository, false to disable them. Default is true."
6201 },
6202 "has_wiki": {
6203 "type": "boolean",
6204 "default": "true",
6205 "description": "True to enable the wiki for this repository, false to disable it. Default is true."
6206 },
6207 "default_branch": {
6208 "type": "string",
6209 "description": "Updates the default branch for this repository."
6210 },
6211 "allow_squash_merge": {
6212 "type": "boolean",
6213 "default": "true",
6214 "description": "Either true to allow squash-merging pull requests, or false to prevent squash-merging. Default: true. (In preview period. See README.)"
6215 },
6216 "allow_merge_commit": {
6217 "type": "boolean",
6218 "default": "true",
6219 "description": "Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Default: true. (In preview period. See README.)"
6220 },
6221 "allow_rebase_merge": {
6222 "type": "boolean",
6223 "default": "true",
6224 "description": "Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Default: true. (In preview period. See README.)"
6225 }
6226 },
6227 "description": "Update a repo."
6228 },
6229 "delete": {
6230 "url": "/repos/:owner/:repo",
6231 "method": "DELETE",
6232 "headers": {
6233 "accept": "application/vnd.github.drax-preview+json"
6234 },
6235 "params": {
6236 "owner": {
6237 "type": "string",
6238 "required": true
6239 },
6240 "repo": {
6241 "type": "string",
6242 "required": true
6243 }
6244 },
6245 "description": "Delete a repository."
6246 },
6247 "fork": {
6248 "url": "/repos/:owner/:repo/forks",
6249 "method": "POST",
6250 "params": {
6251 "owner": {
6252 "type": "string",
6253 "required": true
6254 },
6255 "repo": {
6256 "type": "string",
6257 "required": true
6258 },
6259 "organization": {
6260 "type": "string",
6261 "description": "Optional parameter to specify the organization name if forking into an organization."
6262 }
6263 },
6264 "description": "Create a fork."
6265 },
6266 "merge": {
6267 "url": "/repos/:owner/:repo/merges",
6268 "method": "POST",
6269 "params": {
6270 "owner": {
6271 "type": "string",
6272 "required": true
6273 },
6274 "repo": {
6275 "type": "string",
6276 "required": true
6277 },
6278 "base": {
6279 "type": "string",
6280 "required": true,
6281 "description": "The branch (or git ref) you want your changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repo that requests a merge to a base of another repo."
6282 },
6283 "head": {
6284 "type": "string",
6285 "required": true,
6286 "description": "The branch (or git ref) where your changes are implemented."
6287 },
6288 "commit_message": {
6289 "type": "string",
6290 "description": "Commit message to use for the merge commit. If omitted, a default message will be used."
6291 }
6292 },
6293 "description": "Perform a merge."
6294 },
6295 "getAll": {
6296 "url": "/user/repos",
6297 "method": "GET",
6298 "params": {
6299 "visibility": {
6300 "type": "string",
6301 "enum": [
6302 "all",
6303 "public",
6304 "private"
6305 ],
6306 "default": "all",
6307 "description": "Can be one of `all`, `public`, or `private`. Default: `all`."
6308 },
6309 "affiliation": {
6310 "type": "string",
6311 "default": "owner,collaborator,organization_member",
6312 "description": "Comma-separated list of values. Can include: `owner`, `collaborator`, `organization_member`."
6313 },
6314 "type": {
6315 "type": "string",
6316 "enum": [
6317 "all",
6318 "owner",
6319 "public",
6320 "private",
6321 "member"
6322 ],
6323 "default": "all",
6324 "description": "Possible values: `all`, `owner`, `public`, `private`, `member`. Default: `all`."
6325 },
6326 "sort": {
6327 "type": "string",
6328 "enum": [
6329 "created",
6330 "updated",
6331 "pushed",
6332 "full_name"
6333 ],
6334 "default": "full_name",
6335 "description": "Possible values: `created`, `updated`, `pushed`, `full_name`. Default: `full_name`."
6336 },
6337 "direction": {
6338 "type": "string",
6339 "enum": [
6340 "asc",
6341 "desc"
6342 ],
6343 "default": "desc"
6344 },
6345 "page": {
6346 "type": "number",
6347 "description": "Page number of the results to fetch."
6348 },
6349 "per_page": {
6350 "type": "number",
6351 "default": "30",
6352 "description": "A custom page size up to 100. Default is 30."
6353 }
6354 },
6355 "description": "List your repositories"
6356 },
6357 "getForUser": {
6358 "url": "/users/:username/repos",
6359 "method": "GET",
6360 "params": {
6361 "username": {
6362 "type": "string",
6363 "required": true
6364 },
6365 "type": {
6366 "type": "string",
6367 "enum": [
6368 "all",
6369 "owner",
6370 "member"
6371 ],
6372 "default": "owner",
6373 "description": "Possible values: `all`, `owner`, `member`. Default: `owner`."
6374 },
6375 "sort": {
6376 "type": "string",
6377 "enum": [
6378 "created",
6379 "updated",
6380 "pushed",
6381 "full_name"
6382 ],
6383 "default": "full_name",
6384 "description": "Possible values: `created`, `updated`, `pushed`, `full_name`. Default: `full_name`."
6385 },
6386 "direction": {
6387 "type": "string",
6388 "enum": [
6389 "asc",
6390 "desc"
6391 ],
6392 "default": "desc"
6393 },
6394 "page": {
6395 "type": "number",
6396 "description": "Page number of the results to fetch."
6397 },
6398 "per_page": {
6399 "type": "number",
6400 "default": "30",
6401 "description": "A custom page size up to 100. Default is 30."
6402 }
6403 },
6404 "description": "List public repositories for the specified user."
6405 },
6406 "getForOrg": {
6407 "url": "/orgs/:org/repos",
6408 "method": "GET",
6409 "params": {
6410 "org": {
6411 "type": "string",
6412 "required": true
6413 },
6414 "type": {
6415 "type": "string",
6416 "enum": [
6417 "all",
6418 "public",
6419 "private",
6420 "forks",
6421 "sources",
6422 "member"
6423 ],
6424 "default": "all",
6425 "description": "Possible values: `all`, `public`, `private`, `forks`, `sources`, `member`. Default: `all`."
6426 },
6427 "page": {
6428 "type": "number",
6429 "description": "Page number of the results to fetch."
6430 },
6431 "per_page": {
6432 "type": "number",
6433 "default": "30",
6434 "description": "A custom page size up to 100. Default is 30."
6435 }
6436 },
6437 "description": "List repositories for the specified org."
6438 },
6439 "getPublic": {
6440 "url": "/repositories",
6441 "method": "GET",
6442 "params": {
6443 "since": {
6444 "type": "string",
6445 "description": "The integer ID of the last Repository that you've seen."
6446 },
6447 "page": {
6448 "type": "number",
6449 "description": "Page number of the results to fetch."
6450 },
6451 "per_page": {
6452 "type": "number",
6453 "default": "30",
6454 "description": "A custom page size up to 100. Default is 30."
6455 }
6456 },
6457 "description": "List all public repositories"
6458 },
6459 "createForOrg": {
6460 "url": "/orgs/:org/repos",
6461 "method": "POST",
6462 "params": {
6463 "org": {
6464 "type": "string",
6465 "required": true
6466 },
6467 "name": {
6468 "type": "string",
6469 "required": true
6470 },
6471 "description": {
6472 "type": "string"
6473 },
6474 "homepage": {
6475 "type": "string"
6476 },
6477 "private": {
6478 "type": "boolean",
6479 "default": "false",
6480 "description": "True to create a private repository, false to create a public one. Creating private repositories requires a paid GitHub account. Default is false."
6481 },
6482 "has_issues": {
6483 "type": "boolean",
6484 "default": "true",
6485 "description": "True to enable issues for this repository, false to disable them. Default is true."
6486 },
6487 "has_projects": {
6488 "type": "boolean",
6489 "default": "true",
6490 "description": "True to enable projects for this repository, false to disable them. Default is true."
6491 },
6492 "has_wiki": {
6493 "type": "boolean",
6494 "default": "true",
6495 "description": "True to enable the wiki for this repository, false to disable it. Default is true."
6496 },
6497 "team_id": {
6498 "type": "number",
6499 "description": "The id of the team that will be granted access to this repository. This is only valid when creating a repository in an organization."
6500 },
6501 "auto_init": {
6502 "type": "boolean",
6503 "default": "false",
6504 "description": "True to create an initial commit with empty README. Default is false"
6505 },
6506 "gitignore_template": {
6507 "type": "string",
6508 "description": "Desired language or platform .gitignore template to apply. Ignored if auto_init parameter is not provided."
6509 },
6510 "license_template": {
6511 "type": "string",
6512 "description": "Desired LICENSE template to apply. Use the name of the template without the extension. For example, \"mit\" or \"mozilla\"."
6513 },
6514 "allow_squash_merge": {
6515 "type": "boolean",
6516 "default": "true",
6517 "description": "Either true to allow squash-merging pull requests, or false to prevent squash-merging. Default: true. (In preview period. See README.)"
6518 },
6519 "allow_merge_commit": {
6520 "type": "boolean",
6521 "default": "true",
6522 "description": "Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Default: true. (In preview period. See README.)"
6523 },
6524 "allow_rebase_merge": {
6525 "type": "boolean",
6526 "default": "true",
6527 "description": "Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Default: true. (In preview period. See README.)"
6528 }
6529 },
6530 "description": "Create a new repository for an organization."
6531 },
6532 "getById": {
6533 "url": "/repositories/:id",
6534 "method": "GET",
6535 "params": {
6536 "id": {
6537 "type": "string",
6538 "required": true
6539 }
6540 },
6541 "description": "Get a single repo by id."
6542 },
6543 "getTopics": {
6544 "url": "/repos/:owner/:repo/topics",
6545 "method": "GET",
6546 "headers": {
6547 "accept": "application/vnd.github.mercy-preview+json"
6548 },
6549 "params": {
6550 "owner": {
6551 "type": "string",
6552 "required": true
6553 },
6554 "repo": {
6555 "type": "string",
6556 "required": true
6557 },
6558 "page": {
6559 "type": "number",
6560 "description": "Page number of the results to fetch."
6561 },
6562 "per_page": {
6563 "type": "number",
6564 "default": "30",
6565 "description": "A custom page size up to 100. Default is 30."
6566 }
6567 },
6568 "description": "List all topics for a repository. (In preview period. See README.)"
6569 },
6570 "replaceTopics": {
6571 "url": "/repos/:owner/:repo/topics",
6572 "method": "PUT",
6573 "headers": {
6574 "accept": "application/vnd.github.mercy-preview+json"
6575 },
6576 "params": {
6577 "owner": {
6578 "type": "string",
6579 "required": true
6580 },
6581 "repo": {
6582 "type": "string",
6583 "required": true
6584 },
6585 "names": {
6586 "type": "string[]",
6587 "required": true,
6588 "description": "An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository."
6589 }
6590 },
6591 "description": "Replace all topics for a repository. (In preview period. See README.)"
6592 },
6593 "getContributors": {
6594 "url": "/repos/:owner/:repo/contributors",
6595 "method": "GET",
6596 "params": {
6597 "owner": {
6598 "type": "string",
6599 "required": true
6600 },
6601 "repo": {
6602 "type": "string",
6603 "required": true
6604 },
6605 "anon": {
6606 "type": "boolean",
6607 "description": "Set to 1 or true to include anonymous contributors in results."
6608 },
6609 "page": {
6610 "type": "number",
6611 "description": "Page number of the results to fetch."
6612 },
6613 "per_page": {
6614 "type": "number",
6615 "default": "30",
6616 "description": "A custom page size up to 100. Default is 30."
6617 }
6618 },
6619 "description": "Get contributors for the specified repository."
6620 },
6621 "getLanguages": {
6622 "url": "/repos/:owner/:repo/languages",
6623 "method": "GET",
6624 "params": {
6625 "owner": {
6626 "type": "string",
6627 "required": true
6628 },
6629 "repo": {
6630 "type": "string",
6631 "required": true
6632 },
6633 "page": {
6634 "type": "number",
6635 "description": "Page number of the results to fetch."
6636 },
6637 "per_page": {
6638 "type": "number",
6639 "default": "30",
6640 "description": "A custom page size up to 100. Default is 30."
6641 }
6642 },
6643 "description": "Get languages for the specified repository."
6644 },
6645 "getTeams": {
6646 "url": "/repos/:owner/:repo/teams",
6647 "method": "GET",
6648 "params": {
6649 "owner": {
6650 "type": "string",
6651 "required": true
6652 },
6653 "repo": {
6654 "type": "string",
6655 "required": true
6656 },
6657 "page": {
6658 "type": "number",
6659 "description": "Page number of the results to fetch."
6660 },
6661 "per_page": {
6662 "type": "number",
6663 "default": "30",
6664 "description": "A custom page size up to 100. Default is 30."
6665 }
6666 },
6667 "description": "Get teams for the specified repository."
6668 },
6669 "getTags": {
6670 "url": "/repos/:owner/:repo/tags",
6671 "method": "GET",
6672 "params": {
6673 "owner": {
6674 "type": "string",
6675 "required": true
6676 },
6677 "repo": {
6678 "type": "string",
6679 "required": true
6680 },
6681 "page": {
6682 "type": "number",
6683 "description": "Page number of the results to fetch."
6684 },
6685 "per_page": {
6686 "type": "number",
6687 "default": "30",
6688 "description": "A custom page size up to 100. Default is 30."
6689 }
6690 },
6691 "description": "Get tags for the specified repository."
6692 },
6693 "getBranches": {
6694 "url": "/repos/:owner/:repo/branches",
6695 "method": "GET",
6696 "params": {
6697 "owner": {
6698 "type": "string",
6699 "required": true
6700 },
6701 "repo": {
6702 "type": "string",
6703 "required": true
6704 },
6705 "protected": {
6706 "type": "boolean",
6707 "description": "Set to true to only return protected branches"
6708 },
6709 "page": {
6710 "type": "number",
6711 "description": "Page number of the results to fetch."
6712 },
6713 "per_page": {
6714 "type": "number",
6715 "default": "30",
6716 "description": "A custom page size up to 100. Default is 30."
6717 }
6718 },
6719 "description": "List branches."
6720 },
6721 "getBranch": {
6722 "url": "/repos/:owner/:repo/branches/:branch",
6723 "method": "GET",
6724 "params": {
6725 "owner": {
6726 "type": "string",
6727 "required": true
6728 },
6729 "repo": {
6730 "type": "string",
6731 "required": true
6732 },
6733 "branch": {
6734 "type": "string",
6735 "required": true
6736 },
6737 "page": {
6738 "type": "number",
6739 "description": "Page number of the results to fetch."
6740 },
6741 "per_page": {
6742 "type": "number",
6743 "default": "30",
6744 "description": "A custom page size up to 100. Default is 30."
6745 }
6746 },
6747 "description": "Get branch."
6748 },
6749 "getBranchProtection": {
6750 "url": "/repos/:owner/:repo/branches/:branch/protection",
6751 "method": "GET",
6752 "params": {
6753 "owner": {
6754 "type": "string",
6755 "required": true
6756 },
6757 "repo": {
6758 "type": "string",
6759 "required": true
6760 },
6761 "branch": {
6762 "type": "string",
6763 "required": true
6764 },
6765 "page": {
6766 "type": "number",
6767 "description": "Page number of the results to fetch."
6768 },
6769 "per_page": {
6770 "type": "number",
6771 "default": "30",
6772 "description": "A custom page size up to 100. Default is 30."
6773 }
6774 },
6775 "description": "Get branch protection."
6776 },
6777 "updateBranchProtection": {
6778 "url": "/repos/:owner/:repo/branches/:branch/protection",
6779 "method": "PUT",
6780 "params": {
6781 "owner": {
6782 "type": "string",
6783 "required": true
6784 },
6785 "repo": {
6786 "type": "string",
6787 "required": true
6788 },
6789 "branch": {
6790 "type": "string",
6791 "required": true
6792 },
6793 "required_status_checks": {
6794 "type": "json",
6795 "required": true,
6796 "allow-null": true,
6797 "description": "JSON object that contains the following keys: `include_admins` - Enforce required status checks for repository administrators, `strict` - Require branches to be up to date before merging, `contexts` - The list of status checks to require in order to merge into this branch. This object can have the value of `null` for disabled."
6798 },
6799 "required_pull_request_reviews": {
6800 "type": "json",
6801 "required": true,
6802 "allow-null": true,
6803 "description": "JSON object that contains the following keys: `include_admins` - Enforce required status checks for repository administrators."
6804 },
6805 "dismissal_restrictions": {
6806 "type": "json",
6807 "allow-null": true,
6808 "description": "JSON object that contains the following keys: `users` - The list of user logins with dismissal access, `teams` - The list of team slugs with dismissal access. This object can have the value of `null` for disabled."
6809 },
6810 "restrictions": {
6811 "type": "json",
6812 "required": true,
6813 "allow-null": true,
6814 "description": "JSON object that contains the following keys: `users` - The list of user logins with push access, `teams` - The list of team slugs with push access. This object can have the value of `null` for disabled."
6815 },
6816 "enforce_admins": {
6817 "type": "boolean",
6818 "required": true,
6819 "allow-null": false,
6820 "description": "Enforces required status checks for repository administrators."
6821 },
6822 "page": {
6823 "type": "number",
6824 "description": "Page number of the results to fetch."
6825 },
6826 "per_page": {
6827 "type": "number",
6828 "default": "30",
6829 "description": "A custom page size up to 100. Default is 30."
6830 }
6831 },
6832 "description": "Update branch protection."
6833 },
6834 "removeBranchProtection": {
6835 "url": "/repos/:owner/:repo/branches/:branch/protection",
6836 "method": "DELETE",
6837 "params": {
6838 "owner": {
6839 "type": "string",
6840 "required": true
6841 },
6842 "repo": {
6843 "type": "string",
6844 "required": true
6845 },
6846 "branch": {
6847 "type": "string",
6848 "required": true
6849 }
6850 },
6851 "description": "Remove branch protection."
6852 },
6853 "getProtectedBranchRequiredStatusChecks": {
6854 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks",
6855 "method": "GET",
6856 "params": {
6857 "owner": {
6858 "type": "string",
6859 "required": true
6860 },
6861 "repo": {
6862 "type": "string",
6863 "required": true
6864 },
6865 "branch": {
6866 "type": "string",
6867 "required": true
6868 },
6869 "page": {
6870 "type": "number",
6871 "description": "Page number of the results to fetch."
6872 },
6873 "per_page": {
6874 "type": "number",
6875 "default": "30",
6876 "description": "A custom page size up to 100. Default is 30."
6877 }
6878 },
6879 "description": "Get required status checks of protected branch."
6880 },
6881 "updateProtectedBranchRequiredStatusChecks": {
6882 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks",
6883 "method": "PATCH",
6884 "params": {
6885 "owner": {
6886 "type": "string",
6887 "required": true
6888 },
6889 "repo": {
6890 "type": "string",
6891 "required": true
6892 },
6893 "branch": {
6894 "type": "string",
6895 "required": true
6896 },
6897 "strict": {
6898 "type": "boolean",
6899 "description": "Require branches to be up to date before merging."
6900 },
6901 "contexts": {
6902 "type": "string[]",
6903 "description": "The list of status checks to require in order to merge into this branch."
6904 }
6905 },
6906 "description": "Update required status checks of protected branch."
6907 },
6908 "removeProtectedBranchRequiredStatusChecks": {
6909 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks",
6910 "method": "DELETE",
6911 "params": {
6912 "owner": {
6913 "type": "string",
6914 "required": true
6915 },
6916 "repo": {
6917 "type": "string",
6918 "required": true
6919 },
6920 "branch": {
6921 "type": "string",
6922 "required": true
6923 }
6924 },
6925 "description": "Remove required status checks of protected branch."
6926 },
6927 "getProtectedBranchRequiredStatusChecksContexts": {
6928 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts",
6929 "method": "GET",
6930 "params": {
6931 "owner": {
6932 "type": "string",
6933 "required": true
6934 },
6935 "repo": {
6936 "type": "string",
6937 "required": true
6938 },
6939 "branch": {
6940 "type": "string",
6941 "required": true
6942 },
6943 "page": {
6944 "type": "number",
6945 "description": "Page number of the results to fetch."
6946 },
6947 "per_page": {
6948 "type": "number",
6949 "default": "30",
6950 "description": "A custom page size up to 100. Default is 30."
6951 }
6952 },
6953 "description": "List required status checks contexts of protected branch."
6954 },
6955 "replaceProtectedBranchRequiredStatusChecksContexts": {
6956 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts",
6957 "method": "PUT",
6958 "params": {
6959 "owner": {
6960 "type": "string",
6961 "required": true
6962 },
6963 "repo": {
6964 "type": "string",
6965 "required": true
6966 },
6967 "branch": {
6968 "type": "string",
6969 "required": true
6970 },
6971 "contexts": {
6972 "type": "string[]",
6973 "required": true,
6974 "mapTo": "input",
6975 "description": "An array of protected branch required status checks contexts (e.g. continuous-integration/jenkins)."
6976 }
6977 },
6978 "description": "Replace required status checks contexts of protected branch."
6979 },
6980 "addProtectedBranchRequiredStatusChecksContexts": {
6981 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts",
6982 "method": "POST",
6983 "params": {
6984 "owner": {
6985 "type": "string",
6986 "required": true
6987 },
6988 "repo": {
6989 "type": "string",
6990 "required": true
6991 },
6992 "branch": {
6993 "type": "string",
6994 "required": true
6995 },
6996 "contexts": {
6997 "type": "string[]",
6998 "required": true,
6999 "mapTo": "input",
7000 "description": "An array of protected branch required status checks contexts (e.g. continuous-integration/jenkins)."
7001 }
7002 },
7003 "description": "Add required status checks contexts of protected branch."
7004 },
7005 "removeProtectedBranchRequiredStatusChecksContexts": {
7006 "url": "/repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts",
7007 "method": "DELETE",
7008 "params": {
7009 "owner": {
7010 "type": "string",
7011 "required": true
7012 },
7013 "repo": {
7014 "type": "string",
7015 "required": true
7016 },
7017 "branch": {
7018 "type": "string",
7019 "required": true
7020 },
7021 "contexts": {
7022 "type": "string[]",
7023 "required": true,
7024 "mapTo": "input",
7025 "description": "An array of protected branch required status checks contexts (e.g. continuous-integration/jenkins)."
7026 }
7027 },
7028 "description": "Remove required status checks contexts of protected branch."
7029 },
7030 "getProtectedBranchPullRequestReviewEnforcement": {
7031 "url": "/repos/:owner/:repo/branches/:branch/protection/required_pull_request_reviews",
7032 "method": "GET",
7033 "params": {
7034 "owner": {
7035 "type": "string",
7036 "required": true
7037 },
7038 "repo": {
7039 "type": "string",
7040 "required": true
7041 },
7042 "branch": {
7043 "type": "string",
7044 "required": true
7045 },
7046 "page": {
7047 "type": "number",
7048 "description": "Page number of the results to fetch."
7049 },
7050 "per_page": {
7051 "type": "number",
7052 "default": "30",
7053 "description": "A custom page size up to 100. Default is 30."
7054 }
7055 },
7056 "description": "Get pull request review enforcement of protected branch."
7057 },
7058 "updateProtectedBranchPullRequestReviewEnforcement": {
7059 "url": "/repos/:owner/:repo/branches/:branch/protection/required_pull_request_reviews",
7060 "method": "PATCH",
7061 "params": {
7062 "owner": {
7063 "type": "string",
7064 "required": true
7065 },
7066 "repo": {
7067 "type": "string",
7068 "required": true
7069 },
7070 "branch": {
7071 "type": "string",
7072 "required": true
7073 },
7074 "dismissal_restrictions": {
7075 "type": "json",
7076 "allow-null": true,
7077 "description": "JSON object that contains the following keys: `users` - The list of user logins with dismissal access, `teams` - The list of team slugs with dismissal access. This object can have the value of `null` for disabled."
7078 },
7079 "dismiss_stale_reviews": {
7080 "type": "boolean",
7081 "description": "Dismiss approved reviews automatically when a new commit is pushed."
7082 },
7083 "require_code_owner_reviews": {
7084 "type": "boolean",
7085 "description": "Blocks merge until code owners have reviewed."
7086 }
7087 },
7088 "description": "Update pull request review enforcement of protected branch."
7089 },
7090 "removeProtectedBranchPullRequestReviewEnforcement": {
7091 "url": "/repos/:owner/:repo/branches/:branch/protection/required_pull_request_reviews",
7092 "method": "DELETE",
7093 "params": {
7094 "owner": {
7095 "type": "string",
7096 "required": true
7097 },
7098 "repo": {
7099 "type": "string",
7100 "required": true
7101 },
7102 "branch": {
7103 "type": "string",
7104 "required": true
7105 }
7106 },
7107 "description": "Remove pull request review enforcement of protected branch."
7108 },
7109 "getProtectedBranchAdminEnforcement": {
7110 "url": "/repos/:owner/:repo/branches/:branch/protection/enforce_admins",
7111 "method": "GET",
7112 "params": {
7113 "owner": {
7114 "type": "string",
7115 "required": true
7116 },
7117 "repo": {
7118 "type": "string",
7119 "required": true
7120 },
7121 "branch": {
7122 "type": "string",
7123 "required": true
7124 },
7125 "page": {
7126 "type": "number",
7127 "description": "Page number of the results to fetch."
7128 },
7129 "per_page": {
7130 "type": "number",
7131 "default": "30",
7132 "description": "A custom page size up to 100. Default is 30."
7133 }
7134 },
7135 "description": "Get admin enforcement of protected branch."
7136 },
7137 "addProtectedBranchAdminEnforcement": {
7138 "url": "/repos/:owner/:repo/branches/:branch/protection/enforce_admins",
7139 "method": "POST",
7140 "params": {
7141 "owner": {
7142 "type": "string",
7143 "required": true
7144 },
7145 "repo": {
7146 "type": "string",
7147 "required": true
7148 },
7149 "branch": {
7150 "type": "string",
7151 "required": true
7152 },
7153 "page": {
7154 "type": "number",
7155 "description": "Page number of the results to fetch."
7156 },
7157 "per_page": {
7158 "type": "number",
7159 "default": "30",
7160 "description": "A custom page size up to 100. Default is 30."
7161 }
7162 },
7163 "description": "Add admin enforcement of protected branch."
7164 },
7165 "removeProtectedBranchAdminEnforcement": {
7166 "url": "/repos/:owner/:repo/branches/:branch/protection/enforce_admins",
7167 "method": "DELETE",
7168 "params": {
7169 "owner": {
7170 "type": "string",
7171 "required": true
7172 },
7173 "repo": {
7174 "type": "string",
7175 "required": true
7176 },
7177 "branch": {
7178 "type": "string",
7179 "required": true
7180 }
7181 },
7182 "description": "Remove admin enforcement of protected branch."
7183 },
7184 "getProtectedBranchRestrictions": {
7185 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions",
7186 "method": "GET",
7187 "params": {
7188 "owner": {
7189 "type": "string",
7190 "required": true
7191 },
7192 "repo": {
7193 "type": "string",
7194 "required": true
7195 },
7196 "branch": {
7197 "type": "string",
7198 "required": true
7199 },
7200 "page": {
7201 "type": "number",
7202 "description": "Page number of the results to fetch."
7203 },
7204 "per_page": {
7205 "type": "number",
7206 "default": "30",
7207 "description": "A custom page size up to 100. Default is 30."
7208 }
7209 },
7210 "description": "Get restrictions of protected branch."
7211 },
7212 "removeProtectedBranchRestrictions": {
7213 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions",
7214 "method": "DELETE",
7215 "params": {
7216 "owner": {
7217 "type": "string",
7218 "required": true
7219 },
7220 "repo": {
7221 "type": "string",
7222 "required": true
7223 },
7224 "branch": {
7225 "type": "string",
7226 "required": true
7227 }
7228 },
7229 "description": "Remove restrictions of protected branch."
7230 },
7231 "getProtectedBranchTeamRestrictions": {
7232 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/teams",
7233 "method": "GET",
7234 "params": {
7235 "owner": {
7236 "type": "string",
7237 "required": true
7238 },
7239 "repo": {
7240 "type": "string",
7241 "required": true
7242 },
7243 "branch": {
7244 "type": "string",
7245 "required": true
7246 },
7247 "page": {
7248 "type": "number",
7249 "description": "Page number of the results to fetch."
7250 },
7251 "per_page": {
7252 "type": "number",
7253 "default": "30",
7254 "description": "A custom page size up to 100. Default is 30."
7255 }
7256 },
7257 "description": "List team restrictions of protected branch."
7258 },
7259 "replaceProtectedBranchTeamRestrictions": {
7260 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/teams",
7261 "method": "PUT",
7262 "params": {
7263 "owner": {
7264 "type": "string",
7265 "required": true
7266 },
7267 "repo": {
7268 "type": "string",
7269 "required": true
7270 },
7271 "branch": {
7272 "type": "string",
7273 "required": true
7274 },
7275 "teams": {
7276 "type": "string[]",
7277 "required": true,
7278 "mapTo": "input",
7279 "description": "An array of team slugs (e.g. justice-league)."
7280 }
7281 },
7282 "description": "Replace team restrictions of protected branch."
7283 },
7284 "addProtectedBranchTeamRestrictions": {
7285 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/teams",
7286 "method": "POST",
7287 "params": {
7288 "owner": {
7289 "type": "string",
7290 "required": true
7291 },
7292 "repo": {
7293 "type": "string",
7294 "required": true
7295 },
7296 "branch": {
7297 "type": "string",
7298 "required": true
7299 },
7300 "teams": {
7301 "type": "string[]",
7302 "required": true,
7303 "mapTo": "input",
7304 "description": "An array of team slugs (e.g. justice-league)."
7305 }
7306 },
7307 "description": "Add team restrictions of protected branch."
7308 },
7309 "removeProtectedBranchTeamRestrictions": {
7310 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/teams",
7311 "method": "DELETE",
7312 "params": {
7313 "owner": {
7314 "type": "string",
7315 "required": true
7316 },
7317 "repo": {
7318 "type": "string",
7319 "required": true
7320 },
7321 "branch": {
7322 "type": "string",
7323 "required": true
7324 },
7325 "teams": {
7326 "type": "string[]",
7327 "required": true,
7328 "mapTo": "input",
7329 "description": "An array of team slugs (e.g. justice-league)."
7330 }
7331 },
7332 "description": "Remove team restrictions of protected branch."
7333 },
7334 "getProtectedBranchUserRestrictions": {
7335 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/users",
7336 "method": "GET",
7337 "params": {
7338 "owner": {
7339 "type": "string",
7340 "required": true
7341 },
7342 "repo": {
7343 "type": "string",
7344 "required": true
7345 },
7346 "branch": {
7347 "type": "string",
7348 "required": true
7349 },
7350 "page": {
7351 "type": "number",
7352 "description": "Page number of the results to fetch."
7353 },
7354 "per_page": {
7355 "type": "number",
7356 "default": "30",
7357 "description": "A custom page size up to 100. Default is 30."
7358 }
7359 },
7360 "description": "List user restrictions of protected branch."
7361 },
7362 "replaceProtectedBranchUserRestrictions": {
7363 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/users",
7364 "method": "PUT",
7365 "params": {
7366 "owner": {
7367 "type": "string",
7368 "required": true
7369 },
7370 "repo": {
7371 "type": "string",
7372 "required": true
7373 },
7374 "branch": {
7375 "type": "string",
7376 "required": true
7377 },
7378 "users": {
7379 "type": "string[]",
7380 "required": true,
7381 "mapTo": "input",
7382 "description": "An array of team slugs (e.g. justice-league)."
7383 }
7384 },
7385 "description": "Replace user restrictions of protected branch."
7386 },
7387 "addProtectedBranchUserRestrictions": {
7388 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/users",
7389 "method": "POST",
7390 "params": {
7391 "owner": {
7392 "type": "string",
7393 "required": true
7394 },
7395 "repo": {
7396 "type": "string",
7397 "required": true
7398 },
7399 "branch": {
7400 "type": "string",
7401 "required": true
7402 },
7403 "users": {
7404 "type": "string[]",
7405 "required": true,
7406 "mapTo": "input",
7407 "description": "An array of team slugs (e.g. justice-league)."
7408 }
7409 },
7410 "description": "Add user restrictions of protected branch."
7411 },
7412 "removeProtectedBranchUserRestrictions": {
7413 "url": "/repos/:owner/:repo/branches/:branch/protection/restrictions/users",
7414 "method": "DELETE",
7415 "params": {
7416 "owner": {
7417 "type": "string",
7418 "required": true
7419 },
7420 "repo": {
7421 "type": "string",
7422 "required": true
7423 },
7424 "branch": {
7425 "type": "string",
7426 "required": true
7427 },
7428 "users": {
7429 "type": "string[]",
7430 "required": true,
7431 "mapTo": "input",
7432 "description": "An array of team slugs (e.g. justice-league)."
7433 }
7434 },
7435 "description": "Remove user restrictions of protected branch."
7436 },
7437 "getCollaborators": {
7438 "url": "/repos/:owner/:repo/collaborators",
7439 "method": "GET",
7440 "params": {
7441 "owner": {
7442 "type": "string",
7443 "required": true
7444 },
7445 "repo": {
7446 "type": "string",
7447 "required": true
7448 },
7449 "affiliation": {
7450 "type": "string",
7451 "enum": [
7452 "outside",
7453 "all",
7454 "direct"
7455 ],
7456 "default": "all",
7457 "description": "Filter collaborators returned by their affiliation."
7458 },
7459 "page": {
7460 "type": "number",
7461 "description": "Page number of the results to fetch."
7462 },
7463 "per_page": {
7464 "type": "number",
7465 "default": "30",
7466 "description": "A custom page size up to 100. Default is 30."
7467 }
7468 },
7469 "description": "List collaborators"
7470 },
7471 "checkCollaborator": {
7472 "url": "/repos/:owner/:repo/collaborators/:username",
7473 "method": "GET",
7474 "params": {
7475 "owner": {
7476 "type": "string",
7477 "required": true
7478 },
7479 "repo": {
7480 "type": "string",
7481 "required": true
7482 },
7483 "username": {
7484 "type": "string",
7485 "required": true
7486 }
7487 },
7488 "description": "Check if user is a collaborator."
7489 },
7490 "reviewUserPermissionLevel": {
7491 "url": "/repos/:owner/:repo/collaborators/:username/permission",
7492 "method": "GET",
7493 "params": {
7494 "owner": {
7495 "type": "string",
7496 "required": true
7497 },
7498 "repo": {
7499 "type": "string",
7500 "required": true
7501 },
7502 "username": {
7503 "type": "string",
7504 "required": true
7505 }
7506 },
7507 "description": "Review a user's permission level."
7508 },
7509 "addCollaborator": {
7510 "url": "/repos/:owner/:repo/collaborators/:username",
7511 "method": "PUT",
7512 "params": {
7513 "owner": {
7514 "type": "string",
7515 "required": true
7516 },
7517 "repo": {
7518 "type": "string",
7519 "required": true
7520 },
7521 "username": {
7522 "type": "string",
7523 "required": true
7524 },
7525 "permission": {
7526 "type": "string",
7527 "enum": [
7528 "pull",
7529 "push",
7530 "admin"
7531 ],
7532 "default": "push",
7533 "description": "`pull` - can pull, but not push to or administer this repository, `push` - can pull and push, but not administer this repository, `admin` - can pull, push and administer this repository."
7534 }
7535 },
7536 "description": "Add user as a collaborator"
7537 },
7538 "removeCollaborator": {
7539 "url": "/repos/:owner/:repo/collaborators/:username",
7540 "method": "DELETE",
7541 "params": {
7542 "owner": {
7543 "type": "string",
7544 "required": true
7545 },
7546 "repo": {
7547 "type": "string",
7548 "required": true
7549 },
7550 "username": {
7551 "type": "string",
7552 "required": true
7553 }
7554 },
7555 "description": "Remove user as a collaborator."
7556 },
7557 "getAllCommitComments": {
7558 "url": "/repos/:owner/:repo/comments",
7559 "method": "GET",
7560 "params": {
7561 "owner": {
7562 "type": "string",
7563 "required": true
7564 },
7565 "repo": {
7566 "type": "string",
7567 "required": true
7568 },
7569 "page": {
7570 "type": "number",
7571 "description": "Page number of the results to fetch."
7572 },
7573 "per_page": {
7574 "type": "number",
7575 "default": "30",
7576 "description": "A custom page size up to 100. Default is 30."
7577 }
7578 },
7579 "description": "List commit comments for a repository."
7580 },
7581 "getCommitComments": {
7582 "url": "/repos/:owner/:repo/commits/:ref/comments",
7583 "method": "GET",
7584 "params": {
7585 "owner": {
7586 "type": "string",
7587 "required": true
7588 },
7589 "repo": {
7590 "type": "string",
7591 "required": true
7592 },
7593 "ref": {
7594 "type": "string",
7595 "required": true
7596 },
7597 "page": {
7598 "type": "number",
7599 "description": "Page number of the results to fetch."
7600 },
7601 "per_page": {
7602 "type": "number",
7603 "default": "30",
7604 "description": "A custom page size up to 100. Default is 30."
7605 }
7606 },
7607 "description": "List comments for a single commit."
7608 },
7609 "createCommitComment": {
7610 "url": "/repos/:owner/:repo/commits/:sha/comments",
7611 "method": "POST",
7612 "params": {
7613 "owner": {
7614 "type": "string",
7615 "required": true
7616 },
7617 "repo": {
7618 "type": "string",
7619 "required": true
7620 },
7621 "sha": {
7622 "type": "string",
7623 "required": true
7624 },
7625 "body": {
7626 "type": "string",
7627 "required": true
7628 },
7629 "path": {
7630 "type": "string",
7631 "description": "Relative path of the file to comment on."
7632 },
7633 "position": {
7634 "type": "number",
7635 "description": "Line index in the diff to comment on."
7636 }
7637 },
7638 "description": "Create a commit comment."
7639 },
7640 "getCommitComment": {
7641 "url": "/repos/:owner/:repo/comments/:id",
7642 "method": "GET",
7643 "params": {
7644 "owner": {
7645 "type": "string",
7646 "required": true
7647 },
7648 "repo": {
7649 "type": "string",
7650 "required": true
7651 },
7652 "id": {
7653 "type": "string",
7654 "required": true
7655 }
7656 },
7657 "description": "Get a single commit comment."
7658 },
7659 "updateCommitComment": {
7660 "url": "/repos/:owner/:repo/comments/:id",
7661 "method": "PATCH",
7662 "params": {
7663 "owner": {
7664 "type": "string",
7665 "required": true
7666 },
7667 "repo": {
7668 "type": "string",
7669 "required": true
7670 },
7671 "id": {
7672 "type": "string",
7673 "required": true
7674 },
7675 "body": {
7676 "type": "string",
7677 "required": true
7678 }
7679 },
7680 "description": "Update a commit comment."
7681 },
7682 "deleteCommitComment": {
7683 "url": "/repos/:owner/:repo/comments/:id",
7684 "method": "DELETE",
7685 "params": {
7686 "owner": {
7687 "type": "string",
7688 "required": true
7689 },
7690 "repo": {
7691 "type": "string",
7692 "required": true
7693 },
7694 "id": {
7695 "type": "string",
7696 "required": true
7697 }
7698 },
7699 "description": "Delete a commit comment."
7700 },
7701 "getCommunityProfileMetrics": {
7702 "url": "/repos/:owner/:name/community/profile",
7703 "method": "GET",
7704 "headers": {
7705 "accept": "application/vnd.github.black-panther-preview+json"
7706 },
7707 "params": {
7708 "owner": {
7709 "type": "string",
7710 "required": true
7711 },
7712 "name": {
7713 "type": "string",
7714 "required": true
7715 }
7716 },
7717 "description": "Retrieve community profile metrics."
7718 },
7719 "getCommits": {
7720 "url": "/repos/:owner/:repo/commits",
7721 "method": "GET",
7722 "params": {
7723 "owner": {
7724 "type": "string",
7725 "required": true
7726 },
7727 "repo": {
7728 "type": "string",
7729 "required": true
7730 },
7731 "sha": {
7732 "type": "string",
7733 "description": "Sha or branch to start listing commits from."
7734 },
7735 "path": {
7736 "type": "string",
7737 "description": "Only commits containing this file path will be returned."
7738 },
7739 "author": {
7740 "type": "string",
7741 "description": "GitHub login or email address by which to filter by commit author."
7742 },
7743 "since": {
7744 "type": "date",
7745 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
7746 },
7747 "until": {
7748 "type": "date",
7749 "description": "Timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ"
7750 },
7751 "page": {
7752 "type": "number",
7753 "description": "Page number of the results to fetch."
7754 },
7755 "per_page": {
7756 "type": "number",
7757 "default": "30",
7758 "description": "A custom page size up to 100. Default is 30."
7759 }
7760 },
7761 "description": "List commits on a repository."
7762 },
7763 "getCommit": {
7764 "url": "/repos/:owner/:repo/commits/:sha",
7765 "method": "GET",
7766 "headers": {
7767 "accept": "application/vnd.github.cryptographer-preview"
7768 },
7769 "params": {
7770 "owner": {
7771 "type": "string",
7772 "required": true
7773 },
7774 "repo": {
7775 "type": "string",
7776 "required": true
7777 },
7778 "sha": {
7779 "type": "string",
7780 "required": true
7781 }
7782 },
7783 "description": "Get a single commit."
7784 },
7785 "getShaOfCommitRef": {
7786 "url": "/repos/:owner/:repo/commits/:ref",
7787 "method": "GET",
7788 "params": {
7789 "owner": {
7790 "type": "string",
7791 "required": true
7792 },
7793 "repo": {
7794 "type": "string",
7795 "required": true
7796 },
7797 "ref": {
7798 "type": "string",
7799 "required": true,
7800 "allow-empty": true,
7801 "description": "String of the name of the fully qualified reference (ie: heads/master). If it doesn’t have at least one slash, it will be rejected."
7802 }
7803 },
7804 "description": "Get the SHA-1 of a commit reference."
7805 },
7806 "compareCommits": {
7807 "url": "/repos/:owner/:repo/compare/:base...:head",
7808 "method": "GET",
7809 "params": {
7810 "owner": {
7811 "type": "string",
7812 "required": true
7813 },
7814 "repo": {
7815 "type": "string",
7816 "required": true
7817 },
7818 "base": {
7819 "type": "string",
7820 "required": true,
7821 "description": "The branch (or git ref) you want your changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repo that requests a merge to a base of another repo."
7822 },
7823 "head": {
7824 "type": "string",
7825 "required": true,
7826 "description": "The branch (or git ref) where your changes are implemented."
7827 }
7828 },
7829 "description": "Compare two commits."
7830 },
7831 "getReadme": {
7832 "url": "/repos/:owner/:repo/readme",
7833 "method": "GET",
7834 "params": {
7835 "owner": {
7836 "type": "string",
7837 "required": true
7838 },
7839 "repo": {
7840 "type": "string",
7841 "required": true
7842 },
7843 "ref": {
7844 "type": "string",
7845 "description": "The name of the commit/branch/tag. Default: the repository’s default branch (usually master)"
7846 }
7847 },
7848 "description": "Get the README for the given repository."
7849 },
7850 "getContent": {
7851 "url": "/repos/:owner/:repo/contents/:path",
7852 "method": "GET",
7853 "params": {
7854 "owner": {
7855 "type": "string",
7856 "required": true
7857 },
7858 "repo": {
7859 "type": "string",
7860 "required": true
7861 },
7862 "path": {
7863 "type": "string",
7864 "required": true,
7865 "allow-empty": true,
7866 "description": "The content path."
7867 },
7868 "ref": {
7869 "type": "string",
7870 "description": "The String name of the Commit/Branch/Tag. Defaults to master."
7871 }
7872 },
7873 "description": "Get the contents of a file or directory in a repository."
7874 },
7875 "createFile": {
7876 "url": "/repos/:owner/:repo/contents/:path",
7877 "method": "PUT",
7878 "params": {
7879 "owner": {
7880 "type": "string",
7881 "required": true
7882 },
7883 "repo": {
7884 "type": "string",
7885 "required": true
7886 },
7887 "path": {
7888 "type": "string",
7889 "required": true,
7890 "description": "The content path."
7891 },
7892 "message": {
7893 "type": "string",
7894 "required": true,
7895 "description": "The commit message."
7896 },
7897 "content": {
7898 "type": "string",
7899 "required": true,
7900 "description": "The new file content, Base64 encoded."
7901 },
7902 "branch": {
7903 "type": "string",
7904 "description": "The branch name. If not provided, uses the repository’s default branch (usually master)."
7905 },
7906 "committer": {
7907 "type": "json"
7908 },
7909 "author": {
7910 "type": "json"
7911 }
7912 },
7913 "description": "Create a new file in the given repository."
7914 },
7915 "updateFile": {
7916 "url": "/repos/:owner/:repo/contents/:path",
7917 "method": "PUT",
7918 "params": {
7919 "owner": {
7920 "type": "string",
7921 "required": true
7922 },
7923 "repo": {
7924 "type": "string",
7925 "required": true
7926 },
7927 "path": {
7928 "type": "string",
7929 "required": true,
7930 "description": "The content path."
7931 },
7932 "message": {
7933 "type": "string",
7934 "required": true,
7935 "description": "The commit message."
7936 },
7937 "content": {
7938 "type": "string",
7939 "required": true,
7940 "description": "The updated file content, Base64 encoded."
7941 },
7942 "sha": {
7943 "type": "string",
7944 "required": true,
7945 "description": "The blob SHA of the file being replaced."
7946 },
7947 "branch": {
7948 "type": "string",
7949 "description": "The branch name. If not provided, uses the repository’s default branch (usually master)."
7950 },
7951 "committer": {
7952 "type": "json"
7953 },
7954 "author": {
7955 "type": "json"
7956 }
7957 },
7958 "description": "Update a file."
7959 },
7960 "deleteFile": {
7961 "url": "/repos/:owner/:repo/contents/:path",
7962 "method": "DELETE",
7963 "params": {
7964 "owner": {
7965 "type": "string",
7966 "required": true
7967 },
7968 "repo": {
7969 "type": "string",
7970 "required": true
7971 },
7972 "path": {
7973 "type": "string",
7974 "required": true,
7975 "description": "The content path."
7976 },
7977 "message": {
7978 "type": "string",
7979 "required": true,
7980 "description": "The commit message."
7981 },
7982 "sha": {
7983 "type": "string",
7984 "required": true,
7985 "description": "The blob SHA of the file being removed."
7986 },
7987 "branch": {
7988 "type": "string",
7989 "description": "The branch name. If not provided, uses the repository’s default branch (usually master)."
7990 },
7991 "committer": {
7992 "type": "json"
7993 },
7994 "author": {
7995 "type": "json"
7996 }
7997 },
7998 "description": "Delete a file."
7999 },
8000 "getArchiveLink": {
8001 "url": "/repos/:owner/:repo/:archive_format/:ref",
8002 "method": "GET",
8003 "params": {
8004 "owner": {
8005 "type": "string",
8006 "required": true
8007 },
8008 "repo": {
8009 "type": "string",
8010 "required": true
8011 },
8012 "archive_format": {
8013 "type": "string",
8014 "required": true,
8015 "enum": [
8016 "tarball",
8017 "zipball"
8018 ],
8019 "default": "tarball",
8020 "description": "Either tarball or zipball, Deafult: tarball."
8021 },
8022 "ref": {
8023 "type": "string",
8024 "description": "A valid Git reference. Default: the repository’s default branch (usually master)."
8025 }
8026 },
8027 "description": "Get archive link."
8028 },
8029 "getDeployKeys": {
8030 "url": "/repos/:owner/:repo/keys",
8031 "method": "GET",
8032 "params": {
8033 "owner": {
8034 "type": "string",
8035 "required": true
8036 },
8037 "repo": {
8038 "type": "string",
8039 "required": true
8040 },
8041 "page": {
8042 "type": "number",
8043 "description": "Page number of the results to fetch."
8044 },
8045 "per_page": {
8046 "type": "number",
8047 "default": "30",
8048 "description": "A custom page size up to 100. Default is 30."
8049 }
8050 },
8051 "description": "List deploy keys."
8052 },
8053 "getDeployKey": {
8054 "url": "/repos/:owner/:repo/keys/:id",
8055 "method": "GET",
8056 "params": {
8057 "owner": {
8058 "type": "string",
8059 "required": true
8060 },
8061 "repo": {
8062 "type": "string",
8063 "required": true
8064 },
8065 "id": {
8066 "type": "string",
8067 "required": true
8068 }
8069 },
8070 "description": "Get a deploy key."
8071 },
8072 "addDeployKey": {
8073 "url": "/repos/:owner/:repo/keys",
8074 "method": "POST",
8075 "params": {
8076 "owner": {
8077 "type": "string",
8078 "required": true
8079 },
8080 "repo": {
8081 "type": "string",
8082 "required": true
8083 },
8084 "title": {
8085 "type": "string",
8086 "required": true
8087 },
8088 "key": {
8089 "type": "string",
8090 "required": true
8091 },
8092 "read_only": {
8093 "type": "boolean",
8094 "description": "If true, the key will only be able to read repository contents. Otherwise, the key will be able to read and write."
8095 }
8096 },
8097 "description": "Add a new deploy key."
8098 },
8099 "deleteDeployKey": {
8100 "url": "/repos/:owner/:repo/keys/:id",
8101 "method": "DELETE",
8102 "params": {
8103 "owner": {
8104 "type": "string",
8105 "required": true
8106 },
8107 "repo": {
8108 "type": "string",
8109 "required": true
8110 },
8111 "id": {
8112 "type": "string",
8113 "required": true
8114 }
8115 },
8116 "description": "Remove a deploy key."
8117 },
8118 "getDeployments": {
8119 "url": "/repos/:owner/:repo/deployments",
8120 "method": "GET",
8121 "headers": {
8122 "accept": "application/vnd.github.ant-man-preview+json"
8123 },
8124 "params": {
8125 "owner": {
8126 "type": "string",
8127 "required": true
8128 },
8129 "repo": {
8130 "type": "string",
8131 "required": true
8132 },
8133 "sha": {
8134 "type": "string",
8135 "default": "none",
8136 "description": "The short or long sha that was recorded at creation time. Default: none."
8137 },
8138 "ref": {
8139 "type": "string",
8140 "default": "none",
8141 "description": "The name of the ref. This can be a branch, tag, or sha. Default: none."
8142 },
8143 "task": {
8144 "type": "string",
8145 "default": "none",
8146 "description": "The name of the task for the deployment. e.g. deploy or deploy:migrations. Default: none."
8147 },
8148 "environment": {
8149 "type": "string",
8150 "default": "none",
8151 "description": "The name of the environment that was deployed to. e.g. staging or production. Default: none."
8152 },
8153 "page": {
8154 "type": "number",
8155 "description": "Page number of the results to fetch."
8156 },
8157 "per_page": {
8158 "type": "number",
8159 "default": "30",
8160 "description": "A custom page size up to 100. Default is 30."
8161 }
8162 },
8163 "description": "List deployments."
8164 },
8165 "getDeployment": {
8166 "url": "/repos/:owner/:repo/deployments/:deployment_id",
8167 "method": "GET",
8168 "params": {
8169 "owner": {
8170 "type": "string",
8171 "required": true
8172 },
8173 "repo": {
8174 "type": "string",
8175 "required": true
8176 },
8177 "deployment_id": {
8178 "type": "string",
8179 "required": true,
8180 "description": "The deployment id."
8181 }
8182 },
8183 "description": "Get a single Deployment. (In preview period. See README.)"
8184 },
8185 "createDeployment": {
8186 "url": "/repos/:owner/:repo/deployments",
8187 "method": "POST",
8188 "headers": {
8189 "accept": "application/vnd.github.ant-man-preview+json"
8190 },
8191 "params": {
8192 "owner": {
8193 "type": "string",
8194 "required": true
8195 },
8196 "repo": {
8197 "type": "string",
8198 "required": true
8199 },
8200 "ref": {
8201 "type": "string",
8202 "required": true,
8203 "description": "The ref to deploy. This can be a branch, tag, or sha."
8204 },
8205 "task": {
8206 "type": "string",
8207 "default": "deploy",
8208 "description": "The named task to execute. e.g. deploy or deploy:migrations. Default: deploy"
8209 },
8210 "auto_merge": {
8211 "type": "boolean",
8212 "default": "true",
8213 "description": "Optional parameter to merge the default branch into the requested ref if it is behind the default branch. Default: true"
8214 },
8215 "required_contexts": {
8216 "type": "string[]",
8217 "description": "Optional array of status contexts verified against commit status checks. If this parameter is omitted from the parameters then all unique contexts will be verified before a deployment is created. To bypass checking entirely pass an empty array. Defaults to all unique contexts."
8218 },
8219 "payload": {
8220 "type": "string",
8221 "default": "\"\"",
8222 "description": "Optional JSON payload with extra information about the deployment. Default: \"\""
8223 },
8224 "environment": {
8225 "type": "string",
8226 "default": "none",
8227 "description": "The name of the environment that was deployed to. e.g. staging or production. Default: none."
8228 },
8229 "description": {
8230 "type": "string",
8231 "default": "\"\"",
8232 "description": "Optional short description. Default: \"\""
8233 },
8234 "transient_environment": {
8235 "type": "boolean",
8236 "default": false,
8237 "description": "Specifies if the given environment is specific to the deployment and will no longer exist at some point in the future. Default: false. (In preview period. See README.)"
8238 },
8239 "production_environment": {
8240 "type": "boolean",
8241 "description": "Specifies if the given environment is a one that end-users directly interact with. Default: true when environment is `production` and false otherwise. (In preview period. See README.)"
8242 }
8243 },
8244 "description": "Create a deployment. (In preview period. See README.)"
8245 },
8246 "getDeploymentStatuses": {
8247 "url": "/repos/:owner/:repo/deployments/:id/statuses",
8248 "method": "GET",
8249 "headers": {
8250 "accept": "application/vnd.github.ant-man-preview+json"
8251 },
8252 "params": {
8253 "owner": {
8254 "type": "string",
8255 "required": true
8256 },
8257 "repo": {
8258 "type": "string",
8259 "required": true
8260 },
8261 "id": {
8262 "type": "string",
8263 "required": true
8264 }
8265 },
8266 "description": "List deployment statuses. (In preview period. See README.)"
8267 },
8268 "getDeploymentStatus": {
8269 "url": "/repos/:owner/:repo/deployments/:id/statuses/:status_id",
8270 "method": "GET",
8271 "params": {
8272 "owner": {
8273 "type": "string",
8274 "required": true
8275 },
8276 "repo": {
8277 "type": "string",
8278 "required": true
8279 },
8280 "id": {
8281 "type": "string",
8282 "required": true,
8283 "description": "The Deployment ID to list the statuses from."
8284 },
8285 "status_id": {
8286 "type": "string",
8287 "required": true,
8288 "description": "The Deployment Status ID."
8289 }
8290 },
8291 "description": "List deployment statuses. (In preview period. See README.)"
8292 },
8293 "createDeploymentStatus": {
8294 "url": "/repos/:owner/:repo/deployments/:id/statuses",
8295 "method": "POST",
8296 "headers": {
8297 "accept": "application/vnd.github.ant-man-preview+json"
8298 },
8299 "params": {
8300 "owner": {
8301 "type": "string",
8302 "required": true
8303 },
8304 "repo": {
8305 "type": "string",
8306 "required": true
8307 },
8308 "id": {
8309 "type": "string",
8310 "required": true
8311 },
8312 "state": {
8313 "type": "string",
8314 "description": "The state of the status. Can be one of pending, success, error, or failure."
8315 },
8316 "target_url": {
8317 "type": "string",
8318 "default": "\"\"",
8319 "description": "The target URL to associate with this status. This URL should contain output to keep the user updated while the task is running or serve as historical information for what happened in the deployment. Default: \"\""
8320 },
8321 "log_url": {
8322 "type": "string",
8323 "default": "\"\"",
8324 "description": "Functionally equivalent to target_url. Default: \"\". (In preview period. See README.)"
8325 },
8326 "description": {
8327 "type": "string",
8328 "default": "\"\"",
8329 "description": "A short description of the status. Default: \"\""
8330 },
8331 "environment_url": {
8332 "type": "string",
8333 "default": "\"\"",
8334 "description": "URL for accessing the deployment environment. Default: \"\". (In preview period. See README.)"
8335 },
8336 "auto_inactive": {
8337 "type": "boolean",
8338 "default": true,
8339 "description": "When true the new `inactive` status is added to all other non-transient, non-production environment deployments with the same repository and environment name as the created status's deployment. Default: true. (In preview period. See README.)"
8340 }
8341 },
8342 "description": "Create a deployment status. (In preview period. See README.)"
8343 },
8344 "getDownloads": {
8345 "url": "/repos/:owner/:repo/downloads",
8346 "method": "GET",
8347 "params": {
8348 "owner": {
8349 "type": "string",
8350 "required": true
8351 },
8352 "repo": {
8353 "type": "string",
8354 "required": true
8355 },
8356 "page": {
8357 "type": "number",
8358 "description": "Page number of the results to fetch."
8359 },
8360 "per_page": {
8361 "type": "number",
8362 "default": "30",
8363 "description": "A custom page size up to 100. Default is 30."
8364 }
8365 },
8366 "description": "List downloads for a repository."
8367 },
8368 "getDownload": {
8369 "url": "/repos/:owner/:repo/downloads/:id",
8370 "method": "GET",
8371 "params": {
8372 "owner": {
8373 "type": "string",
8374 "required": true
8375 },
8376 "repo": {
8377 "type": "string",
8378 "required": true
8379 },
8380 "id": {
8381 "type": "string",
8382 "required": true
8383 }
8384 },
8385 "description": "Get a single download."
8386 },
8387 "deleteDownload": {
8388 "url": "/repos/:owner/:repo/downloads/:id",
8389 "method": "DELETE",
8390 "params": {
8391 "owner": {
8392 "type": "string",
8393 "required": true
8394 },
8395 "repo": {
8396 "type": "string",
8397 "required": true
8398 },
8399 "id": {
8400 "type": "string",
8401 "required": true
8402 }
8403 },
8404 "description": "Delete a download."
8405 },
8406 "getForks": {
8407 "url": "/repos/:owner/:repo/forks",
8408 "method": "GET",
8409 "params": {
8410 "owner": {
8411 "type": "string",
8412 "required": true
8413 },
8414 "repo": {
8415 "type": "string",
8416 "required": true
8417 },
8418 "sort": {
8419 "type": "string",
8420 "enum": [
8421 "newest",
8422 "oldest",
8423 "stargazers"
8424 ],
8425 "default": "newest",
8426 "description": "Possible values: `newest`, `oldest`, `stargazers`, default: `newest`."
8427 },
8428 "page": {
8429 "type": "number",
8430 "description": "Page number of the results to fetch."
8431 },
8432 "per_page": {
8433 "type": "number",
8434 "default": "30",
8435 "description": "A custom page size up to 100. Default is 30."
8436 }
8437 },
8438 "description": "List forks."
8439 },
8440 "getInvites": {
8441 "url": "/repos/:owner/:repo/invitations",
8442 "method": "GET",
8443 "params": {
8444 "owner": {
8445 "type": "string",
8446 "required": true
8447 },
8448 "repo": {
8449 "type": "string",
8450 "required": true
8451 }
8452 },
8453 "description": "List invitations for a repository."
8454 },
8455 "deleteInvite": {
8456 "url": "/repos/:owner/:repo/invitations/:invitation_id",
8457 "method": "DELETE",
8458 "params": {
8459 "owner": {
8460 "type": "string",
8461 "required": true
8462 },
8463 "repo": {
8464 "type": "string",
8465 "required": true
8466 },
8467 "invitation_id": {
8468 "type": "string",
8469 "required": true
8470 }
8471 },
8472 "description": "Delete a repository invitation."
8473 },
8474 "updateInvite": {
8475 "url": "/repos/:owner/:repo/invitations/:invitation_id",
8476 "method": "PATCH",
8477 "params": {
8478 "owner": {
8479 "type": "string",
8480 "required": true
8481 },
8482 "repo": {
8483 "type": "string",
8484 "required": true
8485 },
8486 "invitation_id": {
8487 "type": "string",
8488 "required": true
8489 },
8490 "permissions": {
8491 "type": "string",
8492 "enum": [
8493 "read",
8494 "write",
8495 "admin"
8496 ],
8497 "description": "The permissions that the associated user will have on the repository."
8498 }
8499 },
8500 "description": "Update a repository invitation."
8501 },
8502 "getPages": {
8503 "url": "/repos/:owner/:repo/pages",
8504 "method": "GET",
8505 "headers": {
8506 "accept": "application/vnd.github.mister-fantastic-preview+json"
8507 },
8508 "params": {
8509 "owner": {
8510 "type": "string",
8511 "required": true
8512 },
8513 "repo": {
8514 "type": "string",
8515 "required": true
8516 },
8517 "page": {
8518 "type": "number",
8519 "description": "Page number of the results to fetch."
8520 },
8521 "per_page": {
8522 "type": "number",
8523 "default": "30",
8524 "description": "A custom page size up to 100. Default is 30."
8525 }
8526 },
8527 "description": "Get information about a Pages site. (In preview period. See README.)"
8528 },
8529 "requestPageBuild": {
8530 "url": "/repos/:owner/:repo/pages/builds",
8531 "method": "POST",
8532 "headers": {
8533 "accept": "application/vnd.github.mister-fantastic-preview+json"
8534 },
8535 "params": {
8536 "owner": {
8537 "type": "string",
8538 "required": true
8539 },
8540 "repo": {
8541 "type": "string",
8542 "required": true
8543 }
8544 },
8545 "description": "Request a page build. (In preview period. See README.)"
8546 },
8547 "getPagesBuilds": {
8548 "url": "/repos/:owner/:repo/pages/builds",
8549 "method": "GET",
8550 "headers": {
8551 "accept": "application/vnd.github.mister-fantastic-preview+json"
8552 },
8553 "params": {
8554 "owner": {
8555 "type": "string",
8556 "required": true
8557 },
8558 "repo": {
8559 "type": "string",
8560 "required": true
8561 },
8562 "page": {
8563 "type": "number",
8564 "description": "Page number of the results to fetch."
8565 },
8566 "per_page": {
8567 "type": "number",
8568 "default": "30",
8569 "description": "A custom page size up to 100. Default is 30."
8570 }
8571 },
8572 "description": "List Pages builds. (In preview period. See README.)"
8573 },
8574 "getLatestPagesBuild": {
8575 "url": "/repos/:owner/:repo/pages/builds/latest",
8576 "method": "GET",
8577 "headers": {
8578 "accept": "application/vnd.github.mister-fantastic-preview+json"
8579 },
8580 "params": {
8581 "owner": {
8582 "type": "string",
8583 "required": true
8584 },
8585 "repo": {
8586 "type": "string",
8587 "required": true
8588 }
8589 },
8590 "description": "Get latest Pages build. (In preview period. See README.)"
8591 },
8592 "getPagesBuild": {
8593 "url": "/repos/:owner/:repo/pages/builds/:id",
8594 "method": "GET",
8595 "headers": {
8596 "accept": "application/vnd.github.mister-fantastic-preview+json"
8597 },
8598 "params": {
8599 "owner": {
8600 "type": "string",
8601 "required": true
8602 },
8603 "repo": {
8604 "type": "string",
8605 "required": true
8606 },
8607 "id": {
8608 "type": "string",
8609 "required": true
8610 }
8611 },
8612 "description": "Get a specific Pages build. (In preview period. See README.)"
8613 },
8614 "getReleases": {
8615 "url": "/repos/:owner/:repo/releases",
8616 "method": "GET",
8617 "params": {
8618 "owner": {
8619 "type": "string",
8620 "required": true
8621 },
8622 "repo": {
8623 "type": "string",
8624 "required": true
8625 },
8626 "page": {
8627 "type": "number",
8628 "description": "Page number of the results to fetch."
8629 },
8630 "per_page": {
8631 "type": "number",
8632 "default": "30",
8633 "description": "A custom page size up to 100. Default is 30."
8634 }
8635 },
8636 "description": "List releases for a repository."
8637 },
8638 "getRelease": {
8639 "url": "/repos/:owner/:repo/releases/:id",
8640 "method": "GET",
8641 "params": {
8642 "owner": {
8643 "type": "string",
8644 "required": true
8645 },
8646 "repo": {
8647 "type": "string",
8648 "required": true
8649 },
8650 "id": {
8651 "type": "string",
8652 "required": true
8653 }
8654 },
8655 "description": "Get a single release."
8656 },
8657 "getLatestRelease": {
8658 "url": "/repos/:owner/:repo/releases/latest",
8659 "method": "GET",
8660 "params": {
8661 "owner": {
8662 "type": "string",
8663 "required": true
8664 },
8665 "repo": {
8666 "type": "string",
8667 "required": true
8668 }
8669 },
8670 "description": "Get the latest release."
8671 },
8672 "getReleaseByTag": {
8673 "url": "/repos/:owner/:repo/releases/tags/:tag",
8674 "method": "GET",
8675 "params": {
8676 "owner": {
8677 "type": "string",
8678 "required": true
8679 },
8680 "repo": {
8681 "type": "string",
8682 "required": true
8683 },
8684 "tag": {
8685 "type": "string",
8686 "required": true,
8687 "description": "String of the tag"
8688 }
8689 },
8690 "description": "Get a release by tag name."
8691 },
8692 "createRelease": {
8693 "url": "/repos/:owner/:repo/releases",
8694 "method": "POST",
8695 "params": {
8696 "owner": {
8697 "type": "string",
8698 "required": true
8699 },
8700 "repo": {
8701 "type": "string",
8702 "required": true
8703 },
8704 "tag_name": {
8705 "type": "string",
8706 "required": true,
8707 "description": "String of the tag"
8708 },
8709 "target_commitish": {
8710 "type": "string",
8711 "description": "Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually master)."
8712 },
8713 "name": {
8714 "type": "string"
8715 },
8716 "body": {
8717 "type": "string"
8718 },
8719 "draft": {
8720 "type": "boolean",
8721 "default": "false",
8722 "description": "true to create a draft (unpublished) release, false to create a published one. Default: false"
8723 },
8724 "prerelease": {
8725 "type": "boolean",
8726 "default": "false",
8727 "description": "true to identify the release as a prerelease. false to identify the release as a full release. Default: false"
8728 }
8729 },
8730 "description": "Create a release."
8731 },
8732 "editRelease": {
8733 "url": "/repos/:owner/:repo/releases/:id",
8734 "method": "PATCH",
8735 "params": {
8736 "owner": {
8737 "type": "string",
8738 "required": true
8739 },
8740 "repo": {
8741 "type": "string",
8742 "required": true
8743 },
8744 "id": {
8745 "type": "string",
8746 "required": true
8747 },
8748 "tag_name": {
8749 "type": "string",
8750 "required": true,
8751 "description": "String of the tag"
8752 },
8753 "target_commitish": {
8754 "type": "string",
8755 "description": "Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually master)."
8756 },
8757 "name": {
8758 "type": "string"
8759 },
8760 "body": {
8761 "type": "string"
8762 },
8763 "draft": {
8764 "type": "boolean",
8765 "default": "false",
8766 "description": "true to create a draft (unpublished) release, false to create a published one. Default: false"
8767 },
8768 "prerelease": {
8769 "type": "boolean",
8770 "default": "false",
8771 "description": "true to identify the release as a prerelease. false to identify the release as a full release. Default: false"
8772 }
8773 },
8774 "description": "Edit a release."
8775 },
8776 "deleteRelease": {
8777 "url": "/repos/:owner/:repo/releases/:id",
8778 "method": "DELETE",
8779 "params": {
8780 "owner": {
8781 "type": "string",
8782 "required": true
8783 },
8784 "repo": {
8785 "type": "string",
8786 "required": true
8787 },
8788 "id": {
8789 "type": "string",
8790 "required": true
8791 }
8792 },
8793 "description": "Delete a release"
8794 },
8795 "getAssets": {
8796 "url": "/repos/:owner/:repo/releases/:id/assets",
8797 "method": "GET",
8798 "params": {
8799 "owner": {
8800 "type": "string",
8801 "required": true
8802 },
8803 "repo": {
8804 "type": "string",
8805 "required": true
8806 },
8807 "id": {
8808 "type": "string",
8809 "required": true
8810 }
8811 },
8812 "description": "List assets for a release."
8813 },
8814 "uploadAsset": {
8815 "method": "POST",
8816 "url": ":url",
8817 "params": {
8818 "url": {
8819 "type": "string",
8820 "required": true,
8821 "description": "This endpoint makes use of a Hypermedia relation (https://developer.github.com/v3/#hypermedia) to determine which URL to access. This endpoint is provided by a URI template in the release's API response (https://developer.github.com/v3/repos/releases/#get-a-single-release). You need to use an HTTP client which supports SNI (https://en.wikipedia.org/wiki/Server_Name_Indication) to make calls to this endpoint."
8822 },
8823 "file": {
8824 "type": "object",
8825 "required": true,
8826 "mapTo": "input",
8827 "description": "A file read stream, a String or a Buffer."
8828 },
8829 "contentType": {
8830 "type": "string",
8831 "required": true,
8832 "mapTo": "headers.content-type",
8833 "description": "The content type of the asset. This should be set in the Header. Example: 'application/zip'. For a list of acceptable types, refer this list of media types (https://www.iana.org/assignments/media-types/media-types.xhtml)"
8834 },
8835 "contentLength": {
8836 "type": "number",
8837 "required": true,
8838 "mapTo": "headers.content-length",
8839 "description": "File size in bytes."
8840 },
8841 "name": {
8842 "type": "string",
8843 "required": true,
8844 "description": "The file name of the asset. This should be set in a URI query parameter."
8845 },
8846 "label": {
8847 "type": "string",
8848 "description": "An alternate short description of the asset. Used in place of the filename. This should be set in a URI query parameter."
8849 }
8850 },
8851 "description": "Upload a release asset."
8852 },
8853 "getAsset": {
8854 "url": "/repos/:owner/:repo/releases/assets/:id",
8855 "method": "GET",
8856 "params": {
8857 "owner": {
8858 "type": "string",
8859 "required": true
8860 },
8861 "repo": {
8862 "type": "string",
8863 "required": true
8864 },
8865 "id": {
8866 "type": "string",
8867 "required": true
8868 }
8869 },
8870 "description": "Get a single release asset."
8871 },
8872 "editAsset": {
8873 "url": "/repos/:owner/:repo/releases/assets/:id",
8874 "method": "PATCH",
8875 "params": {
8876 "owner": {
8877 "type": "string",
8878 "required": true
8879 },
8880 "repo": {
8881 "type": "string",
8882 "required": true
8883 },
8884 "id": {
8885 "type": "string",
8886 "required": true
8887 },
8888 "name": {
8889 "type": "string",
8890 "required": true
8891 },
8892 "label": {
8893 "type": "string",
8894 "description": "An alternate short description of the asset. Used in place of the filename."
8895 }
8896 },
8897 "description": "Edit a release asset."
8898 },
8899 "deleteAsset": {
8900 "url": "/repos/:owner/:repo/releases/assets/:id",
8901 "method": "DELETE",
8902 "params": {
8903 "owner": {
8904 "type": "string",
8905 "required": true
8906 },
8907 "repo": {
8908 "type": "string",
8909 "required": true
8910 },
8911 "id": {
8912 "type": "string",
8913 "required": true
8914 }
8915 },
8916 "description": "Delete a release asset."
8917 },
8918 "getStatsContributors": {
8919 "url": "/repos/:owner/:repo/stats/contributors",
8920 "method": "GET",
8921 "params": {
8922 "owner": {
8923 "type": "string",
8924 "required": true
8925 },
8926 "repo": {
8927 "type": "string",
8928 "required": true
8929 }
8930 },
8931 "description": "Get contributors list with additions, deletions, and commit counts."
8932 },
8933 "getStatsCommitActivity": {
8934 "url": "/repos/:owner/:repo/stats/commit_activity",
8935 "method": "GET",
8936 "params": {
8937 "owner": {
8938 "type": "string",
8939 "required": true
8940 },
8941 "repo": {
8942 "type": "string",
8943 "required": true
8944 }
8945 },
8946 "description": "Get the last year of commit activity data."
8947 },
8948 "getStatsCodeFrequency": {
8949 "url": "/repos/:owner/:repo/stats/code_frequency",
8950 "method": "GET",
8951 "params": {
8952 "owner": {
8953 "type": "string",
8954 "required": true
8955 },
8956 "repo": {
8957 "type": "string",
8958 "required": true
8959 }
8960 },
8961 "description": "Get the number of additions and deletions per week."
8962 },
8963 "getStatsParticipation": {
8964 "url": "/repos/:owner/:repo/stats/participation",
8965 "method": "GET",
8966 "params": {
8967 "owner": {
8968 "type": "string",
8969 "required": true
8970 },
8971 "repo": {
8972 "type": "string",
8973 "required": true
8974 }
8975 },
8976 "description": "Get the weekly commit count for the repository owner and everyone else."
8977 },
8978 "getStatsPunchCard": {
8979 "url": "/repos/:owner/:repo/stats/punch_card",
8980 "method": "GET",
8981 "params": {
8982 "owner": {
8983 "type": "string",
8984 "required": true
8985 },
8986 "repo": {
8987 "type": "string",
8988 "required": true
8989 }
8990 },
8991 "description": "Get the number of commits per hour in each day."
8992 },
8993 "createStatus": {
8994 "url": "/repos/:owner/:repo/statuses/:sha",
8995 "method": "POST",
8996 "params": {
8997 "owner": {
8998 "type": "string",
8999 "required": true
9000 },
9001 "repo": {
9002 "type": "string",
9003 "required": true
9004 },
9005 "sha": {
9006 "type": "string",
9007 "required": true
9008 },
9009 "state": {
9010 "type": "string",
9011 "required": true,
9012 "enum": [
9013 "pending",
9014 "success",
9015 "error",
9016 "failure"
9017 ],
9018 "description": "State of the status - can be one of pending, success, error, or failure."
9019 },
9020 "target_url": {
9021 "type": "string",
9022 "description": "Target url to associate with this status. This URL will be linked from the GitHub UI to allow users to easily see the ‘source’ of the Status."
9023 },
9024 "description": {
9025 "type": "string",
9026 "description": "Short description of the status."
9027 },
9028 "context": {
9029 "type": "string",
9030 "description": "A string label to differentiate this status from the status of other systems."
9031 }
9032 },
9033 "description": "Create a status."
9034 },
9035 "getStatuses": {
9036 "url": "/repos/:owner/:repo/commits/:ref/statuses",
9037 "method": "GET",
9038 "params": {
9039 "owner": {
9040 "type": "string",
9041 "required": true
9042 },
9043 "repo": {
9044 "type": "string",
9045 "required": true
9046 },
9047 "ref": {
9048 "type": "string",
9049 "required": true,
9050 "description": "Ref to list the statuses from. It can be a SHA, a branch name, or a tag name."
9051 },
9052 "page": {
9053 "type": "number",
9054 "description": "Page number of the results to fetch."
9055 },
9056 "per_page": {
9057 "type": "number",
9058 "default": "30",
9059 "description": "A custom page size up to 100. Default is 30."
9060 }
9061 },
9062 "description": "List statuses for a specfic ref."
9063 },
9064 "getCombinedStatusForRef": {
9065 "url": "/repos/:owner/:repo/commits/:ref/status",
9066 "method": "GET",
9067 "params": {
9068 "owner": {
9069 "type": "string",
9070 "required": true
9071 },
9072 "repo": {
9073 "type": "string",
9074 "required": true
9075 },
9076 "ref": {
9077 "type": "string",
9078 "required": true,
9079 "description": "Ref to fetch the status for. It can be a SHA, a branch name, or a tag name."
9080 },
9081 "page": {
9082 "type": "number",
9083 "description": "Page number of the results to fetch."
9084 },
9085 "per_page": {
9086 "type": "number",
9087 "default": "30",
9088 "description": "A custom page size up to 100. Default is 30."
9089 }
9090 },
9091 "description": "Get the combined status for a specific ref."
9092 },
9093 "getReferrers": {
9094 "url": "/repos/:owner/:repo/traffic/popular/referrers",
9095 "method": "GET",
9096 "params": {
9097 "owner": {
9098 "type": "string",
9099 "required": true
9100 },
9101 "repo": {
9102 "type": "string",
9103 "required": true
9104 },
9105 "page": {
9106 "type": "number",
9107 "description": "Page number of the results to fetch."
9108 },
9109 "per_page": {
9110 "type": "number",
9111 "default": "30",
9112 "description": "A custom page size up to 100. Default is 30."
9113 }
9114 },
9115 "description": "Get the top 10 referrers over the last 14 days."
9116 },
9117 "getPaths": {
9118 "url": "/repos/:owner/:repo/traffic/popular/paths",
9119 "method": "GET",
9120 "params": {
9121 "owner": {
9122 "type": "string",
9123 "required": true
9124 },
9125 "repo": {
9126 "type": "string",
9127 "required": true
9128 },
9129 "page": {
9130 "type": "number",
9131 "description": "Page number of the results to fetch."
9132 },
9133 "per_page": {
9134 "type": "number",
9135 "default": "30",
9136 "description": "A custom page size up to 100. Default is 30."
9137 }
9138 },
9139 "description": "Get the top 10 popular contents over the last 14 days."
9140 },
9141 "getViews": {
9142 "url": "/repos/:owner/:repo/traffic/views",
9143 "method": "GET",
9144 "params": {
9145 "owner": {
9146 "type": "string",
9147 "required": true
9148 },
9149 "repo": {
9150 "type": "string",
9151 "required": true
9152 },
9153 "page": {
9154 "type": "number",
9155 "description": "Page number of the results to fetch."
9156 },
9157 "per_page": {
9158 "type": "number",
9159 "default": "30",
9160 "description": "A custom page size up to 100. Default is 30."
9161 }
9162 },
9163 "description": "Get the total number of views and breakdown per day or week for the last 14 days."
9164 },
9165 "getClones": {
9166 "url": "/repos/:owner/:repo/traffic/clones",
9167 "method": "GET",
9168 "params": {
9169 "owner": {
9170 "type": "string",
9171 "required": true
9172 },
9173 "repo": {
9174 "type": "string",
9175 "required": true
9176 },
9177 "page": {
9178 "type": "number",
9179 "description": "Page number of the results to fetch."
9180 },
9181 "per_page": {
9182 "type": "number",
9183 "default": "30",
9184 "description": "A custom page size up to 100. Default is 30."
9185 }
9186 },
9187 "description": "Get the total number of clones and breakdown per day or week for the last 14 days."
9188 },
9189 "getHooks": {
9190 "url": "/repos/:owner/:repo/hooks",
9191 "method": "GET",
9192 "params": {
9193 "owner": {
9194 "type": "string",
9195 "required": true
9196 },
9197 "repo": {
9198 "type": "string",
9199 "required": true
9200 },
9201 "page": {
9202 "type": "number",
9203 "description": "Page number of the results to fetch."
9204 },
9205 "per_page": {
9206 "type": "number",
9207 "default": "30",
9208 "description": "A custom page size up to 100. Default is 30."
9209 }
9210 },
9211 "description": "List hooks."
9212 },
9213 "getHook": {
9214 "url": "/repos/:owner/:repo/hooks/:id",
9215 "method": "GET",
9216 "params": {
9217 "owner": {
9218 "type": "string",
9219 "required": true
9220 },
9221 "repo": {
9222 "type": "string",
9223 "required": true
9224 },
9225 "id": {
9226 "type": "string",
9227 "required": true
9228 }
9229 },
9230 "description": "Get single hook."
9231 },
9232 "createHook": {
9233 "url": "/repos/:owner/:repo/hooks",
9234 "method": "POST",
9235 "params": {
9236 "owner": {
9237 "type": "string",
9238 "required": true
9239 },
9240 "repo": {
9241 "type": "string",
9242 "required": true
9243 },
9244 "name": {
9245 "type": "string",
9246 "required": true
9247 },
9248 "config": {
9249 "type": "json",
9250 "required": true,
9251 "description": "A Hash containing key/value pairs to provide settings for this hook. These settings vary between the services and are defined in the github-services repo. Booleans are stored internally as `1` for true, and `0` for false. Any JSON true/false values will be converted automatically."
9252 },
9253 "events": {
9254 "type": "string[]",
9255 "default": "[\"push\"]",
9256 "description": "Determines what events the hook is triggered for. Default: `['push']`."
9257 },
9258 "active": {
9259 "type": "boolean",
9260 "description": "Determines whether the hook is actually triggered on pushes."
9261 }
9262 },
9263 "description": "Create a hook."
9264 },
9265 "editHook": {
9266 "url": "/repos/:owner/:repo/hooks/:id",
9267 "method": "PATCH",
9268 "params": {
9269 "owner": {
9270 "type": "string",
9271 "required": true
9272 },
9273 "repo": {
9274 "type": "string",
9275 "required": true
9276 },
9277 "id": {
9278 "type": "string",
9279 "required": true
9280 },
9281 "name": {
9282 "type": "string",
9283 "required": true
9284 },
9285 "config": {
9286 "type": "json",
9287 "required": true,
9288 "description": "A Hash containing key/value pairs to provide settings for this hook. Modifying this will replace the entire config object. These settings vary between the services and are defined in the github-services repo. Booleans are stored internally as `1` for true, and `0` for false. Any JSON true/false values will be converted automatically."
9289 },
9290 "events": {
9291 "type": "string[]",
9292 "default": "[\"push\"]",
9293 "description": "Determines what events the hook is triggered for. This replaces the entire array of events. Default: `['push']`."
9294 },
9295 "add_events": {
9296 "type": "string[]",
9297 "description": "Determines a list of events to be added to the list of events that the Hook triggers for."
9298 },
9299 "remove_events": {
9300 "type": "string[]",
9301 "description": "Determines a list of events to be removed from the list of events that the Hook triggers for."
9302 },
9303 "active": {
9304 "type": "boolean",
9305 "description": "Determines whether the hook is actually triggered on pushes."
9306 }
9307 },
9308 "description": "Edit a hook."
9309 },
9310 "testHook": {
9311 "url": "/repos/:owner/:repo/hooks/:id/tests",
9312 "method": "POST",
9313 "params": {
9314 "owner": {
9315 "type": "string",
9316 "required": true
9317 },
9318 "repo": {
9319 "type": "string",
9320 "required": true
9321 },
9322 "id": {
9323 "type": "string",
9324 "required": true
9325 }
9326 },
9327 "description": "Test a [push] hook."
9328 },
9329 "pingHook": {
9330 "url": "/repos/:owner/:repo/hooks/:id/pings",
9331 "method": "POST",
9332 "params": {
9333 "owner": {
9334 "type": "string",
9335 "required": true
9336 },
9337 "repo": {
9338 "type": "string",
9339 "required": true
9340 },
9341 "id": {
9342 "type": "string",
9343 "required": true
9344 }
9345 },
9346 "description": "Ping a hook."
9347 },
9348 "deleteHook": {
9349 "url": "/repos/:owner/:repo/hooks/:id",
9350 "method": "DELETE",
9351 "params": {
9352 "owner": {
9353 "type": "string",
9354 "required": true
9355 },
9356 "repo": {
9357 "type": "string",
9358 "required": true
9359 },
9360 "id": {
9361 "type": "string",
9362 "required": true
9363 }
9364 },
9365 "description": "Deleate a hook."
9366 }
9367 },
9368 "search": {
9369 "repos": {
9370 "url": "/search/repositories",
9371 "method": "GET",
9372 "headers": {
9373 "accept": "application/vnd.github.mercy-preview+json"
9374 },
9375 "params": {
9376 "q": {
9377 "type": "string",
9378 "required": true,
9379 "description": "Search Term"
9380 },
9381 "sort": {
9382 "type": "string",
9383 "enum": [
9384 "stars",
9385 "forks",
9386 "updated"
9387 ],
9388 "description": "stars, forks, or updated"
9389 },
9390 "order": {
9391 "type": "string",
9392 "enum": [
9393 "asc",
9394 "desc"
9395 ],
9396 "default": "desc",
9397 "description": "asc or desc"
9398 },
9399 "page": {
9400 "type": "number",
9401 "description": "Page number of the results to fetch."
9402 },
9403 "per_page": {
9404 "type": "number",
9405 "default": "30",
9406 "description": "A custom page size up to 100. Default is 30."
9407 }
9408 },
9409 "description": "Search repositories."
9410 },
9411 "code": {
9412 "url": "/search/code",
9413 "method": "GET",
9414 "params": {
9415 "q": {
9416 "type": "string",
9417 "required": true,
9418 "description": "Search Term"
9419 },
9420 "sort": {
9421 "type": "string",
9422 "enum": [
9423 "indexed"
9424 ],
9425 "description": "The sort field. Can only be indexed, which indicates how recently a file has been indexed by the GitHub search infrastructure. Default: results are sorted by best match."
9426 },
9427 "order": {
9428 "type": "string",
9429 "enum": [
9430 "asc",
9431 "desc"
9432 ],
9433 "default": "desc",
9434 "description": "asc or desc"
9435 },
9436 "page": {
9437 "type": "number",
9438 "description": "Page number of the results to fetch."
9439 },
9440 "per_page": {
9441 "type": "number",
9442 "default": "30",
9443 "description": "A custom page size up to 100. Default is 30."
9444 }
9445 },
9446 "description": "Search code."
9447 },
9448 "commits": {
9449 "url": "/search/commits",
9450 "method": "GET",
9451 "headers": {
9452 "accept": "application/vnd.github.cloak-preview+json"
9453 },
9454 "params": {
9455 "q": {
9456 "type": "string",
9457 "required": true,
9458 "description": "Search Term"
9459 },
9460 "sort": {
9461 "type": "string",
9462 "enum": [
9463 "author-date",
9464 "committer-date"
9465 ],
9466 "description": "The sort field. Can be author-date or committer-date. Default: best match."
9467 },
9468 "order": {
9469 "type": "string",
9470 "enum": [
9471 "asc",
9472 "desc"
9473 ],
9474 "default": "desc",
9475 "description": "asc or desc"
9476 },
9477 "page": {
9478 "type": "number",
9479 "description": "Page number of the results to fetch."
9480 },
9481 "per_page": {
9482 "type": "number",
9483 "default": "30",
9484 "description": "A custom page size up to 100. Default is 30."
9485 }
9486 },
9487 "description": "Search commits. (In preview period. See README.)"
9488 },
9489 "issues": {
9490 "url": "/search/issues",
9491 "method": "GET",
9492 "params": {
9493 "q": {
9494 "type": "string",
9495 "required": true,
9496 "description": "Search Term"
9497 },
9498 "sort": {
9499 "type": "string",
9500 "enum": [
9501 "comments",
9502 "created",
9503 "updated"
9504 ],
9505 "description": "The sort field. Can be comments, created, or updated. Default: results are sorted by best match."
9506 },
9507 "order": {
9508 "type": "string",
9509 "enum": [
9510 "asc",
9511 "desc"
9512 ],
9513 "default": "desc",
9514 "description": "asc or desc"
9515 },
9516 "page": {
9517 "type": "number",
9518 "description": "Page number of the results to fetch."
9519 },
9520 "per_page": {
9521 "type": "number",
9522 "default": "30",
9523 "description": "A custom page size up to 100. Default is 30."
9524 }
9525 },
9526 "description": "Search issues."
9527 },
9528 "users": {
9529 "url": "/search/users",
9530 "method": "GET",
9531 "params": {
9532 "q": {
9533 "type": "string",
9534 "required": true,
9535 "description": "Search Term"
9536 },
9537 "sort": {
9538 "type": "string",
9539 "enum": [
9540 "followers",
9541 "repositories",
9542 "joined"
9543 ],
9544 "description": "The sort field. Can be followers, repositories, or joined. Default: results are sorted by best match."
9545 },
9546 "order": {
9547 "type": "string",
9548 "enum": [
9549 "asc",
9550 "desc"
9551 ],
9552 "default": "desc",
9553 "description": "asc or desc"
9554 },
9555 "page": {
9556 "type": "number",
9557 "description": "Page number of the results to fetch."
9558 },
9559 "per_page": {
9560 "type": "number",
9561 "default": "30",
9562 "description": "A custom page size up to 100. Default is 30."
9563 }
9564 },
9565 "description": "Search users."
9566 },
9567 "email": {
9568 "url": "/legacy/user/email/:email",
9569 "method": "GET",
9570 "params": {
9571 "email": {
9572 "type": "string",
9573 "required": true,
9574 "description": "The email address"
9575 }
9576 },
9577 "description": "Search against public email addresses."
9578 }
9579 },
9580 "users": {
9581 "get": {
9582 "url": "/user",
9583 "method": "GET",
9584 "params": {},
9585 "description": "Get the authenticated user"
9586 },
9587 "update": {
9588 "url": "/user",
9589 "method": "PATCH",
9590 "params": {
9591 "name": {
9592 "type": "string",
9593 "description": "The new name of the user"
9594 },
9595 "email": {
9596 "type": "string",
9597 "description": "Publicly visible email address."
9598 },
9599 "blog": {
9600 "type": "string",
9601 "description": "The new blog URL of the user."
9602 },
9603 "company": {
9604 "type": "string",
9605 "description": "The new company of the user."
9606 },
9607 "location": {
9608 "type": "string",
9609 "description": "The new location of the user."
9610 },
9611 "hireable": {
9612 "type": "boolean",
9613 "description": "The new hiring availability of the user."
9614 },
9615 "bio": {
9616 "type": "string",
9617 "description": "The new short biography of the user."
9618 }
9619 },
9620 "description": "Update the authenticated user"
9621 },
9622 "promote": {
9623 "url": "/users/:username/site_admin",
9624 "method": "PUT",
9625 "params": {
9626 "username": {
9627 "type": "string",
9628 "required": true
9629 }
9630 },
9631 "description": "Promote an ordinary user to a site administrator"
9632 },
9633 "demote": {
9634 "url": "/users/:username/site_admin",
9635 "method": "DELETE",
9636 "params": {
9637 "username": {
9638 "type": "string",
9639 "required": true
9640 }
9641 },
9642 "description": "Demote a site administrator to an ordinary user"
9643 },
9644 "suspend": {
9645 "url": "/users/:username/suspended",
9646 "method": "PUT",
9647 "params": {
9648 "username": {
9649 "type": "string",
9650 "required": true
9651 }
9652 },
9653 "description": "Suspend a user"
9654 },
9655 "unsuspend": {
9656 "url": "/users/:username/suspended",
9657 "method": "DELETE",
9658 "params": {
9659 "username": {
9660 "type": "string",
9661 "required": true
9662 }
9663 },
9664 "description": "Unsuspend a user"
9665 },
9666 "getForUser": {
9667 "url": "/users/:username",
9668 "method": "GET",
9669 "params": {
9670 "username": {
9671 "type": "string",
9672 "required": true
9673 }
9674 },
9675 "description": "Get a single user"
9676 },
9677 "getById": {
9678 "url": "/user/:id",
9679 "method": "GET",
9680 "params": {
9681 "id": {
9682 "type": "string",
9683 "required": true
9684 }
9685 },
9686 "description": "Get a single user by GitHub ID"
9687 },
9688 "getAll": {
9689 "url": "/users",
9690 "method": "GET",
9691 "params": {
9692 "since": {
9693 "type": "number",
9694 "description": "The integer ID of the last User that you’ve seen."
9695 }
9696 },
9697 "description": "Get all users"
9698 },
9699 "getOrgs": {
9700 "url": "/user/orgs",
9701 "method": "GET",
9702 "params": {
9703 "page": {
9704 "type": "number",
9705 "description": "Page number of the results to fetch."
9706 },
9707 "per_page": {
9708 "type": "number",
9709 "default": "30",
9710 "description": "A custom page size up to 100. Default is 30."
9711 }
9712 },
9713 "description": "List organizations for the authenticated user."
9714 },
9715 "getOrgMemberships": {
9716 "url": "/user/memberships/orgs",
9717 "method": "GET",
9718 "params": {
9719 "state": {
9720 "type": "string",
9721 "enum": [
9722 "active",
9723 "pending"
9724 ],
9725 "description": "Indicates the state of the memberships to return. Can be either active or pending. If not specified, both active and pending memberships are returned."
9726 }
9727 },
9728 "description": "List your organization memberships"
9729 },
9730 "getOrgMembership": {
9731 "url": "/user/memberships/orgs/:org",
9732 "method": "GET",
9733 "params": {
9734 "org": {
9735 "type": "string",
9736 "required": true
9737 }
9738 },
9739 "description": "Get your organization membership"
9740 },
9741 "editOrgMembership": {
9742 "url": "/user/memberships/orgs/:org",
9743 "method": "PATCH",
9744 "params": {
9745 "org": {
9746 "type": "string",
9747 "required": true
9748 },
9749 "state": {
9750 "type": "string",
9751 "required": true,
9752 "enum": [
9753 "active"
9754 ],
9755 "description": "The state that the membership should be in. Only \"active\" will be accepted."
9756 }
9757 },
9758 "description": "Edit your organization membership."
9759 },
9760 "getTeams": {
9761 "url": "/user/teams",
9762 "method": "GET",
9763 "headers": {
9764 "accept": "application/vnd.github.hellcat-preview+json"
9765 },
9766 "params": {
9767 "page": {
9768 "type": "number",
9769 "description": "Page number of the results to fetch."
9770 },
9771 "per_page": {
9772 "type": "number",
9773 "default": "30",
9774 "description": "A custom page size up to 100. Default is 30."
9775 }
9776 },
9777 "description": "Get your teams."
9778 },
9779 "getEmails": {
9780 "url": "/user/emails",
9781 "method": "GET",
9782 "params": {
9783 "page": {
9784 "type": "number",
9785 "description": "Page number of the results to fetch."
9786 },
9787 "per_page": {
9788 "type": "number",
9789 "default": "30",
9790 "description": "A custom page size up to 100. Default is 30."
9791 }
9792 },
9793 "description": "List email addresses for a user."
9794 },
9795 "getPublicEmails": {
9796 "url": "/user/public_emails",
9797 "method": "GET",
9798 "params": {
9799 "page": {
9800 "type": "number",
9801 "description": "Page number of the results to fetch."
9802 },
9803 "per_page": {
9804 "type": "number",
9805 "default": "30",
9806 "description": "A custom page size up to 100. Default is 30."
9807 }
9808 },
9809 "description": "List public email addresses for a user."
9810 },
9811 "addEmails": {
9812 "url": "/user/emails",
9813 "method": "POST",
9814 "params": {
9815 "emails": {
9816 "type": "string[]",
9817 "required": true,
9818 "mapTo": "input",
9819 "description": "You can post a single email address or an array of addresses."
9820 }
9821 },
9822 "description": "Add email address(es)."
9823 },
9824 "deleteEmails": {
9825 "url": "/user/emails",
9826 "method": "DELETE",
9827 "params": {
9828 "emails": {
9829 "type": "string[]",
9830 "required": true,
9831 "mapTo": "input",
9832 "description": "You can post a single email address or an array of addresses."
9833 }
9834 },
9835 "description": "Delete email address(es)."
9836 },
9837 "togglePrimaryEmailVisibility": {
9838 "url": "/user/email/visibility",
9839 "method": "PATCH",
9840 "params": {},
9841 "description": "Toggle primary email visibility."
9842 },
9843 "getFollowersForUser": {
9844 "url": "/users/:username/followers",
9845 "method": "GET",
9846 "params": {
9847 "username": {
9848 "type": "string",
9849 "required": true
9850 },
9851 "page": {
9852 "type": "number",
9853 "description": "Page number of the results to fetch."
9854 },
9855 "per_page": {
9856 "type": "number",
9857 "default": "30",
9858 "description": "A custom page size up to 100. Default is 30."
9859 }
9860 },
9861 "description": "List a user's followers"
9862 },
9863 "getFollowers": {
9864 "url": "/user/followers",
9865 "method": "GET",
9866 "params": {
9867 "page": {
9868 "type": "number",
9869 "description": "Page number of the results to fetch."
9870 },
9871 "per_page": {
9872 "type": "number",
9873 "default": "30",
9874 "description": "A custom page size up to 100. Default is 30."
9875 }
9876 },
9877 "description": "List the authenticated user's followers"
9878 },
9879 "getFollowingForUser": {
9880 "url": "/users/:username/following",
9881 "method": "GET",
9882 "params": {
9883 "username": {
9884 "type": "string",
9885 "required": true
9886 },
9887 "page": {
9888 "type": "number",
9889 "description": "Page number of the results to fetch."
9890 },
9891 "per_page": {
9892 "type": "number",
9893 "default": "30",
9894 "description": "A custom page size up to 100. Default is 30."
9895 }
9896 },
9897 "description": "List who a user is following"
9898 },
9899 "getFollowing": {
9900 "url": "/user/following",
9901 "method": "GET",
9902 "params": {
9903 "page": {
9904 "type": "number",
9905 "description": "Page number of the results to fetch."
9906 },
9907 "per_page": {
9908 "type": "number",
9909 "default": "30",
9910 "description": "A custom page size up to 100. Default is 30."
9911 }
9912 },
9913 "description": "List who the authenticated user is following"
9914 },
9915 "checkFollowing": {
9916 "url": "/user/following/:username",
9917 "method": "GET",
9918 "params": {
9919 "username": {
9920 "type": "string",
9921 "required": true
9922 }
9923 },
9924 "description": "Check if you are following a user"
9925 },
9926 "checkIfOneFollowersOther": {
9927 "url": "/users/:username/following/:target_user",
9928 "method": "GET",
9929 "params": {
9930 "username": {
9931 "type": "string",
9932 "required": true
9933 },
9934 "target_user": {
9935 "type": "string",
9936 "required": true
9937 }
9938 },
9939 "description": "Check if one user follows another"
9940 },
9941 "followUser": {
9942 "url": "/user/following/:username",
9943 "method": "PUT",
9944 "params": {
9945 "username": {
9946 "type": "string",
9947 "required": true
9948 }
9949 },
9950 "description": "Follow a user"
9951 },
9952 "unfollowUser": {
9953 "url": "/user/following/:username",
9954 "method": "DELETE",
9955 "params": {
9956 "username": {
9957 "type": "string",
9958 "required": true
9959 }
9960 },
9961 "description": "Unfollow a user"
9962 },
9963 "getKeysForUser": {
9964 "url": "/users/:username/keys",
9965 "method": "GET",
9966 "params": {
9967 "username": {
9968 "type": "string",
9969 "required": true
9970 },
9971 "page": {
9972 "type": "number",
9973 "description": "Page number of the results to fetch."
9974 },
9975 "per_page": {
9976 "type": "number",
9977 "default": "30",
9978 "description": "A custom page size up to 100. Default is 30."
9979 }
9980 },
9981 "description": "List public keys for a user"
9982 },
9983 "getKeys": {
9984 "url": "/user/keys",
9985 "method": "GET",
9986 "params": {
9987 "page": {
9988 "type": "number",
9989 "description": "Page number of the results to fetch."
9990 },
9991 "per_page": {
9992 "type": "number",
9993 "default": "30",
9994 "description": "A custom page size up to 100. Default is 30."
9995 }
9996 },
9997 "description": "List your public keys"
9998 },
9999 "getKey": {
10000 "url": "/user/keys/:id",
10001 "method": "GET",
10002 "params": {
10003 "id": {
10004 "type": "string",
10005 "required": true
10006 }
10007 },
10008 "description": "Get a single public key"
10009 },
10010 "createKey": {
10011 "url": "/user/keys",
10012 "method": "POST",
10013 "params": {
10014 "title": {
10015 "type": "string",
10016 "required": true
10017 },
10018 "key": {
10019 "type": "string",
10020 "required": true
10021 }
10022 },
10023 "description": "Create a public key"
10024 },
10025 "deleteKey": {
10026 "url": "/user/keys/:id",
10027 "method": "DELETE",
10028 "params": {
10029 "id": {
10030 "type": "string",
10031 "required": true
10032 }
10033 },
10034 "description": "Delete a public key"
10035 },
10036 "getGpgKeysForUser": {
10037 "url": "/users/:username/gpg_keys",
10038 "method": "GET",
10039 "headers": {
10040 "accept": "application/vnd.github.cryptographer-preview"
10041 },
10042 "params": {
10043 "username": {
10044 "type": "string",
10045 "required": true
10046 },
10047 "page": {
10048 "type": "number",
10049 "description": "Page number of the results to fetch."
10050 },
10051 "per_page": {
10052 "type": "number",
10053 "default": "30",
10054 "description": "A custom page size up to 100. Default is 30."
10055 }
10056 },
10057 "description": "Lists the GPG keys for a user. This information is accessible by anyone. (In preview period. See README.)"
10058 },
10059 "getGpgKeys": {
10060 "url": "/user/gpg_keys",
10061 "method": "GET",
10062 "headers": {
10063 "accept": "application/vnd.github.cryptographer-preview"
10064 },
10065 "params": {
10066 "page": {
10067 "type": "number",
10068 "description": "Page number of the results to fetch."
10069 },
10070 "per_page": {
10071 "type": "number",
10072 "default": "30",
10073 "description": "A custom page size up to 100. Default is 30."
10074 }
10075 },
10076 "description": "List your GPG keys. (In preview period. See README.)"
10077 },
10078 "getGpgKey": {
10079 "url": "/user/gpg_keys/:id",
10080 "method": "GET",
10081 "headers": {
10082 "accept": "application/vnd.github.cryptographer-preview"
10083 },
10084 "params": {
10085 "id": {
10086 "type": "string",
10087 "required": true
10088 }
10089 },
10090 "description": "Get a single GPG key. (In preview period. See README.)"
10091 },
10092 "createGpgKey": {
10093 "url": "/user/gpg_keys",
10094 "method": "POST",
10095 "headers": {
10096 "accept": "application/vnd.github.cryptographer-preview"
10097 },
10098 "params": {
10099 "armored_public_key": {
10100 "type": "string",
10101 "required": true,
10102 "description": "GPG key contents"
10103 }
10104 },
10105 "description": "Create a GPG key. (In preview period. See README.)"
10106 },
10107 "deleteGpgKey": {
10108 "url": "/user/gpg_keys/:id",
10109 "method": "DELETE",
10110 "headers": {
10111 "accept": "application/vnd.github.cryptographer-preview"
10112 },
10113 "params": {
10114 "id": {
10115 "type": "string",
10116 "required": true
10117 }
10118 },
10119 "description": "Delete a GPG key. (In preview period. See README.)"
10120 },
10121 "getBlockedUsers": {
10122 "url": "/user/blocks",
10123 "method": "GET",
10124 "headers": {
10125 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
10126 },
10127 "params": {},
10128 "description": "List blocked users. (In preview period. See README.)"
10129 },
10130 "checkBlockedUser": {
10131 "url": "/user/blocks/:username",
10132 "method": "GET",
10133 "headers": {
10134 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
10135 },
10136 "params": {
10137 "username": {
10138 "type": "string",
10139 "required": true
10140 }
10141 },
10142 "description": "Check whether you've blocked a user. (In preview period. See README.)"
10143 },
10144 "blockUser": {
10145 "url": "/user/blocks/:username",
10146 "method": "PUT",
10147 "headers": {
10148 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
10149 },
10150 "params": {
10151 "username": {
10152 "type": "string",
10153 "required": true
10154 }
10155 },
10156 "description": "Block a user. (In preview period. See README.)"
10157 },
10158 "unblockUser": {
10159 "url": "/user/blocks/:username",
10160 "method": "DELETE",
10161 "headers": {
10162 "accept": "application/vnd.github.giant-sentry-fist-preview+json"
10163 },
10164 "params": {
10165 "username": {
10166 "type": "string",
10167 "required": true
10168 }
10169 },
10170 "description": "Unblock a user. (In preview period. See README.)"
10171 },
10172 "getRepoInvites": {
10173 "url": "/user/repository_invitations",
10174 "method": "GET",
10175 "params": {},
10176 "description": "List a user's repository invitations."
10177 },
10178 "acceptRepoInvite": {
10179 "url": "/user/repository_invitations/:invitation_id",
10180 "method": "PATCH",
10181 "params": {
10182 "invitation_id": {
10183 "type": "string",
10184 "required": true
10185 }
10186 },
10187 "description": "Accept a repository invitation."
10188 },
10189 "declineRepoInvite": {
10190 "url": "/user/repository_invitations/:invitation_id",
10191 "method": "DELETE",
10192 "params": {
10193 "invitation_id": {
10194 "type": "string",
10195 "required": true
10196 }
10197 },
10198 "description": "Decline a repository invitation."
10199 },
10200 "getInstallations": {
10201 "url": "/user/installations",
10202 "method": "GET",
10203 "headers": {
10204 "accept": "application/vnd.github.machine-man-preview"
10205 },
10206 "params": {
10207 "page": {
10208 "type": "number",
10209 "description": "Page number of the results to fetch."
10210 },
10211 "per_page": {
10212 "type": "number",
10213 "default": "30",
10214 "description": "A custom page size up to 100. Default is 30."
10215 }
10216 },
10217 "description": "List installations. (In preview period. See README.)"
10218 },
10219 "getInstallationRepos": {
10220 "url": "/user/installations/:installation_id/repositories",
10221 "method": "GET",
10222 "params": {
10223 "installation_id": {
10224 "type": "string",
10225 "required": true
10226 },
10227 "page": {
10228 "type": "number",
10229 "description": "Page number of the results to fetch."
10230 },
10231 "per_page": {
10232 "type": "number",
10233 "default": "30",
10234 "description": "A custom page size up to 100. Default is 30."
10235 }
10236 },
10237 "description": "List repositories accessible to the user for an installation. (In preview period. See README.)"
10238 },
10239 "addRepoToInstallation": {
10240 "url": "/user/installations/:installation_id/repositories/:repository_id",
10241 "method": "PUT",
10242 "headers": {
10243 "accept": "application/vnd.github.machine-man-preview"
10244 },
10245 "params": {
10246 "installation_id": {
10247 "type": "string",
10248 "required": true
10249 },
10250 "repository_id": {
10251 "type": "string",
10252 "required": true
10253 }
10254 },
10255 "description": "Add a single repository to an installation. (In preview period. See README.)"
10256 },
10257 "removeRepoFromInstallation": {
10258 "url": "/user/installations/:installation_id/repositories/:repository_id",
10259 "method": "DELETE",
10260 "headers": {
10261 "accept": "application/vnd.github.machine-man-preview"
10262 },
10263 "params": {
10264 "installation_id": {
10265 "type": "string",
10266 "required": true
10267 },
10268 "repository_id": {
10269 "type": "string",
10270 "required": true
10271 }
10272 },
10273 "description": "Remove a single repository from an installation. (In preview period. See README.)"
10274 },
10275 "getMarketplacePurchases": {
10276 "url": "/user/marketplace_purchases",
10277 "method": "GET",
10278 "headers": {
10279 "accept": "application/vnd.github.valkyrie-preview+json"
10280 },
10281 "params": {
10282 "page": {
10283 "type": "number",
10284 "description": "Page number of the results to fetch."
10285 },
10286 "per_page": {
10287 "type": "number",
10288 "default": "30",
10289 "description": "A custom page size up to 100. Default is 30."
10290 }
10291 },
10292 "description": "Get a user's Marketplace purchases. (In preview period. See README.)"
10293 },
10294 "getMarketplaceStubbedPurchases": {
10295 "url": "/user/marketplace_purchases/stubbed",
10296 "method": "GET",
10297 "headers": {
10298 "accept": "application/vnd.github.valkyrie-preview+json"
10299 },
10300 "params": {
10301 "page": {
10302 "type": "number",
10303 "description": "Page number of the results to fetch."
10304 },
10305 "per_page": {
10306 "type": "number",
10307 "default": "30",
10308 "description": "A custom page size up to 100. Default is 30."
10309 }
10310 },
10311 "description": "Get a user's stubbed Marketplace purchases. (In preview period. See README.)"
10312 }
10313 },
10314 "enterprise": {
10315 "stats": {
10316 "url": "/enterprise/stats/:type",
10317 "method": "GET",
10318 "params": {
10319 "type": {
10320 "type": "string",
10321 "required": true,
10322 "enum": [
10323 "issues",
10324 "hooks",
10325 "milestones",
10326 "orgs",
10327 "comments",
10328 "pages",
10329 "users",
10330 "gists",
10331 "pulls",
10332 "repos",
10333 "all"
10334 ],
10335 "description": "Possible values: issues, hooks, milestones, orgs, comments, pages, users, gists, pulls, repos, all."
10336 }
10337 },
10338 "description": "Get statistics."
10339 },
10340 "updateLdapForUser": {
10341 "url": "/admin/ldap/users/:username/mapping",
10342 "method": "PATCH",
10343 "params": {
10344 "username": {
10345 "type": "string",
10346 "required": true
10347 },
10348 "ldap_dn": {
10349 "type": "string",
10350 "required": true,
10351 "description": "LDAP DN for user"
10352 }
10353 },
10354 "description": "Update LDAP mapping for a user."
10355 },
10356 "syncLdapForUser": {
10357 "url": "/admin/ldap/users/:username/sync",
10358 "method": "POST",
10359 "params": {
10360 "username": {
10361 "type": "string",
10362 "required": true
10363 }
10364 },
10365 "description": "Sync LDAP mapping for a user."
10366 },
10367 "updateLdapForTeam": {
10368 "url": "/admin/ldap/teams/:team_id/mapping",
10369 "method": "PATCH",
10370 "params": {
10371 "team_id": {
10372 "type": "number",
10373 "required": true
10374 },
10375 "ldap_dn": {
10376 "type": "string",
10377 "required": true,
10378 "description": "LDAP DN for user"
10379 }
10380 },
10381 "description": "Update LDAP mapping for a team."
10382 },
10383 "syncLdapForTeam": {
10384 "url": "/admin/ldap/teams/:team_id/sync",
10385 "method": "POST",
10386 "params": {
10387 "team_id": {
10388 "type": "number",
10389 "required": true
10390 }
10391 },
10392 "description": "Sync LDAP mapping for a team."
10393 },
10394 "getLicense": {
10395 "url": "/enterprise/settings/license",
10396 "method": "GET",
10397 "params": {},
10398 "description": "Get license information"
10399 },
10400 "getPreReceiveEnvironment": {
10401 "url": "/admin/pre-receive-environments/:id",
10402 "method": "GET",
10403 "headers": {
10404 "accept": "application/vnd.github.eye-scream-preview"
10405 },
10406 "params": {
10407 "id": {
10408 "type": "string",
10409 "required": true
10410 }
10411 },
10412 "description": "Get a single pre-receive environment. (In preview period. See README.)"
10413 },
10414 "getPreReceiveEnvironments": {
10415 "url": "/admin/pre_receive_environments",
10416 "method": "GET",
10417 "headers": {
10418 "accept": "application/vnd.github.eye-scream-preview"
10419 },
10420 "params": {},
10421 "description": "List pre-receive environments. (In preview period. See README.)"
10422 },
10423 "createPreReceiveEnvironment": {
10424 "url": "/admin/pre_receive_environments",
10425 "method": "POST",
10426 "headers": {
10427 "accept": "application/vnd.github.eye-scream-preview"
10428 },
10429 "params": {
10430 "name": {
10431 "type": "string",
10432 "required": true,
10433 "description": "The new pre-receive environment's name."
10434 },
10435 "image_url": {
10436 "type": "string",
10437 "required": true,
10438 "description": "URL from which to download a tarball of this environment."
10439 }
10440 },
10441 "description": "Create a pre-receive environment. (In preview period. See README.)"
10442 },
10443 "editPreReceiveEnvironment": {
10444 "url": "/admin/pre_receive_environments/:id",
10445 "method": "PATCH",
10446 "params": {
10447 "id": {
10448 "type": "string",
10449 "required": true
10450 },
10451 "name": {
10452 "type": "string",
10453 "required": true,
10454 "description": "This pre-receive environment's new name."
10455 },
10456 "image_url": {
10457 "type": "string",
10458 "required": true,
10459 "description": "URL from which to download a tarball of this environment."
10460 }
10461 },
10462 "description": "Create a pre-receive environment. (In preview period. See README.)"
10463 },
10464 "deletePreReceiveEnvironment": {
10465 "url": "/admin/pre_receive_environments/:id",
10466 "method": "DELETE",
10467 "params": {
10468 "id": {
10469 "type": "string",
10470 "required": true
10471 }
10472 },
10473 "description": "Delete a pre-receive environment. (In preview period. See README.)"
10474 },
10475 "getPreReceiveEnvironmentDownloadStatus": {
10476 "url": "/admin/pre-receive-environments/:id/downloads/latest",
10477 "method": "GET",
10478 "headers": {
10479 "accept": "application/vnd.github.eye-scream-preview"
10480 },
10481 "params": {
10482 "id": {
10483 "type": "string",
10484 "required": true
10485 }
10486 },
10487 "description": "Get a pre-receive environment's download status. (In preview period. See README.)"
10488 },
10489 "triggerPreReceiveEnvironmentDownload": {
10490 "url": "/admin/pre_receive_environments/:id/downloads",
10491 "method": "POST",
10492 "headers": {
10493 "accept": "application/vnd.github.eye-scream-preview"
10494 },
10495 "params": {
10496 "id": {
10497 "type": "string",
10498 "required": true
10499 }
10500 },
10501 "description": "Trigger a pre-receive environment download. (In preview period. See README.)"
10502 },
10503 "getPreReceiveHook": {
10504 "url": "/admin/pre-receive-hooks/:id",
10505 "method": "GET",
10506 "headers": {
10507 "accept": "application/vnd.github.eye-scream-preview"
10508 },
10509 "params": {
10510 "id": {
10511 "type": "string",
10512 "required": true
10513 }
10514 },
10515 "description": "Get a single pre-receive hook. (In preview period. See README.)"
10516 },
10517 "getPreReceiveHooks": {
10518 "url": "/admin/pre-receive-hooks",
10519 "method": "GET",
10520 "headers": {
10521 "accept": "application/vnd.github.eye-scream-preview"
10522 },
10523 "params": {},
10524 "description": "List pre-receive hooks. (In preview period. See README.)"
10525 },
10526 "createPreReceiveHook": {
10527 "url": "/admin/pre-receive-hooks",
10528 "method": "POST",
10529 "headers": {
10530 "accept": "application/vnd.github.eye-scream-preview"
10531 },
10532 "params": {
10533 "name": {
10534 "type": "string",
10535 "required": true,
10536 "description": "The name of the hook."
10537 },
10538 "script": {
10539 "type": "string",
10540 "required": true,
10541 "description": "The script that the hook runs."
10542 },
10543 "script_repository": {
10544 "type": "json",
10545 "required": true,
10546 "description": "The GitHub repository where the script is kept."
10547 },
10548 "environment": {
10549 "type": "json",
10550 "required": true,
10551 "description": "The pre-receive environment where the script is executed."
10552 },
10553 "enforcement": {
10554 "type": "string",
10555 "default": "disabled",
10556 "description": "The state of enforcement for this hook. default: disabled"
10557 },
10558 "allow_downstream_configuration": {
10559 "type": "boolean",
10560 "default": "false",
10561 "description": "Whether enforcement can be overridden at the org or repo level. default: false"
10562 }
10563 },
10564 "description": "Create a pre-receive hook. (In preview period. See README.)"
10565 },
10566 "editPreReceiveHook": {
10567 "url": "/admin/pre_receive_hooks/:id",
10568 "method": "PATCH",
10569 "params": {
10570 "id": {
10571 "type": "string",
10572 "required": true
10573 },
10574 "hook": {
10575 "type": "json",
10576 "required": true,
10577 "mapTo": "input",
10578 "description": "JSON object that contains pre-receive hook info."
10579 }
10580 },
10581 "description": "Edit a pre-receive hook. (In preview period. See README.)"
10582 },
10583 "deletePreReceiveHook": {
10584 "url": "/admin/pre_receive_hooks/:id",
10585 "method": "DELETE",
10586 "params": {
10587 "id": {
10588 "type": "string",
10589 "required": true
10590 }
10591 },
10592 "description": "Delete a pre-receive hook. (In preview period. See README.)"
10593 },
10594 "queueIndexingJob": {
10595 "url": "/staff/indexing_jobs",
10596 "method": "POST",
10597 "params": {
10598 "target": {
10599 "type": "string",
10600 "required": true,
10601 "description": "A string representing the item to index."
10602 }
10603 },
10604 "description": "Queue an indexing job"
10605 },
10606 "createOrg": {
10607 "url": "/admin/organizations",
10608 "method": "POST",
10609 "params": {
10610 "login": {
10611 "type": "string",
10612 "required": true,
10613 "description": "The organization's username."
10614 },
10615 "admin": {
10616 "type": "string",
10617 "required": true,
10618 "description": "The login of the user who will manage this organization."
10619 },
10620 "profile_name": {
10621 "type": "string",
10622 "description": "The organization's display name."
10623 }
10624 },
10625 "description": "Create an organization"
10626 }
10627 }
10628}