You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

v1_json.tmpl 199KB

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