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 200KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314
  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. "type": "integer",
  2688. "description": "the key_id to search for",
  2689. "name": "key_id",
  2690. "in": "query"
  2691. },
  2692. {
  2693. "type": "string",
  2694. "description": "fingerprint of the key",
  2695. "name": "fingerprint",
  2696. "in": "query"
  2697. }
  2698. ],
  2699. "responses": {
  2700. "200": {
  2701. "$ref": "#/responses/DeployKeyList"
  2702. }
  2703. }
  2704. },
  2705. "post": {
  2706. "consumes": [
  2707. "application/json"
  2708. ],
  2709. "produces": [
  2710. "application/json"
  2711. ],
  2712. "tags": [
  2713. "repository"
  2714. ],
  2715. "summary": "Add a key to a repository",
  2716. "operationId": "repoCreateKey",
  2717. "parameters": [
  2718. {
  2719. "type": "string",
  2720. "description": "owner of the repo",
  2721. "name": "owner",
  2722. "in": "path",
  2723. "required": true
  2724. },
  2725. {
  2726. "type": "string",
  2727. "description": "name of the repo",
  2728. "name": "repo",
  2729. "in": "path",
  2730. "required": true
  2731. },
  2732. {
  2733. "name": "body",
  2734. "in": "body",
  2735. "schema": {
  2736. "$ref": "#/definitions/CreateKeyOption"
  2737. }
  2738. }
  2739. ],
  2740. "responses": {
  2741. "201": {
  2742. "$ref": "#/responses/DeployKey"
  2743. }
  2744. }
  2745. }
  2746. },
  2747. "/repos/{owner}/{repo}/keys/{id}": {
  2748. "get": {
  2749. "produces": [
  2750. "application/json"
  2751. ],
  2752. "tags": [
  2753. "repository"
  2754. ],
  2755. "summary": "Get a repository's key by id",
  2756. "operationId": "repoGetKey",
  2757. "parameters": [
  2758. {
  2759. "type": "string",
  2760. "description": "owner of the repo",
  2761. "name": "owner",
  2762. "in": "path",
  2763. "required": true
  2764. },
  2765. {
  2766. "type": "string",
  2767. "description": "name of the repo",
  2768. "name": "repo",
  2769. "in": "path",
  2770. "required": true
  2771. },
  2772. {
  2773. "type": "integer",
  2774. "format": "int64",
  2775. "description": "id of the key to get",
  2776. "name": "id",
  2777. "in": "path",
  2778. "required": true
  2779. }
  2780. ],
  2781. "responses": {
  2782. "200": {
  2783. "$ref": "#/responses/DeployKey"
  2784. }
  2785. }
  2786. },
  2787. "delete": {
  2788. "tags": [
  2789. "repository"
  2790. ],
  2791. "summary": "Delete a key from a repository",
  2792. "operationId": "repoDeleteKey",
  2793. "parameters": [
  2794. {
  2795. "type": "string",
  2796. "description": "owner of the repo",
  2797. "name": "owner",
  2798. "in": "path",
  2799. "required": true
  2800. },
  2801. {
  2802. "type": "string",
  2803. "description": "name of the repo",
  2804. "name": "repo",
  2805. "in": "path",
  2806. "required": true
  2807. },
  2808. {
  2809. "type": "integer",
  2810. "format": "int64",
  2811. "description": "id of the key to delete",
  2812. "name": "id",
  2813. "in": "path",
  2814. "required": true
  2815. }
  2816. ],
  2817. "responses": {
  2818. "204": {
  2819. "$ref": "#/responses/empty"
  2820. }
  2821. }
  2822. }
  2823. },
  2824. "/repos/{owner}/{repo}/labels": {
  2825. "get": {
  2826. "produces": [
  2827. "application/json"
  2828. ],
  2829. "tags": [
  2830. "issue"
  2831. ],
  2832. "summary": "Get all of a repository's labels",
  2833. "operationId": "issueListLabels",
  2834. "parameters": [
  2835. {
  2836. "type": "string",
  2837. "description": "owner of the repo",
  2838. "name": "owner",
  2839. "in": "path",
  2840. "required": true
  2841. },
  2842. {
  2843. "type": "string",
  2844. "description": "name of the repo",
  2845. "name": "repo",
  2846. "in": "path",
  2847. "required": true
  2848. }
  2849. ],
  2850. "responses": {
  2851. "200": {
  2852. "$ref": "#/responses/LabelList"
  2853. }
  2854. }
  2855. },
  2856. "post": {
  2857. "consumes": [
  2858. "application/json"
  2859. ],
  2860. "produces": [
  2861. "application/json"
  2862. ],
  2863. "tags": [
  2864. "issue"
  2865. ],
  2866. "summary": "Create a label",
  2867. "operationId": "issueCreateLabel",
  2868. "parameters": [
  2869. {
  2870. "type": "string",
  2871. "description": "owner of the repo",
  2872. "name": "owner",
  2873. "in": "path",
  2874. "required": true
  2875. },
  2876. {
  2877. "type": "string",
  2878. "description": "name of the repo",
  2879. "name": "repo",
  2880. "in": "path",
  2881. "required": true
  2882. },
  2883. {
  2884. "name": "body",
  2885. "in": "body",
  2886. "schema": {
  2887. "$ref": "#/definitions/CreateLabelOption"
  2888. }
  2889. }
  2890. ],
  2891. "responses": {
  2892. "201": {
  2893. "$ref": "#/responses/Label"
  2894. }
  2895. }
  2896. }
  2897. },
  2898. "/repos/{owner}/{repo}/labels/{id}": {
  2899. "get": {
  2900. "produces": [
  2901. "application/json"
  2902. ],
  2903. "tags": [
  2904. "issue"
  2905. ],
  2906. "summary": "Get a single label",
  2907. "operationId": "issueGetLabel",
  2908. "parameters": [
  2909. {
  2910. "type": "string",
  2911. "description": "owner of the repo",
  2912. "name": "owner",
  2913. "in": "path",
  2914. "required": true
  2915. },
  2916. {
  2917. "type": "string",
  2918. "description": "name of the repo",
  2919. "name": "repo",
  2920. "in": "path",
  2921. "required": true
  2922. },
  2923. {
  2924. "type": "integer",
  2925. "format": "int64",
  2926. "description": "id of the label to get",
  2927. "name": "id",
  2928. "in": "path",
  2929. "required": true
  2930. }
  2931. ],
  2932. "responses": {
  2933. "200": {
  2934. "$ref": "#/responses/Label"
  2935. }
  2936. }
  2937. },
  2938. "delete": {
  2939. "tags": [
  2940. "issue"
  2941. ],
  2942. "summary": "Delete a label",
  2943. "operationId": "issueDeleteLabel",
  2944. "parameters": [
  2945. {
  2946. "type": "string",
  2947. "description": "owner of the repo",
  2948. "name": "owner",
  2949. "in": "path",
  2950. "required": true
  2951. },
  2952. {
  2953. "type": "string",
  2954. "description": "name of the repo",
  2955. "name": "repo",
  2956. "in": "path",
  2957. "required": true
  2958. },
  2959. {
  2960. "type": "integer",
  2961. "format": "int64",
  2962. "description": "id of the label to delete",
  2963. "name": "id",
  2964. "in": "path",
  2965. "required": true
  2966. }
  2967. ],
  2968. "responses": {
  2969. "204": {
  2970. "$ref": "#/responses/empty"
  2971. }
  2972. }
  2973. },
  2974. "patch": {
  2975. "consumes": [
  2976. "application/json"
  2977. ],
  2978. "produces": [
  2979. "application/json"
  2980. ],
  2981. "tags": [
  2982. "issue"
  2983. ],
  2984. "summary": "Update a label",
  2985. "operationId": "issueEditLabel",
  2986. "parameters": [
  2987. {
  2988. "type": "string",
  2989. "description": "owner of the repo",
  2990. "name": "owner",
  2991. "in": "path",
  2992. "required": true
  2993. },
  2994. {
  2995. "type": "string",
  2996. "description": "name of the repo",
  2997. "name": "repo",
  2998. "in": "path",
  2999. "required": true
  3000. },
  3001. {
  3002. "type": "integer",
  3003. "format": "int64",
  3004. "description": "id of the label to edit",
  3005. "name": "id",
  3006. "in": "path",
  3007. "required": true
  3008. },
  3009. {
  3010. "name": "body",
  3011. "in": "body",
  3012. "schema": {
  3013. "$ref": "#/definitions/EditLabelOption"
  3014. }
  3015. }
  3016. ],
  3017. "responses": {
  3018. "200": {
  3019. "$ref": "#/responses/Label"
  3020. }
  3021. }
  3022. }
  3023. },
  3024. "/repos/{owner}/{repo}/milestones": {
  3025. "get": {
  3026. "produces": [
  3027. "application/json"
  3028. ],
  3029. "tags": [
  3030. "issue"
  3031. ],
  3032. "summary": "Get all of a repository's milestones",
  3033. "operationId": "issueGetMilestonesList",
  3034. "parameters": [
  3035. {
  3036. "type": "string",
  3037. "description": "owner of the repo",
  3038. "name": "owner",
  3039. "in": "path",
  3040. "required": true
  3041. },
  3042. {
  3043. "type": "string",
  3044. "description": "name of the repo",
  3045. "name": "repo",
  3046. "in": "path",
  3047. "required": true
  3048. }
  3049. ],
  3050. "responses": {
  3051. "200": {
  3052. "$ref": "#/responses/MilestoneList"
  3053. }
  3054. }
  3055. },
  3056. "post": {
  3057. "consumes": [
  3058. "application/json"
  3059. ],
  3060. "produces": [
  3061. "application/json"
  3062. ],
  3063. "tags": [
  3064. "issue"
  3065. ],
  3066. "summary": "Create a milestone",
  3067. "operationId": "issueCreateMilestone",
  3068. "parameters": [
  3069. {
  3070. "type": "string",
  3071. "description": "owner of the repo",
  3072. "name": "owner",
  3073. "in": "path",
  3074. "required": true
  3075. },
  3076. {
  3077. "type": "string",
  3078. "description": "name of the repo",
  3079. "name": "repo",
  3080. "in": "path",
  3081. "required": true
  3082. },
  3083. {
  3084. "name": "body",
  3085. "in": "body",
  3086. "schema": {
  3087. "$ref": "#/definitions/CreateMilestoneOption"
  3088. }
  3089. }
  3090. ],
  3091. "responses": {
  3092. "201": {
  3093. "$ref": "#/responses/Milestone"
  3094. }
  3095. }
  3096. }
  3097. },
  3098. "/repos/{owner}/{repo}/milestones/{id}": {
  3099. "get": {
  3100. "produces": [
  3101. "application/json"
  3102. ],
  3103. "tags": [
  3104. "issue"
  3105. ],
  3106. "summary": "Get a milestone",
  3107. "operationId": "issueGetMilestone",
  3108. "parameters": [
  3109. {
  3110. "type": "string",
  3111. "description": "owner of the repo",
  3112. "name": "owner",
  3113. "in": "path",
  3114. "required": true
  3115. },
  3116. {
  3117. "type": "string",
  3118. "description": "name of the repo",
  3119. "name": "repo",
  3120. "in": "path",
  3121. "required": true
  3122. },
  3123. {
  3124. "type": "integer",
  3125. "format": "int64",
  3126. "description": "id of the milestone",
  3127. "name": "id",
  3128. "in": "path",
  3129. "required": true
  3130. }
  3131. ],
  3132. "responses": {
  3133. "200": {
  3134. "$ref": "#/responses/Milestone"
  3135. }
  3136. }
  3137. },
  3138. "delete": {
  3139. "tags": [
  3140. "issue"
  3141. ],
  3142. "summary": "Delete a milestone",
  3143. "operationId": "issueDeleteMilestone",
  3144. "parameters": [
  3145. {
  3146. "type": "string",
  3147. "description": "owner of the repo",
  3148. "name": "owner",
  3149. "in": "path",
  3150. "required": true
  3151. },
  3152. {
  3153. "type": "string",
  3154. "description": "name of the repo",
  3155. "name": "repo",
  3156. "in": "path",
  3157. "required": true
  3158. },
  3159. {
  3160. "type": "integer",
  3161. "format": "int64",
  3162. "description": "id of the milestone to delete",
  3163. "name": "id",
  3164. "in": "path",
  3165. "required": true
  3166. }
  3167. ],
  3168. "responses": {
  3169. "204": {
  3170. "$ref": "#/responses/empty"
  3171. }
  3172. }
  3173. },
  3174. "patch": {
  3175. "consumes": [
  3176. "application/json"
  3177. ],
  3178. "produces": [
  3179. "application/json"
  3180. ],
  3181. "tags": [
  3182. "issue"
  3183. ],
  3184. "summary": "Update a milestone",
  3185. "operationId": "issueEditMilestone",
  3186. "parameters": [
  3187. {
  3188. "type": "string",
  3189. "description": "owner of the repo",
  3190. "name": "owner",
  3191. "in": "path",
  3192. "required": true
  3193. },
  3194. {
  3195. "type": "string",
  3196. "description": "name of the repo",
  3197. "name": "repo",
  3198. "in": "path",
  3199. "required": true
  3200. },
  3201. {
  3202. "type": "integer",
  3203. "format": "int64",
  3204. "description": "id of the milestone",
  3205. "name": "id",
  3206. "in": "path",
  3207. "required": true
  3208. },
  3209. {
  3210. "name": "body",
  3211. "in": "body",
  3212. "schema": {
  3213. "$ref": "#/definitions/EditMilestoneOption"
  3214. }
  3215. }
  3216. ],
  3217. "responses": {
  3218. "200": {
  3219. "$ref": "#/responses/Milestone"
  3220. }
  3221. }
  3222. }
  3223. },
  3224. "/repos/{owner}/{repo}/mirror-sync": {
  3225. "post": {
  3226. "produces": [
  3227. "application/json"
  3228. ],
  3229. "tags": [
  3230. "repository"
  3231. ],
  3232. "summary": "Sync a mirrored repository",
  3233. "operationId": "repoMirrorSync",
  3234. "parameters": [
  3235. {
  3236. "type": "string",
  3237. "description": "owner of the repo to sync",
  3238. "name": "owner",
  3239. "in": "path",
  3240. "required": true
  3241. },
  3242. {
  3243. "type": "string",
  3244. "description": "name of the repo to sync",
  3245. "name": "repo",
  3246. "in": "path",
  3247. "required": true
  3248. }
  3249. ],
  3250. "responses": {
  3251. "200": {
  3252. "$ref": "#/responses/empty"
  3253. }
  3254. }
  3255. }
  3256. },
  3257. "/repos/{owner}/{repo}/pulls": {
  3258. "get": {
  3259. "produces": [
  3260. "application/json"
  3261. ],
  3262. "tags": [
  3263. "repository"
  3264. ],
  3265. "summary": "List a repo's pull requests",
  3266. "operationId": "repoListPullRequests",
  3267. "parameters": [
  3268. {
  3269. "type": "string",
  3270. "description": "owner of the repo",
  3271. "name": "owner",
  3272. "in": "path",
  3273. "required": true
  3274. },
  3275. {
  3276. "type": "string",
  3277. "description": "name of the repo",
  3278. "name": "repo",
  3279. "in": "path",
  3280. "required": true
  3281. },
  3282. {
  3283. "type": "integer",
  3284. "description": "Page number",
  3285. "name": "page",
  3286. "in": "query"
  3287. },
  3288. {
  3289. "enum": [
  3290. "closed",
  3291. "open",
  3292. "all"
  3293. ],
  3294. "type": "string",
  3295. "description": "State of pull request: open or closed (optional)",
  3296. "name": "state",
  3297. "in": "query"
  3298. },
  3299. {
  3300. "enum": [
  3301. "oldest",
  3302. "recentupdate",
  3303. "leastupdate",
  3304. "mostcomment",
  3305. "leastcomment",
  3306. "priority"
  3307. ],
  3308. "type": "string",
  3309. "description": "Type of sort",
  3310. "name": "sort",
  3311. "in": "query"
  3312. },
  3313. {
  3314. "type": "integer",
  3315. "format": "int64",
  3316. "description": "ID of the milestone",
  3317. "name": "milestone",
  3318. "in": "query"
  3319. },
  3320. {
  3321. "type": "array",
  3322. "items": {
  3323. "type": "integer",
  3324. "format": "int64"
  3325. },
  3326. "collectionFormat": "multi",
  3327. "description": "Label IDs",
  3328. "name": "labels",
  3329. "in": "query"
  3330. }
  3331. ],
  3332. "responses": {
  3333. "200": {
  3334. "$ref": "#/responses/PullRequestList"
  3335. }
  3336. }
  3337. },
  3338. "post": {
  3339. "consumes": [
  3340. "application/json"
  3341. ],
  3342. "produces": [
  3343. "application/json"
  3344. ],
  3345. "tags": [
  3346. "repository"
  3347. ],
  3348. "summary": "Create a pull request",
  3349. "operationId": "repoCreatePullRequest",
  3350. "parameters": [
  3351. {
  3352. "type": "string",
  3353. "description": "owner of the repo",
  3354. "name": "owner",
  3355. "in": "path",
  3356. "required": true
  3357. },
  3358. {
  3359. "type": "string",
  3360. "description": "name of the repo",
  3361. "name": "repo",
  3362. "in": "path",
  3363. "required": true
  3364. },
  3365. {
  3366. "name": "body",
  3367. "in": "body",
  3368. "schema": {
  3369. "$ref": "#/definitions/CreatePullRequestOption"
  3370. }
  3371. }
  3372. ],
  3373. "responses": {
  3374. "201": {
  3375. "$ref": "#/responses/PullRequest"
  3376. }
  3377. }
  3378. }
  3379. },
  3380. "/repos/{owner}/{repo}/pulls/{index}": {
  3381. "get": {
  3382. "produces": [
  3383. "application/json"
  3384. ],
  3385. "tags": [
  3386. "repository"
  3387. ],
  3388. "summary": "Get a pull request",
  3389. "operationId": "repoGetPullRequest",
  3390. "parameters": [
  3391. {
  3392. "type": "string",
  3393. "description": "owner of the repo",
  3394. "name": "owner",
  3395. "in": "path",
  3396. "required": true
  3397. },
  3398. {
  3399. "type": "string",
  3400. "description": "name of the repo",
  3401. "name": "repo",
  3402. "in": "path",
  3403. "required": true
  3404. },
  3405. {
  3406. "type": "integer",
  3407. "format": "int64",
  3408. "description": "index of the pull request to get",
  3409. "name": "index",
  3410. "in": "path",
  3411. "required": true
  3412. }
  3413. ],
  3414. "responses": {
  3415. "200": {
  3416. "$ref": "#/responses/PullRequest"
  3417. }
  3418. }
  3419. },
  3420. "patch": {
  3421. "consumes": [
  3422. "application/json"
  3423. ],
  3424. "produces": [
  3425. "application/json"
  3426. ],
  3427. "tags": [
  3428. "repository"
  3429. ],
  3430. "summary": "Update a pull request",
  3431. "operationId": "repoEditPullRequest",
  3432. "parameters": [
  3433. {
  3434. "type": "string",
  3435. "description": "owner of the repo",
  3436. "name": "owner",
  3437. "in": "path",
  3438. "required": true
  3439. },
  3440. {
  3441. "type": "string",
  3442. "description": "name of the repo",
  3443. "name": "repo",
  3444. "in": "path",
  3445. "required": true
  3446. },
  3447. {
  3448. "type": "integer",
  3449. "format": "int64",
  3450. "description": "index of the pull request to edit",
  3451. "name": "index",
  3452. "in": "path",
  3453. "required": true
  3454. },
  3455. {
  3456. "name": "body",
  3457. "in": "body",
  3458. "schema": {
  3459. "$ref": "#/definitions/EditPullRequestOption"
  3460. }
  3461. }
  3462. ],
  3463. "responses": {
  3464. "201": {
  3465. "$ref": "#/responses/PullRequest"
  3466. }
  3467. }
  3468. }
  3469. },
  3470. "/repos/{owner}/{repo}/pulls/{index}/merge": {
  3471. "get": {
  3472. "produces": [
  3473. "application/json"
  3474. ],
  3475. "tags": [
  3476. "repository"
  3477. ],
  3478. "summary": "Check if a pull request has been merged",
  3479. "operationId": "repoPullRequestIsMerged",
  3480. "parameters": [
  3481. {
  3482. "type": "string",
  3483. "description": "owner of the repo",
  3484. "name": "owner",
  3485. "in": "path",
  3486. "required": true
  3487. },
  3488. {
  3489. "type": "string",
  3490. "description": "name of the repo",
  3491. "name": "repo",
  3492. "in": "path",
  3493. "required": true
  3494. },
  3495. {
  3496. "type": "integer",
  3497. "format": "int64",
  3498. "description": "index of the pull request",
  3499. "name": "index",
  3500. "in": "path",
  3501. "required": true
  3502. }
  3503. ],
  3504. "responses": {
  3505. "204": {
  3506. "description": "pull request has been merged"
  3507. },
  3508. "404": {
  3509. "description": "pull request has not been merged"
  3510. }
  3511. }
  3512. },
  3513. "post": {
  3514. "produces": [
  3515. "application/json"
  3516. ],
  3517. "tags": [
  3518. "repository"
  3519. ],
  3520. "summary": "Merge a pull request",
  3521. "operationId": "repoMergePullRequest",
  3522. "parameters": [
  3523. {
  3524. "type": "string",
  3525. "description": "owner of the repo",
  3526. "name": "owner",
  3527. "in": "path",
  3528. "required": true
  3529. },
  3530. {
  3531. "type": "string",
  3532. "description": "name of the repo",
  3533. "name": "repo",
  3534. "in": "path",
  3535. "required": true
  3536. },
  3537. {
  3538. "type": "integer",
  3539. "format": "int64",
  3540. "description": "index of the pull request to merge",
  3541. "name": "index",
  3542. "in": "path",
  3543. "required": true
  3544. }
  3545. ],
  3546. "responses": {
  3547. "200": {
  3548. "$ref": "#/responses/empty"
  3549. },
  3550. "405": {
  3551. "$ref": "#/responses/empty"
  3552. }
  3553. }
  3554. }
  3555. },
  3556. "/repos/{owner}/{repo}/raw/{filepath}": {
  3557. "get": {
  3558. "produces": [
  3559. "application/json"
  3560. ],
  3561. "tags": [
  3562. "repository"
  3563. ],
  3564. "summary": "Get a file from a repository",
  3565. "operationId": "repoGetRawFile",
  3566. "parameters": [
  3567. {
  3568. "type": "string",
  3569. "description": "owner of the repo",
  3570. "name": "owner",
  3571. "in": "path",
  3572. "required": true
  3573. },
  3574. {
  3575. "type": "string",
  3576. "description": "name of the repo",
  3577. "name": "repo",
  3578. "in": "path",
  3579. "required": true
  3580. },
  3581. {
  3582. "type": "string",
  3583. "description": "filepath of the file to get",
  3584. "name": "filepath",
  3585. "in": "path",
  3586. "required": true
  3587. }
  3588. ],
  3589. "responses": {
  3590. "200": {
  3591. "description": "success"
  3592. }
  3593. }
  3594. }
  3595. },
  3596. "/repos/{owner}/{repo}/releases": {
  3597. "get": {
  3598. "produces": [
  3599. "application/json"
  3600. ],
  3601. "tags": [
  3602. "repository"
  3603. ],
  3604. "summary": "List a repo's releases",
  3605. "operationId": "repoListReleases",
  3606. "parameters": [
  3607. {
  3608. "type": "string",
  3609. "description": "owner of the repo",
  3610. "name": "owner",
  3611. "in": "path",
  3612. "required": true
  3613. },
  3614. {
  3615. "type": "string",
  3616. "description": "name of the repo",
  3617. "name": "repo",
  3618. "in": "path",
  3619. "required": true
  3620. }
  3621. ],
  3622. "responses": {
  3623. "200": {
  3624. "$ref": "#/responses/ReleaseList"
  3625. }
  3626. }
  3627. },
  3628. "post": {
  3629. "consumes": [
  3630. "application/json"
  3631. ],
  3632. "produces": [
  3633. "application/json"
  3634. ],
  3635. "tags": [
  3636. "repository"
  3637. ],
  3638. "summary": "Create a release",
  3639. "operationId": "repoCreateRelease",
  3640. "parameters": [
  3641. {
  3642. "type": "string",
  3643. "description": "owner of the repo",
  3644. "name": "owner",
  3645. "in": "path",
  3646. "required": true
  3647. },
  3648. {
  3649. "type": "string",
  3650. "description": "name of the repo",
  3651. "name": "repo",
  3652. "in": "path",
  3653. "required": true
  3654. },
  3655. {
  3656. "name": "body",
  3657. "in": "body",
  3658. "schema": {
  3659. "$ref": "#/definitions/CreateReleaseOption"
  3660. }
  3661. }
  3662. ],
  3663. "responses": {
  3664. "201": {
  3665. "$ref": "#/responses/Release"
  3666. }
  3667. }
  3668. }
  3669. },
  3670. "/repos/{owner}/{repo}/releases/{id}": {
  3671. "get": {
  3672. "produces": [
  3673. "application/json"
  3674. ],
  3675. "tags": [
  3676. "repository"
  3677. ],
  3678. "summary": "Get a release",
  3679. "operationId": "repoGetRelease",
  3680. "parameters": [
  3681. {
  3682. "type": "string",
  3683. "description": "owner of the repo",
  3684. "name": "owner",
  3685. "in": "path",
  3686. "required": true
  3687. },
  3688. {
  3689. "type": "string",
  3690. "description": "name of the repo",
  3691. "name": "repo",
  3692. "in": "path",
  3693. "required": true
  3694. },
  3695. {
  3696. "type": "integer",
  3697. "format": "int64",
  3698. "description": "id of the release to get",
  3699. "name": "id",
  3700. "in": "path",
  3701. "required": true
  3702. }
  3703. ],
  3704. "responses": {
  3705. "200": {
  3706. "$ref": "#/responses/Release"
  3707. }
  3708. }
  3709. },
  3710. "delete": {
  3711. "tags": [
  3712. "repository"
  3713. ],
  3714. "summary": "Delete a release",
  3715. "operationId": "repoDeleteRelease",
  3716. "parameters": [
  3717. {
  3718. "type": "string",
  3719. "description": "owner of the repo",
  3720. "name": "owner",
  3721. "in": "path",
  3722. "required": true
  3723. },
  3724. {
  3725. "type": "string",
  3726. "description": "name of the repo",
  3727. "name": "repo",
  3728. "in": "path",
  3729. "required": true
  3730. },
  3731. {
  3732. "type": "integer",
  3733. "format": "int64",
  3734. "description": "id of the release to delete",
  3735. "name": "id",
  3736. "in": "path",
  3737. "required": true
  3738. }
  3739. ],
  3740. "responses": {
  3741. "204": {
  3742. "$ref": "#/responses/empty"
  3743. }
  3744. }
  3745. },
  3746. "patch": {
  3747. "consumes": [
  3748. "application/json"
  3749. ],
  3750. "produces": [
  3751. "application/json"
  3752. ],
  3753. "tags": [
  3754. "repository"
  3755. ],
  3756. "summary": "Update a release",
  3757. "operationId": "repoEditRelease",
  3758. "parameters": [
  3759. {
  3760. "type": "string",
  3761. "description": "owner of the repo",
  3762. "name": "owner",
  3763. "in": "path",
  3764. "required": true
  3765. },
  3766. {
  3767. "type": "string",
  3768. "description": "name of the repo",
  3769. "name": "repo",
  3770. "in": "path",
  3771. "required": true
  3772. },
  3773. {
  3774. "type": "integer",
  3775. "format": "int64",
  3776. "description": "id of the release to edit",
  3777. "name": "id",
  3778. "in": "path",
  3779. "required": true
  3780. },
  3781. {
  3782. "name": "body",
  3783. "in": "body",
  3784. "schema": {
  3785. "$ref": "#/definitions/EditReleaseOption"
  3786. }
  3787. }
  3788. ],
  3789. "responses": {
  3790. "200": {
  3791. "$ref": "#/responses/Release"
  3792. }
  3793. }
  3794. }
  3795. },
  3796. "/repos/{owner}/{repo}/releases/{id}/assets": {
  3797. "get": {
  3798. "produces": [
  3799. "application/json"
  3800. ],
  3801. "tags": [
  3802. "repository"
  3803. ],
  3804. "summary": "List release's attachments",
  3805. "operationId": "repoListReleaseAttachments",
  3806. "parameters": [
  3807. {
  3808. "type": "string",
  3809. "description": "owner of the repo",
  3810. "name": "owner",
  3811. "in": "path",
  3812. "required": true
  3813. },
  3814. {
  3815. "type": "string",
  3816. "description": "name of the repo",
  3817. "name": "repo",
  3818. "in": "path",
  3819. "required": true
  3820. },
  3821. {
  3822. "type": "integer",
  3823. "format": "int64",
  3824. "description": "id of the release",
  3825. "name": "id",
  3826. "in": "path",
  3827. "required": true
  3828. }
  3829. ],
  3830. "responses": {
  3831. "200": {
  3832. "$ref": "#/responses/AttachmentList"
  3833. }
  3834. }
  3835. },
  3836. "post": {
  3837. "consumes": [
  3838. "multipart/form-data"
  3839. ],
  3840. "produces": [
  3841. "application/json"
  3842. ],
  3843. "tags": [
  3844. "repository"
  3845. ],
  3846. "summary": "Create a release attachment",
  3847. "operationId": "repoCreateReleaseAttachment",
  3848. "parameters": [
  3849. {
  3850. "type": "string",
  3851. "description": "owner of the repo",
  3852. "name": "owner",
  3853. "in": "path",
  3854. "required": true
  3855. },
  3856. {
  3857. "type": "string",
  3858. "description": "name of the repo",
  3859. "name": "repo",
  3860. "in": "path",
  3861. "required": true
  3862. },
  3863. {
  3864. "type": "integer",
  3865. "format": "int64",
  3866. "description": "id of the release",
  3867. "name": "id",
  3868. "in": "path",
  3869. "required": true
  3870. },
  3871. {
  3872. "type": "string",
  3873. "description": "name of the attachment",
  3874. "name": "name",
  3875. "in": "query"
  3876. },
  3877. {
  3878. "type": "file",
  3879. "description": "attachment to upload",
  3880. "name": "attachment",
  3881. "in": "formData",
  3882. "required": true
  3883. }
  3884. ],
  3885. "responses": {
  3886. "201": {
  3887. "$ref": "#/responses/Attachment"
  3888. }
  3889. }
  3890. }
  3891. },
  3892. "/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}": {
  3893. "get": {
  3894. "produces": [
  3895. "application/json"
  3896. ],
  3897. "tags": [
  3898. "repository"
  3899. ],
  3900. "summary": "Get a release attachment",
  3901. "operationId": "repoGetReleaseAttachment",
  3902. "parameters": [
  3903. {
  3904. "type": "string",
  3905. "description": "owner of the repo",
  3906. "name": "owner",
  3907. "in": "path",
  3908. "required": true
  3909. },
  3910. {
  3911. "type": "string",
  3912. "description": "name of the repo",
  3913. "name": "repo",
  3914. "in": "path",
  3915. "required": true
  3916. },
  3917. {
  3918. "type": "integer",
  3919. "format": "int64",
  3920. "description": "id of the release",
  3921. "name": "id",
  3922. "in": "path",
  3923. "required": true
  3924. },
  3925. {
  3926. "type": "integer",
  3927. "format": "int64",
  3928. "description": "id of the attachment to get",
  3929. "name": "attachment_id",
  3930. "in": "path",
  3931. "required": true
  3932. }
  3933. ],
  3934. "responses": {
  3935. "200": {
  3936. "$ref": "#/responses/Attachment"
  3937. }
  3938. }
  3939. },
  3940. "delete": {
  3941. "produces": [
  3942. "application/json"
  3943. ],
  3944. "tags": [
  3945. "repository"
  3946. ],
  3947. "summary": "Delete a release attachment",
  3948. "operationId": "repoDeleteReleaseAttachment",
  3949. "parameters": [
  3950. {
  3951. "type": "string",
  3952. "description": "owner of the repo",
  3953. "name": "owner",
  3954. "in": "path",
  3955. "required": true
  3956. },
  3957. {
  3958. "type": "string",
  3959. "description": "name of the repo",
  3960. "name": "repo",
  3961. "in": "path",
  3962. "required": true
  3963. },
  3964. {
  3965. "type": "integer",
  3966. "format": "int64",
  3967. "description": "id of the release",
  3968. "name": "id",
  3969. "in": "path",
  3970. "required": true
  3971. },
  3972. {
  3973. "type": "integer",
  3974. "format": "int64",
  3975. "description": "id of the attachment to delete",
  3976. "name": "attachment_id",
  3977. "in": "path",
  3978. "required": true
  3979. }
  3980. ],
  3981. "responses": {
  3982. "204": {
  3983. "$ref": "#/responses/empty"
  3984. }
  3985. }
  3986. },
  3987. "patch": {
  3988. "consumes": [
  3989. "application/json"
  3990. ],
  3991. "produces": [
  3992. "application/json"
  3993. ],
  3994. "tags": [
  3995. "repository"
  3996. ],
  3997. "summary": "Edit a release attachment",
  3998. "operationId": "repoEditReleaseAttachment",
  3999. "parameters": [
  4000. {
  4001. "type": "string",
  4002. "description": "owner of the repo",
  4003. "name": "owner",
  4004. "in": "path",
  4005. "required": true
  4006. },
  4007. {
  4008. "type": "string",
  4009. "description": "name of the repo",
  4010. "name": "repo",
  4011. "in": "path",
  4012. "required": true
  4013. },
  4014. {
  4015. "type": "integer",
  4016. "format": "int64",
  4017. "description": "id of the release",
  4018. "name": "id",
  4019. "in": "path",
  4020. "required": true
  4021. },
  4022. {
  4023. "type": "integer",
  4024. "format": "int64",
  4025. "description": "id of the attachment to edit",
  4026. "name": "attachment_id",
  4027. "in": "path",
  4028. "required": true
  4029. },
  4030. {
  4031. "name": "body",
  4032. "in": "body",
  4033. "schema": {
  4034. "$ref": "#/definitions/EditAttachmentOptions"
  4035. }
  4036. }
  4037. ],
  4038. "responses": {
  4039. "201": {
  4040. "$ref": "#/responses/Attachment"
  4041. }
  4042. }
  4043. }
  4044. },
  4045. "/repos/{owner}/{repo}/stargazers": {
  4046. "get": {
  4047. "produces": [
  4048. "application/json"
  4049. ],
  4050. "tags": [
  4051. "repository"
  4052. ],
  4053. "summary": "List a repo's stargazers",
  4054. "operationId": "repoListStargazers",
  4055. "parameters": [
  4056. {
  4057. "type": "string",
  4058. "description": "owner of the repo",
  4059. "name": "owner",
  4060. "in": "path",
  4061. "required": true
  4062. },
  4063. {
  4064. "type": "string",
  4065. "description": "name of the repo",
  4066. "name": "repo",
  4067. "in": "path",
  4068. "required": true
  4069. }
  4070. ],
  4071. "responses": {
  4072. "200": {
  4073. "$ref": "#/responses/UserList"
  4074. }
  4075. }
  4076. }
  4077. },
  4078. "/repos/{owner}/{repo}/statuses/{sha}": {
  4079. "get": {
  4080. "produces": [
  4081. "application/json"
  4082. ],
  4083. "tags": [
  4084. "repository"
  4085. ],
  4086. "summary": "Get a commit's statuses",
  4087. "operationId": "repoListStatuses",
  4088. "parameters": [
  4089. {
  4090. "type": "string",
  4091. "description": "owner of the repo",
  4092. "name": "owner",
  4093. "in": "path",
  4094. "required": true
  4095. },
  4096. {
  4097. "type": "string",
  4098. "description": "name of the repo",
  4099. "name": "repo",
  4100. "in": "path",
  4101. "required": true
  4102. },
  4103. {
  4104. "type": "string",
  4105. "description": "sha of the commit",
  4106. "name": "sha",
  4107. "in": "path",
  4108. "required": true
  4109. }
  4110. ],
  4111. "responses": {
  4112. "200": {
  4113. "$ref": "#/responses/StatusList"
  4114. }
  4115. }
  4116. },
  4117. "post": {
  4118. "produces": [
  4119. "application/json"
  4120. ],
  4121. "tags": [
  4122. "repository"
  4123. ],
  4124. "summary": "Create a commit status",
  4125. "operationId": "repoCreateStatus",
  4126. "parameters": [
  4127. {
  4128. "type": "string",
  4129. "description": "owner of the repo",
  4130. "name": "owner",
  4131. "in": "path",
  4132. "required": true
  4133. },
  4134. {
  4135. "type": "string",
  4136. "description": "name of the repo",
  4137. "name": "repo",
  4138. "in": "path",
  4139. "required": true
  4140. },
  4141. {
  4142. "type": "string",
  4143. "description": "sha of the commit",
  4144. "name": "sha",
  4145. "in": "path",
  4146. "required": true
  4147. },
  4148. {
  4149. "name": "body",
  4150. "in": "body",
  4151. "schema": {
  4152. "$ref": "#/definitions/CreateStatusOption"
  4153. }
  4154. }
  4155. ],
  4156. "responses": {
  4157. "200": {
  4158. "$ref": "#/responses/StatusList"
  4159. }
  4160. }
  4161. }
  4162. },
  4163. "/repos/{owner}/{repo}/subscribers": {
  4164. "get": {
  4165. "produces": [
  4166. "application/json"
  4167. ],
  4168. "tags": [
  4169. "repository"
  4170. ],
  4171. "summary": "List a repo's watchers",
  4172. "operationId": "repoListSubscribers",
  4173. "parameters": [
  4174. {
  4175. "type": "string",
  4176. "description": "owner of the repo",
  4177. "name": "owner",
  4178. "in": "path",
  4179. "required": true
  4180. },
  4181. {
  4182. "type": "string",
  4183. "description": "name of the repo",
  4184. "name": "repo",
  4185. "in": "path",
  4186. "required": true
  4187. }
  4188. ],
  4189. "responses": {
  4190. "200": {
  4191. "$ref": "#/responses/UserList"
  4192. }
  4193. }
  4194. }
  4195. },
  4196. "/repos/{owner}/{repo}/subscription": {
  4197. "get": {
  4198. "tags": [
  4199. "repository"
  4200. ],
  4201. "summary": "Check if the current user is watching a repo",
  4202. "operationId": "userCurrentCheckSubscription",
  4203. "parameters": [
  4204. {
  4205. "type": "string",
  4206. "description": "owner of the repo",
  4207. "name": "owner",
  4208. "in": "path",
  4209. "required": true
  4210. },
  4211. {
  4212. "type": "string",
  4213. "description": "name of the repo",
  4214. "name": "repo",
  4215. "in": "path",
  4216. "required": true
  4217. }
  4218. ],
  4219. "responses": {
  4220. "200": {
  4221. "$ref": "#/responses/WatchInfo"
  4222. }
  4223. }
  4224. },
  4225. "put": {
  4226. "tags": [
  4227. "repository"
  4228. ],
  4229. "summary": "Watch a repo",
  4230. "operationId": "userCurrentPutSubscription",
  4231. "parameters": [
  4232. {
  4233. "type": "string",
  4234. "description": "owner of the repo",
  4235. "name": "owner",
  4236. "in": "path",
  4237. "required": true
  4238. },
  4239. {
  4240. "type": "string",
  4241. "description": "name of the repo",
  4242. "name": "repo",
  4243. "in": "path",
  4244. "required": true
  4245. }
  4246. ],
  4247. "responses": {
  4248. "200": {
  4249. "$ref": "#/responses/WatchInfo"
  4250. }
  4251. }
  4252. },
  4253. "delete": {
  4254. "tags": [
  4255. "repository"
  4256. ],
  4257. "summary": "Unwatch a repo",
  4258. "operationId": "userCurrentDeleteSubscription",
  4259. "parameters": [
  4260. {
  4261. "type": "string",
  4262. "description": "owner of the repo",
  4263. "name": "owner",
  4264. "in": "path",
  4265. "required": true
  4266. },
  4267. {
  4268. "type": "string",
  4269. "description": "name of the repo",
  4270. "name": "repo",
  4271. "in": "path",
  4272. "required": true
  4273. }
  4274. ],
  4275. "responses": {
  4276. "204": {
  4277. "$ref": "#/responses/empty"
  4278. }
  4279. }
  4280. }
  4281. },
  4282. "/repos/{owner}/{repo}/times": {
  4283. "get": {
  4284. "produces": [
  4285. "application/json"
  4286. ],
  4287. "tags": [
  4288. "repository"
  4289. ],
  4290. "summary": "List a repo's tracked times",
  4291. "operationId": "repoTrackedTimes",
  4292. "parameters": [
  4293. {
  4294. "type": "string",
  4295. "description": "owner of the repo",
  4296. "name": "owner",
  4297. "in": "path",
  4298. "required": true
  4299. },
  4300. {
  4301. "type": "string",
  4302. "description": "name of the repo",
  4303. "name": "repo",
  4304. "in": "path",
  4305. "required": true
  4306. }
  4307. ],
  4308. "responses": {
  4309. "200": {
  4310. "$ref": "#/responses/TrackedTimeList"
  4311. }
  4312. }
  4313. }
  4314. },
  4315. "/repos/{owner}/{repo}/times/{user}": {
  4316. "get": {
  4317. "produces": [
  4318. "application/json"
  4319. ],
  4320. "tags": [
  4321. "user"
  4322. ],
  4323. "summary": "List a user's tracked times in a repo",
  4324. "operationId": "userTrackedTimes",
  4325. "parameters": [
  4326. {
  4327. "type": "string",
  4328. "description": "owner of the repo",
  4329. "name": "owner",
  4330. "in": "path",
  4331. "required": true
  4332. },
  4333. {
  4334. "type": "string",
  4335. "description": "name of the repo",
  4336. "name": "repo",
  4337. "in": "path",
  4338. "required": true
  4339. },
  4340. {
  4341. "type": "string",
  4342. "description": "username of user",
  4343. "name": "user",
  4344. "in": "path",
  4345. "required": true
  4346. }
  4347. ],
  4348. "responses": {
  4349. "200": {
  4350. "$ref": "#/responses/TrackedTimeList"
  4351. }
  4352. }
  4353. }
  4354. },
  4355. "/repositories/{id}": {
  4356. "get": {
  4357. "produces": [
  4358. "application/json"
  4359. ],
  4360. "tags": [
  4361. "repository"
  4362. ],
  4363. "summary": "Get a repository by id",
  4364. "operationId": "repoGetByID",
  4365. "parameters": [
  4366. {
  4367. "type": "integer",
  4368. "format": "int64",
  4369. "description": "id of the repo to get",
  4370. "name": "id",
  4371. "in": "path",
  4372. "required": true
  4373. }
  4374. ],
  4375. "responses": {
  4376. "200": {
  4377. "$ref": "#/responses/Repository"
  4378. }
  4379. }
  4380. }
  4381. },
  4382. "/teams/{id}": {
  4383. "get": {
  4384. "produces": [
  4385. "application/json"
  4386. ],
  4387. "tags": [
  4388. "organization"
  4389. ],
  4390. "summary": "Get a team",
  4391. "operationId": "orgGetTeam",
  4392. "parameters": [
  4393. {
  4394. "type": "integer",
  4395. "format": "int64",
  4396. "description": "id of the team to get",
  4397. "name": "id",
  4398. "in": "path",
  4399. "required": true
  4400. }
  4401. ],
  4402. "responses": {
  4403. "200": {
  4404. "$ref": "#/responses/Team"
  4405. }
  4406. }
  4407. },
  4408. "delete": {
  4409. "tags": [
  4410. "organization"
  4411. ],
  4412. "summary": "Delete a team",
  4413. "operationId": "orgDeleteTeam",
  4414. "parameters": [
  4415. {
  4416. "type": "integer",
  4417. "format": "int64",
  4418. "description": "id of the team to delete",
  4419. "name": "id",
  4420. "in": "path",
  4421. "required": true
  4422. }
  4423. ],
  4424. "responses": {
  4425. "204": {
  4426. "description": "team deleted"
  4427. }
  4428. }
  4429. },
  4430. "patch": {
  4431. "consumes": [
  4432. "application/json"
  4433. ],
  4434. "produces": [
  4435. "application/json"
  4436. ],
  4437. "tags": [
  4438. "organization"
  4439. ],
  4440. "summary": "Edit a team",
  4441. "operationId": "orgEditTeam",
  4442. "parameters": [
  4443. {
  4444. "type": "integer",
  4445. "description": "id of the team to edit",
  4446. "name": "id",
  4447. "in": "path",
  4448. "required": true
  4449. },
  4450. {
  4451. "name": "body",
  4452. "in": "body",
  4453. "schema": {
  4454. "$ref": "#/definitions/EditTeamOption"
  4455. }
  4456. }
  4457. ],
  4458. "responses": {
  4459. "200": {
  4460. "$ref": "#/responses/Team"
  4461. }
  4462. }
  4463. }
  4464. },
  4465. "/teams/{id}/members": {
  4466. "get": {
  4467. "produces": [
  4468. "application/json"
  4469. ],
  4470. "tags": [
  4471. "organization"
  4472. ],
  4473. "summary": "List a team's members",
  4474. "operationId": "orgListTeamMembers",
  4475. "parameters": [
  4476. {
  4477. "type": "integer",
  4478. "format": "int64",
  4479. "description": "id of the team",
  4480. "name": "id",
  4481. "in": "path",
  4482. "required": true
  4483. }
  4484. ],
  4485. "responses": {
  4486. "200": {
  4487. "$ref": "#/responses/UserList"
  4488. }
  4489. }
  4490. }
  4491. },
  4492. "/teams/{id}/members/{username}": {
  4493. "put": {
  4494. "produces": [
  4495. "application/json"
  4496. ],
  4497. "tags": [
  4498. "organization"
  4499. ],
  4500. "summary": "Add a team member",
  4501. "operationId": "orgAddTeamMember",
  4502. "parameters": [
  4503. {
  4504. "type": "integer",
  4505. "format": "int64",
  4506. "description": "id of the team",
  4507. "name": "id",
  4508. "in": "path",
  4509. "required": true
  4510. },
  4511. {
  4512. "type": "string",
  4513. "description": "username of the user to add",
  4514. "name": "username",
  4515. "in": "path",
  4516. "required": true
  4517. }
  4518. ],
  4519. "responses": {
  4520. "204": {
  4521. "$ref": "#/responses/empty"
  4522. }
  4523. }
  4524. },
  4525. "delete": {
  4526. "produces": [
  4527. "application/json"
  4528. ],
  4529. "tags": [
  4530. "organization"
  4531. ],
  4532. "summary": "Remove a team member",
  4533. "operationId": "orgRemoveTeamMember",
  4534. "parameters": [
  4535. {
  4536. "type": "integer",
  4537. "format": "int64",
  4538. "description": "id of the team",
  4539. "name": "id",
  4540. "in": "path",
  4541. "required": true
  4542. },
  4543. {
  4544. "type": "string",
  4545. "description": "username of the user to remove",
  4546. "name": "username",
  4547. "in": "path",
  4548. "required": true
  4549. }
  4550. ],
  4551. "responses": {
  4552. "204": {
  4553. "$ref": "#/responses/empty"
  4554. }
  4555. }
  4556. }
  4557. },
  4558. "/teams/{id}/repos": {
  4559. "get": {
  4560. "produces": [
  4561. "application/json"
  4562. ],
  4563. "tags": [
  4564. "organization"
  4565. ],
  4566. "summary": "List a team's repos",
  4567. "operationId": "orgListTeamRepos",
  4568. "parameters": [
  4569. {
  4570. "type": "integer",
  4571. "format": "int64",
  4572. "description": "id of the team",
  4573. "name": "id",
  4574. "in": "path",
  4575. "required": true
  4576. }
  4577. ],
  4578. "responses": {
  4579. "200": {
  4580. "$ref": "#/responses/RepositoryList"
  4581. }
  4582. }
  4583. }
  4584. },
  4585. "/teams/{id}/repos/{org}/{repo}": {
  4586. "put": {
  4587. "produces": [
  4588. "application/json"
  4589. ],
  4590. "tags": [
  4591. "organization"
  4592. ],
  4593. "summary": "Add a repository to a team",
  4594. "operationId": "orgAddTeamRepository",
  4595. "parameters": [
  4596. {
  4597. "type": "integer",
  4598. "format": "int64",
  4599. "description": "id of the team",
  4600. "name": "id",
  4601. "in": "path",
  4602. "required": true
  4603. },
  4604. {
  4605. "type": "string",
  4606. "description": "organization that owns the repo to add",
  4607. "name": "org",
  4608. "in": "path",
  4609. "required": true
  4610. },
  4611. {
  4612. "type": "string",
  4613. "description": "name of the repo to add",
  4614. "name": "repo",
  4615. "in": "path",
  4616. "required": true
  4617. }
  4618. ],
  4619. "responses": {
  4620. "204": {
  4621. "$ref": "#/responses/empty"
  4622. }
  4623. }
  4624. },
  4625. "delete": {
  4626. "description": "This does not delete the repository, it only removes the repository from the team.",
  4627. "produces": [
  4628. "application/json"
  4629. ],
  4630. "tags": [
  4631. "organization"
  4632. ],
  4633. "summary": "Remove a repository from a team",
  4634. "operationId": "orgRemoveTeamRepository",
  4635. "parameters": [
  4636. {
  4637. "type": "integer",
  4638. "format": "int64",
  4639. "description": "id of the team",
  4640. "name": "id",
  4641. "in": "path",
  4642. "required": true
  4643. },
  4644. {
  4645. "type": "string",
  4646. "description": "organization that owns the repo to remove",
  4647. "name": "org",
  4648. "in": "path",
  4649. "required": true
  4650. },
  4651. {
  4652. "type": "string",
  4653. "description": "name of the repo to remove",
  4654. "name": "repo",
  4655. "in": "path",
  4656. "required": true
  4657. }
  4658. ],
  4659. "responses": {
  4660. "204": {
  4661. "$ref": "#/responses/empty"
  4662. }
  4663. }
  4664. }
  4665. },
  4666. "/topics/search": {
  4667. "get": {
  4668. "produces": [
  4669. "application/json"
  4670. ],
  4671. "tags": [
  4672. "repository"
  4673. ],
  4674. "summary": "search topics via keyword",
  4675. "operationId": "topicSearch",
  4676. "parameters": [
  4677. {
  4678. "type": "string",
  4679. "description": "keywords to search",
  4680. "name": "q",
  4681. "in": "query",
  4682. "required": true
  4683. }
  4684. ],
  4685. "responses": {
  4686. "200": {
  4687. "$ref": "#/responses/Repository"
  4688. }
  4689. }
  4690. }
  4691. },
  4692. "/user": {
  4693. "get": {
  4694. "produces": [
  4695. "application/json"
  4696. ],
  4697. "tags": [
  4698. "user"
  4699. ],
  4700. "summary": "Get the authenticated user",
  4701. "operationId": "userGetCurrent",
  4702. "responses": {
  4703. "200": {
  4704. "$ref": "#/responses/User"
  4705. }
  4706. }
  4707. }
  4708. },
  4709. "/user/emails": {
  4710. "get": {
  4711. "produces": [
  4712. "application/json"
  4713. ],
  4714. "tags": [
  4715. "user"
  4716. ],
  4717. "summary": "List the authenticated user's email addresses",
  4718. "operationId": "userListEmails",
  4719. "responses": {
  4720. "200": {
  4721. "$ref": "#/responses/EmailList"
  4722. }
  4723. }
  4724. },
  4725. "post": {
  4726. "produces": [
  4727. "application/json"
  4728. ],
  4729. "tags": [
  4730. "user"
  4731. ],
  4732. "summary": "Add email addresses",
  4733. "operationId": "userAddEmail",
  4734. "parameters": [
  4735. {
  4736. "name": "body",
  4737. "in": "body",
  4738. "schema": {
  4739. "$ref": "#/definitions/CreateEmailOption"
  4740. }
  4741. }
  4742. ],
  4743. "responses": {
  4744. "201": {
  4745. "$ref": "#/responses/EmailList"
  4746. }
  4747. }
  4748. },
  4749. "delete": {
  4750. "produces": [
  4751. "application/json"
  4752. ],
  4753. "tags": [
  4754. "user"
  4755. ],
  4756. "summary": "Delete email addresses",
  4757. "operationId": "userDeleteEmail",
  4758. "parameters": [
  4759. {
  4760. "name": "body",
  4761. "in": "body",
  4762. "schema": {
  4763. "$ref": "#/definitions/DeleteEmailOption"
  4764. }
  4765. }
  4766. ],
  4767. "responses": {
  4768. "204": {
  4769. "$ref": "#/responses/empty"
  4770. }
  4771. }
  4772. }
  4773. },
  4774. "/user/followers": {
  4775. "get": {
  4776. "produces": [
  4777. "application/json"
  4778. ],
  4779. "tags": [
  4780. "user"
  4781. ],
  4782. "summary": "List the authenticated user's followers",
  4783. "operationId": "userCurrentListFollowers",
  4784. "responses": {
  4785. "200": {
  4786. "$ref": "#/responses/UserList"
  4787. }
  4788. }
  4789. }
  4790. },
  4791. "/user/following": {
  4792. "get": {
  4793. "produces": [
  4794. "application/json"
  4795. ],
  4796. "tags": [
  4797. "user"
  4798. ],
  4799. "summary": "List the users that the authenticated user is following",
  4800. "operationId": "userCurrentListFollowing",
  4801. "responses": {
  4802. "200": {
  4803. "$ref": "#/responses/UserList"
  4804. }
  4805. }
  4806. }
  4807. },
  4808. "/user/following/{username}": {
  4809. "get": {
  4810. "tags": [
  4811. "user"
  4812. ],
  4813. "summary": "Check whether a user is followed by the authenticated user",
  4814. "operationId": "userCurrentCheckFollowing",
  4815. "parameters": [
  4816. {
  4817. "type": "string",
  4818. "description": "username of followed user",
  4819. "name": "username",
  4820. "in": "path",
  4821. "required": true
  4822. }
  4823. ],
  4824. "responses": {
  4825. "204": {
  4826. "$ref": "#/responses/empty"
  4827. },
  4828. "404": {
  4829. "$ref": "#/responses/notFound"
  4830. }
  4831. }
  4832. },
  4833. "put": {
  4834. "tags": [
  4835. "user"
  4836. ],
  4837. "summary": "Follow a user",
  4838. "operationId": "userCurrentPutFollow",
  4839. "parameters": [
  4840. {
  4841. "type": "string",
  4842. "description": "username of user to follow",
  4843. "name": "username",
  4844. "in": "path",
  4845. "required": true
  4846. }
  4847. ],
  4848. "responses": {
  4849. "204": {
  4850. "$ref": "#/responses/empty"
  4851. }
  4852. }
  4853. },
  4854. "delete": {
  4855. "tags": [
  4856. "user"
  4857. ],
  4858. "summary": "Unfollow a user",
  4859. "operationId": "userCurrentDeleteFollow",
  4860. "parameters": [
  4861. {
  4862. "type": "string",
  4863. "description": "username of user to unfollow",
  4864. "name": "username",
  4865. "in": "path",
  4866. "required": true
  4867. }
  4868. ],
  4869. "responses": {
  4870. "204": {
  4871. "$ref": "#/responses/empty"
  4872. }
  4873. }
  4874. }
  4875. },
  4876. "/user/gpg_keys": {
  4877. "get": {
  4878. "produces": [
  4879. "application/json"
  4880. ],
  4881. "tags": [
  4882. "user"
  4883. ],
  4884. "summary": "List the authenticated user's GPG keys",
  4885. "operationId": "userCurrentListGPGKeys",
  4886. "responses": {
  4887. "200": {
  4888. "$ref": "#/responses/GPGKeyList"
  4889. }
  4890. }
  4891. },
  4892. "post": {
  4893. "consumes": [
  4894. "application/json"
  4895. ],
  4896. "produces": [
  4897. "application/json"
  4898. ],
  4899. "tags": [
  4900. "user"
  4901. ],
  4902. "summary": "Create a GPG key",
  4903. "operationId": "userCurrentPostGPGKey",
  4904. "parameters": [
  4905. {
  4906. "name": "Form",
  4907. "in": "body",
  4908. "schema": {
  4909. "$ref": "#/definitions/CreateGPGKeyOption"
  4910. }
  4911. }
  4912. ],
  4913. "responses": {
  4914. "201": {
  4915. "$ref": "#/responses/GPGKey"
  4916. },
  4917. "422": {
  4918. "$ref": "#/responses/validationError"
  4919. }
  4920. }
  4921. }
  4922. },
  4923. "/user/gpg_keys/{id}": {
  4924. "get": {
  4925. "produces": [
  4926. "application/json"
  4927. ],
  4928. "tags": [
  4929. "user"
  4930. ],
  4931. "summary": "Get a GPG key",
  4932. "operationId": "userCurrentGetGPGKey",
  4933. "parameters": [
  4934. {
  4935. "type": "integer",
  4936. "format": "int64",
  4937. "description": "id of key to get",
  4938. "name": "id",
  4939. "in": "path",
  4940. "required": true
  4941. }
  4942. ],
  4943. "responses": {
  4944. "200": {
  4945. "$ref": "#/responses/GPGKey"
  4946. },
  4947. "404": {
  4948. "$ref": "#/responses/notFound"
  4949. }
  4950. }
  4951. },
  4952. "delete": {
  4953. "produces": [
  4954. "application/json"
  4955. ],
  4956. "tags": [
  4957. "user"
  4958. ],
  4959. "summary": "Remove a GPG key",
  4960. "operationId": "userCurrentDeleteGPGKey",
  4961. "parameters": [
  4962. {
  4963. "type": "integer",
  4964. "format": "int64",
  4965. "description": "id of key to delete",
  4966. "name": "id",
  4967. "in": "path",
  4968. "required": true
  4969. }
  4970. ],
  4971. "responses": {
  4972. "204": {
  4973. "$ref": "#/responses/empty"
  4974. },
  4975. "403": {
  4976. "$ref": "#/responses/forbidden"
  4977. }
  4978. }
  4979. }
  4980. },
  4981. "/user/keys": {
  4982. "get": {
  4983. "produces": [
  4984. "application/json"
  4985. ],
  4986. "tags": [
  4987. "user"
  4988. ],
  4989. "summary": "List the authenticated user's public keys",
  4990. "operationId": "userCurrentListKeys",
  4991. "parameters": [
  4992. {
  4993. "type": "string",
  4994. "description": "fingerprint of the key",
  4995. "name": "fingerprint",
  4996. "in": "query"
  4997. }
  4998. ],
  4999. "responses": {
  5000. "200": {
  5001. "$ref": "#/responses/PublicKeyList"
  5002. }
  5003. }
  5004. },
  5005. "post": {
  5006. "consumes": [
  5007. "application/json"
  5008. ],
  5009. "produces": [
  5010. "application/json"
  5011. ],
  5012. "tags": [
  5013. "user"
  5014. ],
  5015. "summary": "Create a public key",
  5016. "operationId": "userCurrentPostKey",
  5017. "parameters": [
  5018. {
  5019. "name": "body",
  5020. "in": "body",
  5021. "schema": {
  5022. "$ref": "#/definitions/CreateKeyOption"
  5023. }
  5024. }
  5025. ],
  5026. "responses": {
  5027. "201": {
  5028. "$ref": "#/responses/PublicKey"
  5029. },
  5030. "422": {
  5031. "$ref": "#/responses/validationError"
  5032. }
  5033. }
  5034. }
  5035. },
  5036. "/user/keys/{id}": {
  5037. "get": {
  5038. "produces": [
  5039. "application/json"
  5040. ],
  5041. "tags": [
  5042. "user"
  5043. ],
  5044. "summary": "Get a public key",
  5045. "operationId": "userCurrentGetKey",
  5046. "parameters": [
  5047. {
  5048. "type": "integer",
  5049. "format": "int64",
  5050. "description": "id of key to get",
  5051. "name": "id",
  5052. "in": "path",
  5053. "required": true
  5054. }
  5055. ],
  5056. "responses": {
  5057. "200": {
  5058. "$ref": "#/responses/PublicKey"
  5059. },
  5060. "404": {
  5061. "$ref": "#/responses/notFound"
  5062. }
  5063. }
  5064. },
  5065. "delete": {
  5066. "produces": [
  5067. "application/json"
  5068. ],
  5069. "tags": [
  5070. "user"
  5071. ],
  5072. "summary": "Delete a public key",
  5073. "operationId": "userCurrentDeleteKey",
  5074. "parameters": [
  5075. {
  5076. "type": "integer",
  5077. "format": "int64",
  5078. "description": "id of key to delete",
  5079. "name": "id",
  5080. "in": "path",
  5081. "required": true
  5082. }
  5083. ],
  5084. "responses": {
  5085. "204": {
  5086. "$ref": "#/responses/empty"
  5087. },
  5088. "403": {
  5089. "$ref": "#/responses/forbidden"
  5090. },
  5091. "404": {
  5092. "$ref": "#/responses/notFound"
  5093. }
  5094. }
  5095. }
  5096. },
  5097. "/user/orgs": {
  5098. "get": {
  5099. "produces": [
  5100. "application/json"
  5101. ],
  5102. "tags": [
  5103. "organization"
  5104. ],
  5105. "summary": "List the current user's organizations",
  5106. "operationId": "orgListCurrentUserOrgs",
  5107. "responses": {
  5108. "200": {
  5109. "$ref": "#/responses/OrganizationList"
  5110. }
  5111. }
  5112. }
  5113. },
  5114. "/user/repos": {
  5115. "get": {
  5116. "produces": [
  5117. "application/json"
  5118. ],
  5119. "tags": [
  5120. "user"
  5121. ],
  5122. "summary": "List the repos that the authenticated user owns or has access to",
  5123. "operationId": "userCurrentListRepos",
  5124. "responses": {
  5125. "200": {
  5126. "$ref": "#/responses/RepositoryList"
  5127. }
  5128. }
  5129. },
  5130. "post": {
  5131. "consumes": [
  5132. "application/json"
  5133. ],
  5134. "produces": [
  5135. "application/json"
  5136. ],
  5137. "tags": [
  5138. "repository",
  5139. "user"
  5140. ],
  5141. "summary": "Create a repository",
  5142. "operationId": "createCurrentUserRepo",
  5143. "parameters": [
  5144. {
  5145. "name": "body",
  5146. "in": "body",
  5147. "schema": {
  5148. "$ref": "#/definitions/CreateRepoOption"
  5149. }
  5150. }
  5151. ],
  5152. "responses": {
  5153. "201": {
  5154. "$ref": "#/responses/Repository"
  5155. }
  5156. }
  5157. }
  5158. },
  5159. "/user/starred": {
  5160. "get": {
  5161. "produces": [
  5162. "application/json"
  5163. ],
  5164. "tags": [
  5165. "user"
  5166. ],
  5167. "summary": "The repos that the authenticated user has starred",
  5168. "operationId": "userCurrentListStarred",
  5169. "responses": {
  5170. "200": {
  5171. "$ref": "#/responses/RepositoryList"
  5172. }
  5173. }
  5174. }
  5175. },
  5176. "/user/starred/{owner}/{repo}": {
  5177. "get": {
  5178. "tags": [
  5179. "user"
  5180. ],
  5181. "summary": "Whether the authenticated is starring the repo",
  5182. "operationId": "userCurrentCheckStarring",
  5183. "parameters": [
  5184. {
  5185. "type": "string",
  5186. "description": "owner of the repo",
  5187. "name": "owner",
  5188. "in": "path",
  5189. "required": true
  5190. },
  5191. {
  5192. "type": "string",
  5193. "description": "name of the repo",
  5194. "name": "repo",
  5195. "in": "path",
  5196. "required": true
  5197. }
  5198. ],
  5199. "responses": {
  5200. "204": {
  5201. "$ref": "#/responses/empty"
  5202. },
  5203. "404": {
  5204. "$ref": "#/responses/notFound"
  5205. }
  5206. }
  5207. },
  5208. "put": {
  5209. "tags": [
  5210. "user"
  5211. ],
  5212. "summary": "Star the given repo",
  5213. "operationId": "userCurrentPutStar",
  5214. "parameters": [
  5215. {
  5216. "type": "string",
  5217. "description": "owner of the repo to star",
  5218. "name": "owner",
  5219. "in": "path",
  5220. "required": true
  5221. },
  5222. {
  5223. "type": "string",
  5224. "description": "name of the repo to star",
  5225. "name": "repo",
  5226. "in": "path",
  5227. "required": true
  5228. }
  5229. ],
  5230. "responses": {
  5231. "204": {
  5232. "$ref": "#/responses/empty"
  5233. }
  5234. }
  5235. },
  5236. "delete": {
  5237. "tags": [
  5238. "user"
  5239. ],
  5240. "summary": "Unstar the given repo",
  5241. "operationId": "userCurrentDeleteStar",
  5242. "parameters": [
  5243. {
  5244. "type": "string",
  5245. "description": "owner of the repo to unstar",
  5246. "name": "owner",
  5247. "in": "path",
  5248. "required": true
  5249. },
  5250. {
  5251. "type": "string",
  5252. "description": "name of the repo to unstar",
  5253. "name": "repo",
  5254. "in": "path",
  5255. "required": true
  5256. }
  5257. ],
  5258. "responses": {
  5259. "204": {
  5260. "$ref": "#/responses/empty"
  5261. }
  5262. }
  5263. }
  5264. },
  5265. "/user/subscriptions": {
  5266. "get": {
  5267. "produces": [
  5268. "application/json"
  5269. ],
  5270. "tags": [
  5271. "user"
  5272. ],
  5273. "summary": "List repositories watched by the authenticated user",
  5274. "operationId": "userCurrentListSubscriptions",
  5275. "responses": {
  5276. "200": {
  5277. "$ref": "#/responses/RepositoryList"
  5278. }
  5279. }
  5280. }
  5281. },
  5282. "/user/times": {
  5283. "get": {
  5284. "produces": [
  5285. "application/json"
  5286. ],
  5287. "tags": [
  5288. "user"
  5289. ],
  5290. "summary": "List the current user's tracked times",
  5291. "operationId": "userCurrentTrackedTimes",
  5292. "responses": {
  5293. "200": {
  5294. "$ref": "#/responses/TrackedTimeList"
  5295. }
  5296. }
  5297. }
  5298. },
  5299. "/user/{username}/orgs": {
  5300. "get": {
  5301. "produces": [
  5302. "application/json"
  5303. ],
  5304. "tags": [
  5305. "organization"
  5306. ],
  5307. "summary": "List a user's organizations",
  5308. "operationId": "orgListUserOrgs",
  5309. "parameters": [
  5310. {
  5311. "type": "string",
  5312. "description": "username of user",
  5313. "name": "username",
  5314. "in": "path",
  5315. "required": true
  5316. }
  5317. ],
  5318. "responses": {
  5319. "200": {
  5320. "$ref": "#/responses/OrganizationList"
  5321. }
  5322. }
  5323. }
  5324. },
  5325. "/users/search": {
  5326. "get": {
  5327. "produces": [
  5328. "application/json"
  5329. ],
  5330. "tags": [
  5331. "user"
  5332. ],
  5333. "summary": "Search for users",
  5334. "operationId": "userSearch",
  5335. "parameters": [
  5336. {
  5337. "type": "string",
  5338. "description": "keyword",
  5339. "name": "q",
  5340. "in": "query"
  5341. },
  5342. {
  5343. "type": "integer",
  5344. "format": "int64",
  5345. "description": "ID of the user to search for",
  5346. "name": "uid",
  5347. "in": "query"
  5348. },
  5349. {
  5350. "type": "integer",
  5351. "description": "maximum number of users to return",
  5352. "name": "limit",
  5353. "in": "query"
  5354. }
  5355. ],
  5356. "responses": {
  5357. "200": {
  5358. "description": "SearchResults of a successful search",
  5359. "schema": {
  5360. "type": "object",
  5361. "properties": {
  5362. "data": {
  5363. "type": "array",
  5364. "items": {
  5365. "$ref": "#/definitions/User"
  5366. }
  5367. },
  5368. "ok": {
  5369. "type": "boolean"
  5370. }
  5371. }
  5372. }
  5373. }
  5374. }
  5375. }
  5376. },
  5377. "/users/{follower}/following/{followee}": {
  5378. "get": {
  5379. "tags": [
  5380. "user"
  5381. ],
  5382. "summary": "Check if one user is following another user",
  5383. "operationId": "userCheckFollowing",
  5384. "parameters": [
  5385. {
  5386. "type": "string",
  5387. "description": "username of following user",
  5388. "name": "follower",
  5389. "in": "path",
  5390. "required": true
  5391. },
  5392. {
  5393. "type": "string",
  5394. "description": "username of followed user",
  5395. "name": "followee",
  5396. "in": "path",
  5397. "required": true
  5398. }
  5399. ],
  5400. "responses": {
  5401. "204": {
  5402. "$ref": "#/responses/empty"
  5403. },
  5404. "404": {
  5405. "$ref": "#/responses/notFound"
  5406. }
  5407. }
  5408. }
  5409. },
  5410. "/users/{username}": {
  5411. "get": {
  5412. "produces": [
  5413. "application/json"
  5414. ],
  5415. "tags": [
  5416. "user"
  5417. ],
  5418. "summary": "Get a user",
  5419. "operationId": "userGet",
  5420. "parameters": [
  5421. {
  5422. "type": "string",
  5423. "description": "username of user to get",
  5424. "name": "username",
  5425. "in": "path",
  5426. "required": true
  5427. }
  5428. ],
  5429. "responses": {
  5430. "200": {
  5431. "$ref": "#/responses/User"
  5432. },
  5433. "404": {
  5434. "$ref": "#/responses/notFound"
  5435. }
  5436. }
  5437. }
  5438. },
  5439. "/users/{username}/followers": {
  5440. "get": {
  5441. "produces": [
  5442. "application/json"
  5443. ],
  5444. "tags": [
  5445. "user"
  5446. ],
  5447. "summary": "List the given user's followers",
  5448. "operationId": "userListFollowers",
  5449. "parameters": [
  5450. {
  5451. "type": "string",
  5452. "description": "username of user",
  5453. "name": "username",
  5454. "in": "path",
  5455. "required": true
  5456. }
  5457. ],
  5458. "responses": {
  5459. "200": {
  5460. "$ref": "#/responses/UserList"
  5461. }
  5462. }
  5463. }
  5464. },
  5465. "/users/{username}/following": {
  5466. "get": {
  5467. "produces": [
  5468. "application/json"
  5469. ],
  5470. "tags": [
  5471. "user"
  5472. ],
  5473. "summary": "List the users that the given user is following",
  5474. "operationId": "userListFollowing",
  5475. "parameters": [
  5476. {
  5477. "type": "string",
  5478. "description": "username of user",
  5479. "name": "username",
  5480. "in": "path",
  5481. "required": true
  5482. }
  5483. ],
  5484. "responses": {
  5485. "200": {
  5486. "$ref": "#/responses/UserList"
  5487. }
  5488. }
  5489. }
  5490. },
  5491. "/users/{username}/gpg_keys": {
  5492. "get": {
  5493. "produces": [
  5494. "application/json"
  5495. ],
  5496. "tags": [
  5497. "user"
  5498. ],
  5499. "summary": "List the given user's GPG keys",
  5500. "operationId": "userListGPGKeys",
  5501. "parameters": [
  5502. {
  5503. "type": "string",
  5504. "description": "username of user",
  5505. "name": "username",
  5506. "in": "path",
  5507. "required": true
  5508. }
  5509. ],
  5510. "responses": {
  5511. "200": {
  5512. "$ref": "#/responses/GPGKeyList"
  5513. }
  5514. }
  5515. }
  5516. },
  5517. "/users/{username}/heatmap": {
  5518. "get": {
  5519. "produces": [
  5520. "application/json"
  5521. ],
  5522. "tags": [
  5523. "user"
  5524. ],
  5525. "summary": "Get a user's heatmap",
  5526. "operationId": "userGetHeatmapData",
  5527. "parameters": [
  5528. {
  5529. "type": "string",
  5530. "description": "username of user to get",
  5531. "name": "username",
  5532. "in": "path",
  5533. "required": true
  5534. }
  5535. ],
  5536. "responses": {
  5537. "200": {
  5538. "$ref": "#/responses/UserHeatmapData"
  5539. },
  5540. "404": {
  5541. "$ref": "#/responses/notFound"
  5542. }
  5543. }
  5544. }
  5545. },
  5546. "/users/{username}/keys": {
  5547. "get": {
  5548. "produces": [
  5549. "application/json"
  5550. ],
  5551. "tags": [
  5552. "user"
  5553. ],
  5554. "summary": "List the given user's public keys",
  5555. "operationId": "userListKeys",
  5556. "parameters": [
  5557. {
  5558. "type": "string",
  5559. "description": "username of user",
  5560. "name": "username",
  5561. "in": "path",
  5562. "required": true
  5563. },
  5564. {
  5565. "type": "string",
  5566. "description": "fingerprint of the key",
  5567. "name": "fingerprint",
  5568. "in": "query"
  5569. }
  5570. ],
  5571. "responses": {
  5572. "200": {
  5573. "$ref": "#/responses/PublicKeyList"
  5574. }
  5575. }
  5576. }
  5577. },
  5578. "/users/{username}/repos": {
  5579. "get": {
  5580. "produces": [
  5581. "application/json"
  5582. ],
  5583. "tags": [
  5584. "user"
  5585. ],
  5586. "summary": "List the repos owned by the given user",
  5587. "operationId": "userListRepos",
  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}/starred": {
  5605. "get": {
  5606. "produces": [
  5607. "application/json"
  5608. ],
  5609. "tags": [
  5610. "user"
  5611. ],
  5612. "summary": "The repos that the given user has starred",
  5613. "operationId": "userListStarred",
  5614. "parameters": [
  5615. {
  5616. "type": "string",
  5617. "description": "username of 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}/subscriptions": {
  5631. "get": {
  5632. "produces": [
  5633. "application/json"
  5634. ],
  5635. "tags": [
  5636. "user"
  5637. ],
  5638. "summary": "List the repositories watched by a user",
  5639. "operationId": "userListSubscriptions",
  5640. "parameters": [
  5641. {
  5642. "type": "string",
  5643. "description": "username of the user",
  5644. "name": "username",
  5645. "in": "path",
  5646. "required": true
  5647. }
  5648. ],
  5649. "responses": {
  5650. "200": {
  5651. "$ref": "#/responses/RepositoryList"
  5652. }
  5653. }
  5654. }
  5655. },
  5656. "/users/{username}/tokens": {
  5657. "get": {
  5658. "produces": [
  5659. "application/json"
  5660. ],
  5661. "tags": [
  5662. "user"
  5663. ],
  5664. "summary": "List the authenticated user's access tokens",
  5665. "operationId": "userGetTokens",
  5666. "parameters": [
  5667. {
  5668. "type": "string",
  5669. "description": "username of user",
  5670. "name": "username",
  5671. "in": "path",
  5672. "required": true
  5673. }
  5674. ],
  5675. "responses": {
  5676. "200": {
  5677. "$ref": "#/responses/AccessTokenList"
  5678. }
  5679. }
  5680. },
  5681. "post": {
  5682. "consumes": [
  5683. "application/json"
  5684. ],
  5685. "produces": [
  5686. "application/json"
  5687. ],
  5688. "tags": [
  5689. "user"
  5690. ],
  5691. "summary": "Create an access token",
  5692. "operationId": "userCreateToken",
  5693. "parameters": [
  5694. {
  5695. "type": "string",
  5696. "x-go-name": "Name",
  5697. "description": "username of user",
  5698. "name": "username",
  5699. "in": "path",
  5700. "required": true
  5701. },
  5702. {
  5703. "name": "accessToken",
  5704. "in": "body",
  5705. "schema": {
  5706. "type": "object",
  5707. "required": [
  5708. "name"
  5709. ],
  5710. "properties": {
  5711. "name": {
  5712. "type": "string"
  5713. }
  5714. }
  5715. }
  5716. }
  5717. ],
  5718. "responses": {
  5719. "200": {
  5720. "$ref": "#/responses/AccessToken"
  5721. }
  5722. }
  5723. }
  5724. },
  5725. "/users/{username}/tokens/{token}": {
  5726. "delete": {
  5727. "produces": [
  5728. "application/json"
  5729. ],
  5730. "tags": [
  5731. "user"
  5732. ],
  5733. "summary": "delete an access token",
  5734. "operationId": "userDeleteAccessToken",
  5735. "parameters": [
  5736. {
  5737. "type": "string",
  5738. "description": "username of user",
  5739. "name": "username",
  5740. "in": "path",
  5741. "required": true
  5742. },
  5743. {
  5744. "type": "integer",
  5745. "format": "int64",
  5746. "description": "token to be deleted",
  5747. "name": "token",
  5748. "in": "path",
  5749. "required": true
  5750. }
  5751. ],
  5752. "responses": {
  5753. "204": {
  5754. "$ref": "#/responses/empty"
  5755. }
  5756. }
  5757. }
  5758. },
  5759. "/version": {
  5760. "get": {
  5761. "produces": [
  5762. "application/json"
  5763. ],
  5764. "tags": [
  5765. "miscellaneous"
  5766. ],
  5767. "summary": "Returns the version of the Gitea application",
  5768. "operationId": "getVersion",
  5769. "responses": {
  5770. "200": {
  5771. "$ref": "#/responses/ServerVersion"
  5772. }
  5773. }
  5774. }
  5775. }
  5776. },
  5777. "definitions": {
  5778. "AddCollaboratorOption": {
  5779. "description": "AddCollaboratorOption options when adding a user as a collaborator of a repository",
  5780. "type": "object",
  5781. "properties": {
  5782. "permission": {
  5783. "type": "string",
  5784. "x-go-name": "Permission"
  5785. }
  5786. },
  5787. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5788. },
  5789. "AddTimeOption": {
  5790. "description": "AddTimeOption options for adding time to an issue",
  5791. "type": "object",
  5792. "required": [
  5793. "time"
  5794. ],
  5795. "properties": {
  5796. "time": {
  5797. "description": "time in seconds",
  5798. "type": "integer",
  5799. "format": "int64",
  5800. "x-go-name": "Time"
  5801. }
  5802. },
  5803. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5804. },
  5805. "Attachment": {
  5806. "description": "Attachment a generic attachment",
  5807. "type": "object",
  5808. "properties": {
  5809. "browser_download_url": {
  5810. "type": "string",
  5811. "x-go-name": "DownloadURL"
  5812. },
  5813. "created_at": {
  5814. "type": "string",
  5815. "format": "date-time",
  5816. "x-go-name": "Created"
  5817. },
  5818. "download_count": {
  5819. "type": "integer",
  5820. "format": "int64",
  5821. "x-go-name": "DownloadCount"
  5822. },
  5823. "id": {
  5824. "type": "integer",
  5825. "format": "int64",
  5826. "x-go-name": "ID"
  5827. },
  5828. "name": {
  5829. "type": "string",
  5830. "x-go-name": "Name"
  5831. },
  5832. "size": {
  5833. "type": "integer",
  5834. "format": "int64",
  5835. "x-go-name": "Size"
  5836. },
  5837. "uuid": {
  5838. "type": "string",
  5839. "x-go-name": "UUID"
  5840. }
  5841. },
  5842. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5843. },
  5844. "Branch": {
  5845. "description": "Branch represents a repository branch",
  5846. "type": "object",
  5847. "properties": {
  5848. "commit": {
  5849. "$ref": "#/definitions/PayloadCommit"
  5850. },
  5851. "name": {
  5852. "type": "string",
  5853. "x-go-name": "Name"
  5854. }
  5855. },
  5856. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5857. },
  5858. "Comment": {
  5859. "description": "Comment represents a comment on a commit or issue",
  5860. "type": "object",
  5861. "properties": {
  5862. "body": {
  5863. "type": "string",
  5864. "x-go-name": "Body"
  5865. },
  5866. "created_at": {
  5867. "type": "string",
  5868. "format": "date-time",
  5869. "x-go-name": "Created"
  5870. },
  5871. "html_url": {
  5872. "type": "string",
  5873. "x-go-name": "HTMLURL"
  5874. },
  5875. "id": {
  5876. "type": "integer",
  5877. "format": "int64",
  5878. "x-go-name": "ID"
  5879. },
  5880. "issue_url": {
  5881. "type": "string",
  5882. "x-go-name": "IssueURL"
  5883. },
  5884. "pull_request_url": {
  5885. "type": "string",
  5886. "x-go-name": "PRURL"
  5887. },
  5888. "updated_at": {
  5889. "type": "string",
  5890. "format": "date-time",
  5891. "x-go-name": "Updated"
  5892. },
  5893. "user": {
  5894. "$ref": "#/definitions/User"
  5895. }
  5896. },
  5897. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5898. },
  5899. "CreateEmailOption": {
  5900. "description": "CreateEmailOption options when creating email addresses",
  5901. "type": "object",
  5902. "properties": {
  5903. "emails": {
  5904. "description": "email addresses to add",
  5905. "type": "array",
  5906. "items": {
  5907. "type": "string"
  5908. },
  5909. "x-go-name": "Emails"
  5910. }
  5911. },
  5912. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5913. },
  5914. "CreateForkOption": {
  5915. "description": "CreateForkOption options for creating a fork",
  5916. "type": "object",
  5917. "properties": {
  5918. "organization": {
  5919. "description": "organization name, if forking into an organization",
  5920. "type": "string",
  5921. "x-go-name": "Organization"
  5922. }
  5923. },
  5924. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5925. },
  5926. "CreateGPGKeyOption": {
  5927. "description": "CreateGPGKeyOption options create user GPG key",
  5928. "type": "object",
  5929. "required": [
  5930. "armored_public_key"
  5931. ],
  5932. "properties": {
  5933. "armored_public_key": {
  5934. "description": "An armored GPG key to add",
  5935. "type": "string",
  5936. "uniqueItems": true,
  5937. "x-go-name": "ArmoredKey"
  5938. }
  5939. },
  5940. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5941. },
  5942. "CreateHookOption": {
  5943. "description": "CreateHookOption options when create a hook",
  5944. "type": "object",
  5945. "required": [
  5946. "type",
  5947. "config"
  5948. ],
  5949. "properties": {
  5950. "active": {
  5951. "type": "boolean",
  5952. "default": false,
  5953. "x-go-name": "Active"
  5954. },
  5955. "config": {
  5956. "type": "object",
  5957. "additionalProperties": {
  5958. "type": "string"
  5959. },
  5960. "x-go-name": "Config"
  5961. },
  5962. "events": {
  5963. "type": "array",
  5964. "items": {
  5965. "type": "string"
  5966. },
  5967. "x-go-name": "Events"
  5968. },
  5969. "type": {
  5970. "type": "string",
  5971. "enum": [
  5972. "gitea",
  5973. "gogs",
  5974. "slack",
  5975. "discord"
  5976. ],
  5977. "x-go-name": "Type"
  5978. }
  5979. },
  5980. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5981. },
  5982. "CreateIssueCommentOption": {
  5983. "description": "CreateIssueCommentOption options for creating a comment on an issue",
  5984. "type": "object",
  5985. "required": [
  5986. "body"
  5987. ],
  5988. "properties": {
  5989. "body": {
  5990. "type": "string",
  5991. "x-go-name": "Body"
  5992. }
  5993. },
  5994. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  5995. },
  5996. "CreateIssueOption": {
  5997. "description": "CreateIssueOption options to create one issue",
  5998. "type": "object",
  5999. "required": [
  6000. "title"
  6001. ],
  6002. "properties": {
  6003. "assignee": {
  6004. "description": "username of assignee",
  6005. "type": "string",
  6006. "x-go-name": "Assignee"
  6007. },
  6008. "assignees": {
  6009. "type": "array",
  6010. "items": {
  6011. "type": "string"
  6012. },
  6013. "x-go-name": "Assignees"
  6014. },
  6015. "body": {
  6016. "type": "string",
  6017. "x-go-name": "Body"
  6018. },
  6019. "closed": {
  6020. "type": "boolean",
  6021. "x-go-name": "Closed"
  6022. },
  6023. "due_date": {
  6024. "type": "string",
  6025. "format": "date-time",
  6026. "x-go-name": "Deadline"
  6027. },
  6028. "labels": {
  6029. "description": "list of label ids",
  6030. "type": "array",
  6031. "items": {
  6032. "type": "integer",
  6033. "format": "int64"
  6034. },
  6035. "x-go-name": "Labels"
  6036. },
  6037. "milestone": {
  6038. "description": "milestone id",
  6039. "type": "integer",
  6040. "format": "int64",
  6041. "x-go-name": "Milestone"
  6042. },
  6043. "title": {
  6044. "type": "string",
  6045. "x-go-name": "Title"
  6046. }
  6047. },
  6048. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6049. },
  6050. "CreateKeyOption": {
  6051. "description": "CreateKeyOption options when creating a key",
  6052. "type": "object",
  6053. "required": [
  6054. "title",
  6055. "key"
  6056. ],
  6057. "properties": {
  6058. "key": {
  6059. "description": "An armored SSH key to add",
  6060. "type": "string",
  6061. "uniqueItems": true,
  6062. "x-go-name": "Key"
  6063. },
  6064. "read_only": {
  6065. "description": "Describe if the key has only read access or read/write",
  6066. "type": "boolean",
  6067. "x-go-name": "ReadOnly"
  6068. },
  6069. "title": {
  6070. "description": "Title of the key to add",
  6071. "type": "string",
  6072. "uniqueItems": true,
  6073. "x-go-name": "Title"
  6074. }
  6075. },
  6076. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6077. },
  6078. "CreateLabelOption": {
  6079. "description": "CreateLabelOption options for creating a label",
  6080. "type": "object",
  6081. "required": [
  6082. "name",
  6083. "color"
  6084. ],
  6085. "properties": {
  6086. "color": {
  6087. "type": "string",
  6088. "x-go-name": "Color",
  6089. "example": "#00aabb"
  6090. },
  6091. "name": {
  6092. "type": "string",
  6093. "x-go-name": "Name"
  6094. }
  6095. },
  6096. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6097. },
  6098. "CreateMilestoneOption": {
  6099. "description": "CreateMilestoneOption options for creating a milestone",
  6100. "type": "object",
  6101. "properties": {
  6102. "description": {
  6103. "type": "string",
  6104. "x-go-name": "Description"
  6105. },
  6106. "due_on": {
  6107. "type": "string",
  6108. "format": "date-time",
  6109. "x-go-name": "Deadline"
  6110. },
  6111. "title": {
  6112. "type": "string",
  6113. "x-go-name": "Title"
  6114. }
  6115. },
  6116. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6117. },
  6118. "CreateOrgOption": {
  6119. "description": "CreateOrgOption options for creating an organization",
  6120. "type": "object",
  6121. "required": [
  6122. "username"
  6123. ],
  6124. "properties": {
  6125. "description": {
  6126. "type": "string",
  6127. "x-go-name": "Description"
  6128. },
  6129. "full_name": {
  6130. "type": "string",
  6131. "x-go-name": "FullName"
  6132. },
  6133. "location": {
  6134. "type": "string",
  6135. "x-go-name": "Location"
  6136. },
  6137. "username": {
  6138. "type": "string",
  6139. "x-go-name": "UserName"
  6140. },
  6141. "website": {
  6142. "type": "string",
  6143. "x-go-name": "Website"
  6144. }
  6145. },
  6146. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6147. },
  6148. "CreatePullRequestOption": {
  6149. "description": "CreatePullRequestOption options when creating a pull request",
  6150. "type": "object",
  6151. "properties": {
  6152. "assignee": {
  6153. "type": "string",
  6154. "x-go-name": "Assignee"
  6155. },
  6156. "assignees": {
  6157. "type": "array",
  6158. "items": {
  6159. "type": "string"
  6160. },
  6161. "x-go-name": "Assignees"
  6162. },
  6163. "base": {
  6164. "type": "string",
  6165. "x-go-name": "Base"
  6166. },
  6167. "body": {
  6168. "type": "string",
  6169. "x-go-name": "Body"
  6170. },
  6171. "due_date": {
  6172. "type": "string",
  6173. "format": "date-time",
  6174. "x-go-name": "Deadline"
  6175. },
  6176. "head": {
  6177. "type": "string",
  6178. "x-go-name": "Head"
  6179. },
  6180. "labels": {
  6181. "type": "array",
  6182. "items": {
  6183. "type": "integer",
  6184. "format": "int64"
  6185. },
  6186. "x-go-name": "Labels"
  6187. },
  6188. "milestone": {
  6189. "type": "integer",
  6190. "format": "int64",
  6191. "x-go-name": "Milestone"
  6192. },
  6193. "title": {
  6194. "type": "string",
  6195. "x-go-name": "Title"
  6196. }
  6197. },
  6198. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6199. },
  6200. "CreateReleaseOption": {
  6201. "description": "CreateReleaseOption options when creating a release",
  6202. "type": "object",
  6203. "required": [
  6204. "tag_name"
  6205. ],
  6206. "properties": {
  6207. "body": {
  6208. "type": "string",
  6209. "x-go-name": "Note"
  6210. },
  6211. "draft": {
  6212. "type": "boolean",
  6213. "x-go-name": "IsDraft"
  6214. },
  6215. "name": {
  6216. "type": "string",
  6217. "x-go-name": "Title"
  6218. },
  6219. "prerelease": {
  6220. "type": "boolean",
  6221. "x-go-name": "IsPrerelease"
  6222. },
  6223. "tag_name": {
  6224. "type": "string",
  6225. "x-go-name": "TagName"
  6226. },
  6227. "target_commitish": {
  6228. "type": "string",
  6229. "x-go-name": "Target"
  6230. }
  6231. },
  6232. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6233. },
  6234. "CreateRepoOption": {
  6235. "description": "CreateRepoOption options when creating repository",
  6236. "type": "object",
  6237. "required": [
  6238. "name"
  6239. ],
  6240. "properties": {
  6241. "auto_init": {
  6242. "description": "Whether the repository should be auto-intialized?",
  6243. "type": "boolean",
  6244. "x-go-name": "AutoInit"
  6245. },
  6246. "description": {
  6247. "description": "Description of the repository to create",
  6248. "type": "string",
  6249. "x-go-name": "Description"
  6250. },
  6251. "gitignores": {
  6252. "description": "Gitignores to use",
  6253. "type": "string",
  6254. "x-go-name": "Gitignores"
  6255. },
  6256. "license": {
  6257. "description": "License to use",
  6258. "type": "string",
  6259. "x-go-name": "License"
  6260. },
  6261. "name": {
  6262. "description": "Name of the repository to create",
  6263. "type": "string",
  6264. "uniqueItems": true,
  6265. "x-go-name": "Name"
  6266. },
  6267. "private": {
  6268. "description": "Whether the repository is private",
  6269. "type": "boolean",
  6270. "x-go-name": "Private"
  6271. },
  6272. "readme": {
  6273. "description": "Readme of the repository to create",
  6274. "type": "string",
  6275. "x-go-name": "Readme"
  6276. }
  6277. },
  6278. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6279. },
  6280. "CreateStatusOption": {
  6281. "description": "CreateStatusOption holds the information needed to create a new Status for a Commit",
  6282. "type": "object",
  6283. "properties": {
  6284. "context": {
  6285. "type": "string",
  6286. "x-go-name": "Context"
  6287. },
  6288. "description": {
  6289. "type": "string",
  6290. "x-go-name": "Description"
  6291. },
  6292. "state": {
  6293. "$ref": "#/definitions/StatusState"
  6294. },
  6295. "target_url": {
  6296. "type": "string",
  6297. "x-go-name": "TargetURL"
  6298. }
  6299. },
  6300. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6301. },
  6302. "CreateTeamOption": {
  6303. "description": "CreateTeamOption options for creating a team",
  6304. "type": "object",
  6305. "required": [
  6306. "name"
  6307. ],
  6308. "properties": {
  6309. "description": {
  6310. "type": "string",
  6311. "x-go-name": "Description"
  6312. },
  6313. "name": {
  6314. "type": "string",
  6315. "x-go-name": "Name"
  6316. },
  6317. "permission": {
  6318. "type": "string",
  6319. "enum": [
  6320. "read",
  6321. "write",
  6322. "admin"
  6323. ],
  6324. "x-go-name": "Permission"
  6325. }
  6326. },
  6327. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6328. },
  6329. "CreateUserOption": {
  6330. "description": "CreateUserOption create user options",
  6331. "type": "object",
  6332. "required": [
  6333. "username",
  6334. "email",
  6335. "password"
  6336. ],
  6337. "properties": {
  6338. "email": {
  6339. "type": "string",
  6340. "format": "email",
  6341. "x-go-name": "Email"
  6342. },
  6343. "full_name": {
  6344. "type": "string",
  6345. "x-go-name": "FullName"
  6346. },
  6347. "login_name": {
  6348. "type": "string",
  6349. "x-go-name": "LoginName"
  6350. },
  6351. "password": {
  6352. "type": "string",
  6353. "x-go-name": "Password"
  6354. },
  6355. "send_notify": {
  6356. "type": "boolean",
  6357. "x-go-name": "SendNotify"
  6358. },
  6359. "source_id": {
  6360. "type": "integer",
  6361. "format": "int64",
  6362. "x-go-name": "SourceID"
  6363. },
  6364. "username": {
  6365. "type": "string",
  6366. "x-go-name": "Username"
  6367. }
  6368. },
  6369. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6370. },
  6371. "DeleteEmailOption": {
  6372. "description": "DeleteEmailOption options when deleting email addresses",
  6373. "type": "object",
  6374. "properties": {
  6375. "emails": {
  6376. "description": "email addresses to delete",
  6377. "type": "array",
  6378. "items": {
  6379. "type": "string"
  6380. },
  6381. "x-go-name": "Emails"
  6382. }
  6383. },
  6384. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6385. },
  6386. "DeployKey": {
  6387. "description": "DeployKey a deploy key",
  6388. "type": "object",
  6389. "properties": {
  6390. "created_at": {
  6391. "type": "string",
  6392. "format": "date-time",
  6393. "x-go-name": "Created"
  6394. },
  6395. "fingerprint": {
  6396. "type": "string",
  6397. "x-go-name": "Fingerprint"
  6398. },
  6399. "id": {
  6400. "type": "integer",
  6401. "format": "int64",
  6402. "x-go-name": "ID"
  6403. },
  6404. "key": {
  6405. "type": "string",
  6406. "x-go-name": "Key"
  6407. },
  6408. "key_id": {
  6409. "type": "integer",
  6410. "format": "int64",
  6411. "x-go-name": "KeyID"
  6412. },
  6413. "read_only": {
  6414. "type": "boolean",
  6415. "x-go-name": "ReadOnly"
  6416. },
  6417. "repository": {
  6418. "$ref": "#/definitions/Repository"
  6419. },
  6420. "title": {
  6421. "type": "string",
  6422. "x-go-name": "Title"
  6423. },
  6424. "url": {
  6425. "type": "string",
  6426. "x-go-name": "URL"
  6427. }
  6428. },
  6429. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6430. },
  6431. "EditAttachmentOptions": {
  6432. "description": "EditAttachmentOptions options for editing attachments",
  6433. "type": "object",
  6434. "properties": {
  6435. "name": {
  6436. "type": "string",
  6437. "x-go-name": "Name"
  6438. }
  6439. },
  6440. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6441. },
  6442. "EditDeadlineOption": {
  6443. "description": "EditDeadlineOption options for creating a deadline",
  6444. "type": "object",
  6445. "required": [
  6446. "due_date"
  6447. ],
  6448. "properties": {
  6449. "due_date": {
  6450. "type": "string",
  6451. "format": "date-time",
  6452. "x-go-name": "Deadline"
  6453. }
  6454. },
  6455. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6456. },
  6457. "EditHookOption": {
  6458. "description": "EditHookOption options when modify one hook",
  6459. "type": "object",
  6460. "properties": {
  6461. "active": {
  6462. "type": "boolean",
  6463. "x-go-name": "Active"
  6464. },
  6465. "config": {
  6466. "type": "object",
  6467. "additionalProperties": {
  6468. "type": "string"
  6469. },
  6470. "x-go-name": "Config"
  6471. },
  6472. "events": {
  6473. "type": "array",
  6474. "items": {
  6475. "type": "string"
  6476. },
  6477. "x-go-name": "Events"
  6478. }
  6479. },
  6480. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6481. },
  6482. "EditIssueCommentOption": {
  6483. "description": "EditIssueCommentOption options for editing a comment",
  6484. "type": "object",
  6485. "required": [
  6486. "body"
  6487. ],
  6488. "properties": {
  6489. "body": {
  6490. "type": "string",
  6491. "x-go-name": "Body"
  6492. }
  6493. },
  6494. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6495. },
  6496. "EditIssueOption": {
  6497. "description": "EditIssueOption options for editing an issue",
  6498. "type": "object",
  6499. "properties": {
  6500. "assignee": {
  6501. "type": "string",
  6502. "x-go-name": "Assignee"
  6503. },
  6504. "assignees": {
  6505. "type": "array",
  6506. "items": {
  6507. "type": "string"
  6508. },
  6509. "x-go-name": "Assignees"
  6510. },
  6511. "body": {
  6512. "type": "string",
  6513. "x-go-name": "Body"
  6514. },
  6515. "due_date": {
  6516. "type": "string",
  6517. "format": "date-time",
  6518. "x-go-name": "Deadline"
  6519. },
  6520. "milestone": {
  6521. "type": "integer",
  6522. "format": "int64",
  6523. "x-go-name": "Milestone"
  6524. },
  6525. "state": {
  6526. "type": "string",
  6527. "x-go-name": "State"
  6528. },
  6529. "title": {
  6530. "type": "string",
  6531. "x-go-name": "Title"
  6532. }
  6533. },
  6534. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6535. },
  6536. "EditLabelOption": {
  6537. "description": "EditLabelOption options for editing a label",
  6538. "type": "object",
  6539. "properties": {
  6540. "color": {
  6541. "type": "string",
  6542. "x-go-name": "Color"
  6543. },
  6544. "name": {
  6545. "type": "string",
  6546. "x-go-name": "Name"
  6547. }
  6548. },
  6549. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6550. },
  6551. "EditMilestoneOption": {
  6552. "description": "EditMilestoneOption options for editing a milestone",
  6553. "type": "object",
  6554. "properties": {
  6555. "description": {
  6556. "type": "string",
  6557. "x-go-name": "Description"
  6558. },
  6559. "due_on": {
  6560. "type": "string",
  6561. "format": "date-time",
  6562. "x-go-name": "Deadline"
  6563. },
  6564. "state": {
  6565. "type": "string",
  6566. "x-go-name": "State"
  6567. },
  6568. "title": {
  6569. "type": "string",
  6570. "x-go-name": "Title"
  6571. }
  6572. },
  6573. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6574. },
  6575. "EditOrgOption": {
  6576. "description": "EditOrgOption options for editing an organization",
  6577. "type": "object",
  6578. "properties": {
  6579. "description": {
  6580. "type": "string",
  6581. "x-go-name": "Description"
  6582. },
  6583. "full_name": {
  6584. "type": "string",
  6585. "x-go-name": "FullName"
  6586. },
  6587. "location": {
  6588. "type": "string",
  6589. "x-go-name": "Location"
  6590. },
  6591. "website": {
  6592. "type": "string",
  6593. "x-go-name": "Website"
  6594. }
  6595. },
  6596. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6597. },
  6598. "EditPullRequestOption": {
  6599. "description": "EditPullRequestOption options when modify pull request",
  6600. "type": "object",
  6601. "properties": {
  6602. "assignee": {
  6603. "type": "string",
  6604. "x-go-name": "Assignee"
  6605. },
  6606. "assignees": {
  6607. "type": "array",
  6608. "items": {
  6609. "type": "string"
  6610. },
  6611. "x-go-name": "Assignees"
  6612. },
  6613. "body": {
  6614. "type": "string",
  6615. "x-go-name": "Body"
  6616. },
  6617. "due_date": {
  6618. "type": "string",
  6619. "format": "date-time",
  6620. "x-go-name": "Deadline"
  6621. },
  6622. "labels": {
  6623. "type": "array",
  6624. "items": {
  6625. "type": "integer",
  6626. "format": "int64"
  6627. },
  6628. "x-go-name": "Labels"
  6629. },
  6630. "milestone": {
  6631. "type": "integer",
  6632. "format": "int64",
  6633. "x-go-name": "Milestone"
  6634. },
  6635. "state": {
  6636. "type": "string",
  6637. "x-go-name": "State"
  6638. },
  6639. "title": {
  6640. "type": "string",
  6641. "x-go-name": "Title"
  6642. }
  6643. },
  6644. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6645. },
  6646. "EditReleaseOption": {
  6647. "description": "EditReleaseOption options when editing a release",
  6648. "type": "object",
  6649. "properties": {
  6650. "body": {
  6651. "type": "string",
  6652. "x-go-name": "Note"
  6653. },
  6654. "draft": {
  6655. "type": "boolean",
  6656. "x-go-name": "IsDraft"
  6657. },
  6658. "name": {
  6659. "type": "string",
  6660. "x-go-name": "Title"
  6661. },
  6662. "prerelease": {
  6663. "type": "boolean",
  6664. "x-go-name": "IsPrerelease"
  6665. },
  6666. "tag_name": {
  6667. "type": "string",
  6668. "x-go-name": "TagName"
  6669. },
  6670. "target_commitish": {
  6671. "type": "string",
  6672. "x-go-name": "Target"
  6673. }
  6674. },
  6675. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6676. },
  6677. "EditTeamOption": {
  6678. "description": "EditTeamOption options for editing a team",
  6679. "type": "object",
  6680. "required": [
  6681. "name"
  6682. ],
  6683. "properties": {
  6684. "description": {
  6685. "type": "string",
  6686. "x-go-name": "Description"
  6687. },
  6688. "name": {
  6689. "type": "string",
  6690. "x-go-name": "Name"
  6691. },
  6692. "permission": {
  6693. "type": "string",
  6694. "enum": [
  6695. "read",
  6696. "write",
  6697. "admin"
  6698. ],
  6699. "x-go-name": "Permission"
  6700. }
  6701. },
  6702. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6703. },
  6704. "EditUserOption": {
  6705. "description": "EditUserOption edit user options",
  6706. "type": "object",
  6707. "required": [
  6708. "email"
  6709. ],
  6710. "properties": {
  6711. "active": {
  6712. "type": "boolean",
  6713. "x-go-name": "Active"
  6714. },
  6715. "admin": {
  6716. "type": "boolean",
  6717. "x-go-name": "Admin"
  6718. },
  6719. "allow_create_organization": {
  6720. "type": "boolean",
  6721. "x-go-name": "AllowCreateOrganization"
  6722. },
  6723. "allow_git_hook": {
  6724. "type": "boolean",
  6725. "x-go-name": "AllowGitHook"
  6726. },
  6727. "allow_import_local": {
  6728. "type": "boolean",
  6729. "x-go-name": "AllowImportLocal"
  6730. },
  6731. "email": {
  6732. "type": "string",
  6733. "format": "email",
  6734. "x-go-name": "Email"
  6735. },
  6736. "full_name": {
  6737. "type": "string",
  6738. "x-go-name": "FullName"
  6739. },
  6740. "location": {
  6741. "type": "string",
  6742. "x-go-name": "Location"
  6743. },
  6744. "login_name": {
  6745. "type": "string",
  6746. "x-go-name": "LoginName"
  6747. },
  6748. "max_repo_creation": {
  6749. "type": "integer",
  6750. "format": "int64",
  6751. "x-go-name": "MaxRepoCreation"
  6752. },
  6753. "password": {
  6754. "type": "string",
  6755. "x-go-name": "Password"
  6756. },
  6757. "prohibit_login": {
  6758. "type": "boolean",
  6759. "x-go-name": "ProhibitLogin"
  6760. },
  6761. "source_id": {
  6762. "type": "integer",
  6763. "format": "int64",
  6764. "x-go-name": "SourceID"
  6765. },
  6766. "website": {
  6767. "type": "string",
  6768. "x-go-name": "Website"
  6769. }
  6770. },
  6771. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6772. },
  6773. "Email": {
  6774. "description": "Email an email address belonging to a user",
  6775. "type": "object",
  6776. "properties": {
  6777. "email": {
  6778. "type": "string",
  6779. "format": "email",
  6780. "x-go-name": "Email"
  6781. },
  6782. "primary": {
  6783. "type": "boolean",
  6784. "x-go-name": "Primary"
  6785. },
  6786. "verified": {
  6787. "type": "boolean",
  6788. "x-go-name": "Verified"
  6789. }
  6790. },
  6791. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6792. },
  6793. "GPGKey": {
  6794. "description": "GPGKey a user GPG key to sign commit and tag in repository",
  6795. "type": "object",
  6796. "properties": {
  6797. "can_certify": {
  6798. "type": "boolean",
  6799. "x-go-name": "CanCertify"
  6800. },
  6801. "can_encrypt_comms": {
  6802. "type": "boolean",
  6803. "x-go-name": "CanEncryptComms"
  6804. },
  6805. "can_encrypt_storage": {
  6806. "type": "boolean",
  6807. "x-go-name": "CanEncryptStorage"
  6808. },
  6809. "can_sign": {
  6810. "type": "boolean",
  6811. "x-go-name": "CanSign"
  6812. },
  6813. "created_at": {
  6814. "type": "string",
  6815. "format": "date-time",
  6816. "x-go-name": "Created"
  6817. },
  6818. "emails": {
  6819. "type": "array",
  6820. "items": {
  6821. "$ref": "#/definitions/GPGKeyEmail"
  6822. },
  6823. "x-go-name": "Emails"
  6824. },
  6825. "expires_at": {
  6826. "type": "string",
  6827. "format": "date-time",
  6828. "x-go-name": "Expires"
  6829. },
  6830. "id": {
  6831. "type": "integer",
  6832. "format": "int64",
  6833. "x-go-name": "ID"
  6834. },
  6835. "key_id": {
  6836. "type": "string",
  6837. "x-go-name": "KeyID"
  6838. },
  6839. "primary_key_id": {
  6840. "type": "string",
  6841. "x-go-name": "PrimaryKeyID"
  6842. },
  6843. "public_key": {
  6844. "type": "string",
  6845. "x-go-name": "PublicKey"
  6846. },
  6847. "subkeys": {
  6848. "type": "array",
  6849. "items": {
  6850. "$ref": "#/definitions/GPGKey"
  6851. },
  6852. "x-go-name": "SubsKey"
  6853. }
  6854. },
  6855. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6856. },
  6857. "GPGKeyEmail": {
  6858. "description": "GPGKeyEmail an email attached to a GPGKey",
  6859. "type": "object",
  6860. "properties": {
  6861. "email": {
  6862. "type": "string",
  6863. "x-go-name": "Email"
  6864. },
  6865. "verified": {
  6866. "type": "boolean",
  6867. "x-go-name": "Verified"
  6868. }
  6869. },
  6870. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6871. },
  6872. "Issue": {
  6873. "description": "Issue represents an issue in a repository",
  6874. "type": "object",
  6875. "properties": {
  6876. "assignee": {
  6877. "$ref": "#/definitions/User"
  6878. },
  6879. "assignees": {
  6880. "type": "array",
  6881. "items": {
  6882. "$ref": "#/definitions/User"
  6883. },
  6884. "x-go-name": "Assignees"
  6885. },
  6886. "body": {
  6887. "type": "string",
  6888. "x-go-name": "Body"
  6889. },
  6890. "closed_at": {
  6891. "type": "string",
  6892. "format": "date-time",
  6893. "x-go-name": "Closed"
  6894. },
  6895. "comments": {
  6896. "type": "integer",
  6897. "format": "int64",
  6898. "x-go-name": "Comments"
  6899. },
  6900. "created_at": {
  6901. "type": "string",
  6902. "format": "date-time",
  6903. "x-go-name": "Created"
  6904. },
  6905. "due_date": {
  6906. "type": "string",
  6907. "format": "date-time",
  6908. "x-go-name": "Deadline"
  6909. },
  6910. "id": {
  6911. "type": "integer",
  6912. "format": "int64",
  6913. "x-go-name": "ID"
  6914. },
  6915. "labels": {
  6916. "type": "array",
  6917. "items": {
  6918. "$ref": "#/definitions/Label"
  6919. },
  6920. "x-go-name": "Labels"
  6921. },
  6922. "milestone": {
  6923. "$ref": "#/definitions/Milestone"
  6924. },
  6925. "number": {
  6926. "type": "integer",
  6927. "format": "int64",
  6928. "x-go-name": "Index"
  6929. },
  6930. "pull_request": {
  6931. "$ref": "#/definitions/PullRequestMeta"
  6932. },
  6933. "state": {
  6934. "$ref": "#/definitions/StateType"
  6935. },
  6936. "title": {
  6937. "type": "string",
  6938. "x-go-name": "Title"
  6939. },
  6940. "updated_at": {
  6941. "type": "string",
  6942. "format": "date-time",
  6943. "x-go-name": "Updated"
  6944. },
  6945. "url": {
  6946. "type": "string",
  6947. "x-go-name": "URL"
  6948. },
  6949. "user": {
  6950. "$ref": "#/definitions/User"
  6951. }
  6952. },
  6953. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6954. },
  6955. "IssueDeadline": {
  6956. "description": "IssueDeadline represents an issue deadline",
  6957. "type": "object",
  6958. "properties": {
  6959. "due_date": {
  6960. "type": "string",
  6961. "format": "date-time",
  6962. "x-go-name": "Deadline"
  6963. }
  6964. },
  6965. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6966. },
  6967. "IssueLabelsOption": {
  6968. "description": "IssueLabelsOption a collection of labels",
  6969. "type": "object",
  6970. "properties": {
  6971. "labels": {
  6972. "description": "list of label IDs",
  6973. "type": "array",
  6974. "items": {
  6975. "type": "integer",
  6976. "format": "int64"
  6977. },
  6978. "x-go-name": "Labels"
  6979. }
  6980. },
  6981. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  6982. },
  6983. "Label": {
  6984. "description": "Label a label to an issue or a pr",
  6985. "type": "object",
  6986. "properties": {
  6987. "color": {
  6988. "type": "string",
  6989. "x-go-name": "Color",
  6990. "example": "00aabb"
  6991. },
  6992. "id": {
  6993. "type": "integer",
  6994. "format": "int64",
  6995. "x-go-name": "ID"
  6996. },
  6997. "name": {
  6998. "type": "string",
  6999. "x-go-name": "Name"
  7000. },
  7001. "url": {
  7002. "type": "string",
  7003. "x-go-name": "URL"
  7004. }
  7005. },
  7006. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7007. },
  7008. "MarkdownOption": {
  7009. "description": "MarkdownOption markdown options",
  7010. "type": "object",
  7011. "properties": {
  7012. "Context": {
  7013. "description": "Context to render\n\nin: body",
  7014. "type": "string"
  7015. },
  7016. "Mode": {
  7017. "description": "Mode to render\n\nin: body",
  7018. "type": "string"
  7019. },
  7020. "Text": {
  7021. "description": "Text markdown to render\n\nin: body",
  7022. "type": "string"
  7023. },
  7024. "Wiki": {
  7025. "description": "Is it a wiki page ?\n\nin: body",
  7026. "type": "boolean"
  7027. }
  7028. },
  7029. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7030. },
  7031. "MigrateRepoForm": {
  7032. "description": "MigrateRepoForm form for migrating repository",
  7033. "type": "object",
  7034. "required": [
  7035. "clone_addr",
  7036. "uid",
  7037. "repo_name"
  7038. ],
  7039. "properties": {
  7040. "auth_password": {
  7041. "type": "string",
  7042. "x-go-name": "AuthPassword"
  7043. },
  7044. "auth_username": {
  7045. "type": "string",
  7046. "x-go-name": "AuthUsername"
  7047. },
  7048. "clone_addr": {
  7049. "type": "string",
  7050. "x-go-name": "CloneAddr"
  7051. },
  7052. "description": {
  7053. "type": "string",
  7054. "x-go-name": "Description"
  7055. },
  7056. "mirror": {
  7057. "type": "boolean",
  7058. "x-go-name": "Mirror"
  7059. },
  7060. "private": {
  7061. "type": "boolean",
  7062. "x-go-name": "Private"
  7063. },
  7064. "repo_name": {
  7065. "type": "string",
  7066. "x-go-name": "RepoName"
  7067. },
  7068. "uid": {
  7069. "type": "integer",
  7070. "format": "int64",
  7071. "x-go-name": "UID"
  7072. }
  7073. },
  7074. "x-go-package": "code.gitea.io/gitea/modules/auth"
  7075. },
  7076. "Milestone": {
  7077. "description": "Milestone milestone is a collection of issues on one repository",
  7078. "type": "object",
  7079. "properties": {
  7080. "closed_at": {
  7081. "type": "string",
  7082. "format": "date-time",
  7083. "x-go-name": "Closed"
  7084. },
  7085. "closed_issues": {
  7086. "type": "integer",
  7087. "format": "int64",
  7088. "x-go-name": "ClosedIssues"
  7089. },
  7090. "description": {
  7091. "type": "string",
  7092. "x-go-name": "Description"
  7093. },
  7094. "due_on": {
  7095. "type": "string",
  7096. "format": "date-time",
  7097. "x-go-name": "Deadline"
  7098. },
  7099. "id": {
  7100. "type": "integer",
  7101. "format": "int64",
  7102. "x-go-name": "ID"
  7103. },
  7104. "open_issues": {
  7105. "type": "integer",
  7106. "format": "int64",
  7107. "x-go-name": "OpenIssues"
  7108. },
  7109. "state": {
  7110. "$ref": "#/definitions/StateType"
  7111. },
  7112. "title": {
  7113. "type": "string",
  7114. "x-go-name": "Title"
  7115. }
  7116. },
  7117. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7118. },
  7119. "Organization": {
  7120. "description": "Organization represents an organization",
  7121. "type": "object",
  7122. "properties": {
  7123. "avatar_url": {
  7124. "type": "string",
  7125. "x-go-name": "AvatarURL"
  7126. },
  7127. "description": {
  7128. "type": "string",
  7129. "x-go-name": "Description"
  7130. },
  7131. "full_name": {
  7132. "type": "string",
  7133. "x-go-name": "FullName"
  7134. },
  7135. "id": {
  7136. "type": "integer",
  7137. "format": "int64",
  7138. "x-go-name": "ID"
  7139. },
  7140. "location": {
  7141. "type": "string",
  7142. "x-go-name": "Location"
  7143. },
  7144. "username": {
  7145. "type": "string",
  7146. "x-go-name": "UserName"
  7147. },
  7148. "website": {
  7149. "type": "string",
  7150. "x-go-name": "Website"
  7151. }
  7152. },
  7153. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7154. },
  7155. "PRBranchInfo": {
  7156. "description": "PRBranchInfo information about a branch",
  7157. "type": "object",
  7158. "properties": {
  7159. "label": {
  7160. "type": "string",
  7161. "x-go-name": "Name"
  7162. },
  7163. "ref": {
  7164. "type": "string",
  7165. "x-go-name": "Ref"
  7166. },
  7167. "repo": {
  7168. "$ref": "#/definitions/Repository"
  7169. },
  7170. "repo_id": {
  7171. "type": "integer",
  7172. "format": "int64",
  7173. "x-go-name": "RepoID"
  7174. },
  7175. "sha": {
  7176. "type": "string",
  7177. "x-go-name": "Sha"
  7178. }
  7179. },
  7180. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7181. },
  7182. "PayloadCommit": {
  7183. "description": "PayloadCommit represents a commit",
  7184. "type": "object",
  7185. "properties": {
  7186. "author": {
  7187. "$ref": "#/definitions/PayloadUser"
  7188. },
  7189. "committer": {
  7190. "$ref": "#/definitions/PayloadUser"
  7191. },
  7192. "id": {
  7193. "description": "sha1 hash of the commit",
  7194. "type": "string",
  7195. "x-go-name": "ID"
  7196. },
  7197. "message": {
  7198. "type": "string",
  7199. "x-go-name": "Message"
  7200. },
  7201. "timestamp": {
  7202. "type": "string",
  7203. "format": "date-time",
  7204. "x-go-name": "Timestamp"
  7205. },
  7206. "url": {
  7207. "type": "string",
  7208. "x-go-name": "URL"
  7209. },
  7210. "verification": {
  7211. "$ref": "#/definitions/PayloadCommitVerification"
  7212. }
  7213. },
  7214. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7215. },
  7216. "PayloadCommitVerification": {
  7217. "description": "PayloadCommitVerification represents the GPG verification of a commit",
  7218. "type": "object",
  7219. "properties": {
  7220. "payload": {
  7221. "type": "string",
  7222. "x-go-name": "Payload"
  7223. },
  7224. "reason": {
  7225. "type": "string",
  7226. "x-go-name": "Reason"
  7227. },
  7228. "signature": {
  7229. "type": "string",
  7230. "x-go-name": "Signature"
  7231. },
  7232. "verified": {
  7233. "type": "boolean",
  7234. "x-go-name": "Verified"
  7235. }
  7236. },
  7237. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7238. },
  7239. "PayloadUser": {
  7240. "description": "PayloadUser represents the author or committer of a commit",
  7241. "type": "object",
  7242. "properties": {
  7243. "email": {
  7244. "type": "string",
  7245. "format": "email",
  7246. "x-go-name": "Email"
  7247. },
  7248. "name": {
  7249. "description": "Full name of the commit author",
  7250. "type": "string",
  7251. "x-go-name": "Name"
  7252. },
  7253. "username": {
  7254. "type": "string",
  7255. "x-go-name": "UserName"
  7256. }
  7257. },
  7258. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7259. },
  7260. "Permission": {
  7261. "description": "Permission represents a set of permissions",
  7262. "type": "object",
  7263. "properties": {
  7264. "admin": {
  7265. "type": "boolean",
  7266. "x-go-name": "Admin"
  7267. },
  7268. "pull": {
  7269. "type": "boolean",
  7270. "x-go-name": "Pull"
  7271. },
  7272. "push": {
  7273. "type": "boolean",
  7274. "x-go-name": "Push"
  7275. }
  7276. },
  7277. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7278. },
  7279. "PublicKey": {
  7280. "description": "PublicKey publickey is a user key to push code to repository",
  7281. "type": "object",
  7282. "properties": {
  7283. "created_at": {
  7284. "type": "string",
  7285. "format": "date-time",
  7286. "x-go-name": "Created"
  7287. },
  7288. "fingerprint": {
  7289. "type": "string",
  7290. "x-go-name": "Fingerprint"
  7291. },
  7292. "id": {
  7293. "type": "integer",
  7294. "format": "int64",
  7295. "x-go-name": "ID"
  7296. },
  7297. "key": {
  7298. "type": "string",
  7299. "x-go-name": "Key"
  7300. },
  7301. "key_type": {
  7302. "type": "string",
  7303. "x-go-name": "KeyType"
  7304. },
  7305. "read_only": {
  7306. "type": "boolean",
  7307. "x-go-name": "ReadOnly"
  7308. },
  7309. "title": {
  7310. "type": "string",
  7311. "x-go-name": "Title"
  7312. },
  7313. "url": {
  7314. "type": "string",
  7315. "x-go-name": "URL"
  7316. },
  7317. "user": {
  7318. "$ref": "#/definitions/User"
  7319. }
  7320. },
  7321. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7322. },
  7323. "PullRequest": {
  7324. "description": "PullRequest represents a pull request",
  7325. "type": "object",
  7326. "properties": {
  7327. "assignee": {
  7328. "$ref": "#/definitions/User"
  7329. },
  7330. "assignees": {
  7331. "type": "array",
  7332. "items": {
  7333. "$ref": "#/definitions/User"
  7334. },
  7335. "x-go-name": "Assignees"
  7336. },
  7337. "base": {
  7338. "$ref": "#/definitions/PRBranchInfo"
  7339. },
  7340. "body": {
  7341. "type": "string",
  7342. "x-go-name": "Body"
  7343. },
  7344. "closed_at": {
  7345. "type": "string",
  7346. "format": "date-time",
  7347. "x-go-name": "Closed"
  7348. },
  7349. "comments": {
  7350. "type": "integer",
  7351. "format": "int64",
  7352. "x-go-name": "Comments"
  7353. },
  7354. "created_at": {
  7355. "type": "string",
  7356. "format": "date-time",
  7357. "x-go-name": "Created"
  7358. },
  7359. "diff_url": {
  7360. "type": "string",
  7361. "x-go-name": "DiffURL"
  7362. },
  7363. "due_date": {
  7364. "type": "string",
  7365. "format": "date-time",
  7366. "x-go-name": "Deadline"
  7367. },
  7368. "head": {
  7369. "$ref": "#/definitions/PRBranchInfo"
  7370. },
  7371. "html_url": {
  7372. "type": "string",
  7373. "x-go-name": "HTMLURL"
  7374. },
  7375. "id": {
  7376. "type": "integer",
  7377. "format": "int64",
  7378. "x-go-name": "ID"
  7379. },
  7380. "labels": {
  7381. "type": "array",
  7382. "items": {
  7383. "$ref": "#/definitions/Label"
  7384. },
  7385. "x-go-name": "Labels"
  7386. },
  7387. "merge_base": {
  7388. "type": "string",
  7389. "x-go-name": "MergeBase"
  7390. },
  7391. "merge_commit_sha": {
  7392. "type": "string",
  7393. "x-go-name": "MergedCommitID"
  7394. },
  7395. "mergeable": {
  7396. "type": "boolean",
  7397. "x-go-name": "Mergeable"
  7398. },
  7399. "merged": {
  7400. "type": "boolean",
  7401. "x-go-name": "HasMerged"
  7402. },
  7403. "merged_at": {
  7404. "type": "string",
  7405. "format": "date-time",
  7406. "x-go-name": "Merged"
  7407. },
  7408. "merged_by": {
  7409. "$ref": "#/definitions/User"
  7410. },
  7411. "milestone": {
  7412. "$ref": "#/definitions/Milestone"
  7413. },
  7414. "number": {
  7415. "type": "integer",
  7416. "format": "int64",
  7417. "x-go-name": "Index"
  7418. },
  7419. "patch_url": {
  7420. "type": "string",
  7421. "x-go-name": "PatchURL"
  7422. },
  7423. "state": {
  7424. "$ref": "#/definitions/StateType"
  7425. },
  7426. "title": {
  7427. "type": "string",
  7428. "x-go-name": "Title"
  7429. },
  7430. "updated_at": {
  7431. "type": "string",
  7432. "format": "date-time",
  7433. "x-go-name": "Updated"
  7434. },
  7435. "url": {
  7436. "type": "string",
  7437. "x-go-name": "URL"
  7438. },
  7439. "user": {
  7440. "$ref": "#/definitions/User"
  7441. }
  7442. },
  7443. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7444. },
  7445. "PullRequestMeta": {
  7446. "description": "PullRequestMeta PR info if an issue is a PR",
  7447. "type": "object",
  7448. "properties": {
  7449. "merged": {
  7450. "type": "boolean",
  7451. "x-go-name": "HasMerged"
  7452. },
  7453. "merged_at": {
  7454. "type": "string",
  7455. "format": "date-time",
  7456. "x-go-name": "Merged"
  7457. }
  7458. },
  7459. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7460. },
  7461. "Release": {
  7462. "description": "Release represents a repository release",
  7463. "type": "object",
  7464. "properties": {
  7465. "assets": {
  7466. "type": "array",
  7467. "items": {
  7468. "$ref": "#/definitions/Attachment"
  7469. },
  7470. "x-go-name": "Attachments"
  7471. },
  7472. "author": {
  7473. "$ref": "#/definitions/User"
  7474. },
  7475. "body": {
  7476. "type": "string",
  7477. "x-go-name": "Note"
  7478. },
  7479. "created_at": {
  7480. "type": "string",
  7481. "format": "date-time",
  7482. "x-go-name": "CreatedAt"
  7483. },
  7484. "draft": {
  7485. "type": "boolean",
  7486. "x-go-name": "IsDraft"
  7487. },
  7488. "id": {
  7489. "type": "integer",
  7490. "format": "int64",
  7491. "x-go-name": "ID"
  7492. },
  7493. "name": {
  7494. "type": "string",
  7495. "x-go-name": "Title"
  7496. },
  7497. "prerelease": {
  7498. "type": "boolean",
  7499. "x-go-name": "IsPrerelease"
  7500. },
  7501. "published_at": {
  7502. "type": "string",
  7503. "format": "date-time",
  7504. "x-go-name": "PublishedAt"
  7505. },
  7506. "tag_name": {
  7507. "type": "string",
  7508. "x-go-name": "TagName"
  7509. },
  7510. "tarball_url": {
  7511. "type": "string",
  7512. "x-go-name": "TarURL"
  7513. },
  7514. "target_commitish": {
  7515. "type": "string",
  7516. "x-go-name": "Target"
  7517. },
  7518. "url": {
  7519. "type": "string",
  7520. "x-go-name": "URL"
  7521. },
  7522. "zipball_url": {
  7523. "type": "string",
  7524. "x-go-name": "ZipURL"
  7525. }
  7526. },
  7527. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7528. },
  7529. "Repository": {
  7530. "description": "Repository represents a repository",
  7531. "type": "object",
  7532. "properties": {
  7533. "archived": {
  7534. "type": "boolean",
  7535. "x-go-name": "Archived"
  7536. },
  7537. "clone_url": {
  7538. "type": "string",
  7539. "x-go-name": "CloneURL"
  7540. },
  7541. "created_at": {
  7542. "type": "string",
  7543. "format": "date-time",
  7544. "x-go-name": "Created"
  7545. },
  7546. "default_branch": {
  7547. "type": "string",
  7548. "x-go-name": "DefaultBranch"
  7549. },
  7550. "description": {
  7551. "type": "string",
  7552. "x-go-name": "Description"
  7553. },
  7554. "empty": {
  7555. "type": "boolean",
  7556. "x-go-name": "Empty"
  7557. },
  7558. "fork": {
  7559. "type": "boolean",
  7560. "x-go-name": "Fork"
  7561. },
  7562. "forks_count": {
  7563. "type": "integer",
  7564. "format": "int64",
  7565. "x-go-name": "Forks"
  7566. },
  7567. "full_name": {
  7568. "type": "string",
  7569. "x-go-name": "FullName"
  7570. },
  7571. "html_url": {
  7572. "type": "string",
  7573. "x-go-name": "HTMLURL"
  7574. },
  7575. "id": {
  7576. "type": "integer",
  7577. "format": "int64",
  7578. "x-go-name": "ID"
  7579. },
  7580. "mirror": {
  7581. "type": "boolean",
  7582. "x-go-name": "Mirror"
  7583. },
  7584. "name": {
  7585. "type": "string",
  7586. "x-go-name": "Name"
  7587. },
  7588. "open_issues_count": {
  7589. "type": "integer",
  7590. "format": "int64",
  7591. "x-go-name": "OpenIssues"
  7592. },
  7593. "owner": {
  7594. "$ref": "#/definitions/User"
  7595. },
  7596. "parent": {
  7597. "$ref": "#/definitions/Repository"
  7598. },
  7599. "permissions": {
  7600. "$ref": "#/definitions/Permission"
  7601. },
  7602. "private": {
  7603. "type": "boolean",
  7604. "x-go-name": "Private"
  7605. },
  7606. "size": {
  7607. "type": "integer",
  7608. "format": "int64",
  7609. "x-go-name": "Size"
  7610. },
  7611. "ssh_url": {
  7612. "type": "string",
  7613. "x-go-name": "SSHURL"
  7614. },
  7615. "stars_count": {
  7616. "type": "integer",
  7617. "format": "int64",
  7618. "x-go-name": "Stars"
  7619. },
  7620. "updated_at": {
  7621. "type": "string",
  7622. "format": "date-time",
  7623. "x-go-name": "Updated"
  7624. },
  7625. "watchers_count": {
  7626. "type": "integer",
  7627. "format": "int64",
  7628. "x-go-name": "Watchers"
  7629. },
  7630. "website": {
  7631. "type": "string",
  7632. "x-go-name": "Website"
  7633. }
  7634. },
  7635. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7636. },
  7637. "SearchResults": {
  7638. "description": "SearchResults results of a successful search",
  7639. "type": "object",
  7640. "properties": {
  7641. "data": {
  7642. "type": "array",
  7643. "items": {
  7644. "$ref": "#/definitions/Repository"
  7645. },
  7646. "x-go-name": "Data"
  7647. },
  7648. "ok": {
  7649. "type": "boolean",
  7650. "x-go-name": "OK"
  7651. }
  7652. },
  7653. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7654. },
  7655. "ServerVersion": {
  7656. "description": "ServerVersion wraps the version of the server",
  7657. "type": "object",
  7658. "properties": {
  7659. "version": {
  7660. "type": "string",
  7661. "x-go-name": "Version"
  7662. }
  7663. },
  7664. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7665. },
  7666. "StateType": {
  7667. "description": "StateType issue state type",
  7668. "type": "string",
  7669. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7670. },
  7671. "Status": {
  7672. "description": "Status holds a single Status of a single Commit",
  7673. "type": "object",
  7674. "properties": {
  7675. "context": {
  7676. "type": "string",
  7677. "x-go-name": "Context"
  7678. },
  7679. "created_at": {
  7680. "type": "string",
  7681. "format": "date-time",
  7682. "x-go-name": "Created"
  7683. },
  7684. "creator": {
  7685. "$ref": "#/definitions/User"
  7686. },
  7687. "description": {
  7688. "type": "string",
  7689. "x-go-name": "Description"
  7690. },
  7691. "id": {
  7692. "type": "integer",
  7693. "format": "int64",
  7694. "x-go-name": "ID"
  7695. },
  7696. "status": {
  7697. "$ref": "#/definitions/StatusState"
  7698. },
  7699. "target_url": {
  7700. "type": "string",
  7701. "x-go-name": "TargetURL"
  7702. },
  7703. "updated_at": {
  7704. "type": "string",
  7705. "format": "date-time",
  7706. "x-go-name": "Updated"
  7707. },
  7708. "url": {
  7709. "type": "string",
  7710. "x-go-name": "URL"
  7711. }
  7712. },
  7713. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7714. },
  7715. "StatusState": {
  7716. "description": "StatusState holds the state of a Status\nIt can be \"pending\", \"success\", \"error\", \"failure\", and \"warning\"",
  7717. "type": "string",
  7718. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7719. },
  7720. "Team": {
  7721. "description": "Team represents a team in an organization",
  7722. "type": "object",
  7723. "properties": {
  7724. "description": {
  7725. "type": "string",
  7726. "x-go-name": "Description"
  7727. },
  7728. "id": {
  7729. "type": "integer",
  7730. "format": "int64",
  7731. "x-go-name": "ID"
  7732. },
  7733. "name": {
  7734. "type": "string",
  7735. "x-go-name": "Name"
  7736. },
  7737. "permission": {
  7738. "type": "string",
  7739. "enum": [
  7740. "none",
  7741. "read",
  7742. "write",
  7743. "admin",
  7744. "owner"
  7745. ],
  7746. "x-go-name": "Permission"
  7747. }
  7748. },
  7749. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7750. },
  7751. "TimeStamp": {
  7752. "description": "TimeStamp defines a timestamp",
  7753. "type": "integer",
  7754. "format": "int64",
  7755. "x-go-package": "code.gitea.io/gitea/modules/util"
  7756. },
  7757. "TrackedTime": {
  7758. "description": "TrackedTime worked time for an issue / pr",
  7759. "type": "object",
  7760. "properties": {
  7761. "created": {
  7762. "type": "string",
  7763. "format": "date-time",
  7764. "x-go-name": "Created"
  7765. },
  7766. "id": {
  7767. "type": "integer",
  7768. "format": "int64",
  7769. "x-go-name": "ID"
  7770. },
  7771. "issue_id": {
  7772. "type": "integer",
  7773. "format": "int64",
  7774. "x-go-name": "IssueID"
  7775. },
  7776. "time": {
  7777. "description": "Time in seconds",
  7778. "type": "integer",
  7779. "format": "int64",
  7780. "x-go-name": "Time"
  7781. },
  7782. "user_id": {
  7783. "type": "integer",
  7784. "format": "int64",
  7785. "x-go-name": "UserID"
  7786. }
  7787. },
  7788. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7789. },
  7790. "User": {
  7791. "description": "User represents a user",
  7792. "type": "object",
  7793. "properties": {
  7794. "avatar_url": {
  7795. "description": "URL to the user's avatar",
  7796. "type": "string",
  7797. "x-go-name": "AvatarURL"
  7798. },
  7799. "email": {
  7800. "type": "string",
  7801. "format": "email",
  7802. "x-go-name": "Email"
  7803. },
  7804. "full_name": {
  7805. "description": "the user's full name",
  7806. "type": "string",
  7807. "x-go-name": "FullName"
  7808. },
  7809. "id": {
  7810. "description": "the user's id",
  7811. "type": "integer",
  7812. "format": "int64",
  7813. "x-go-name": "ID"
  7814. },
  7815. "language": {
  7816. "description": "User locale",
  7817. "type": "string",
  7818. "x-go-name": "Language"
  7819. },
  7820. "login": {
  7821. "description": "the user's username",
  7822. "type": "string",
  7823. "x-go-name": "UserName"
  7824. }
  7825. },
  7826. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7827. },
  7828. "UserHeatmapData": {
  7829. "description": "UserHeatmapData represents the data needed to create a heatmap",
  7830. "type": "object",
  7831. "properties": {
  7832. "contributions": {
  7833. "type": "integer",
  7834. "format": "int64",
  7835. "x-go-name": "Contributions"
  7836. },
  7837. "timestamp": {
  7838. "$ref": "#/definitions/TimeStamp"
  7839. }
  7840. },
  7841. "x-go-package": "code.gitea.io/gitea/models"
  7842. },
  7843. "WatchInfo": {
  7844. "description": "WatchInfo represents an API watch status of one repository",
  7845. "type": "object",
  7846. "properties": {
  7847. "created_at": {
  7848. "type": "string",
  7849. "format": "date-time",
  7850. "x-go-name": "CreatedAt"
  7851. },
  7852. "ignored": {
  7853. "type": "boolean",
  7854. "x-go-name": "Ignored"
  7855. },
  7856. "reason": {
  7857. "type": "object",
  7858. "x-go-name": "Reason"
  7859. },
  7860. "repository_url": {
  7861. "type": "string",
  7862. "x-go-name": "RepositoryURL"
  7863. },
  7864. "subscribed": {
  7865. "type": "boolean",
  7866. "x-go-name": "Subscribed"
  7867. },
  7868. "url": {
  7869. "type": "string",
  7870. "x-go-name": "URL"
  7871. }
  7872. },
  7873. "x-go-package": "code.gitea.io/gitea/vendor/code.gitea.io/sdk/gitea"
  7874. }
  7875. },
  7876. "responses": {
  7877. "AccessToken": {
  7878. "description": "AccessToken represents a API access token.",
  7879. "headers": {
  7880. "id": {
  7881. "type": "integer",
  7882. "format": "int64"
  7883. },
  7884. "name": {
  7885. "type": "string"
  7886. },
  7887. "sha1": {
  7888. "type": "string"
  7889. }
  7890. }
  7891. },
  7892. "AccessTokenList": {
  7893. "description": "AccessTokenList represents a list of API access token."
  7894. },
  7895. "Attachment": {
  7896. "description": "Attachment",
  7897. "schema": {
  7898. "$ref": "#/definitions/Attachment"
  7899. }
  7900. },
  7901. "AttachmentList": {
  7902. "description": "AttachmentList",
  7903. "schema": {
  7904. "type": "array",
  7905. "items": {
  7906. "$ref": "#/definitions/Attachment"
  7907. }
  7908. }
  7909. },
  7910. "Branch": {
  7911. "description": "Branch",
  7912. "schema": {
  7913. "$ref": "#/definitions/Branch"
  7914. }
  7915. },
  7916. "BranchList": {
  7917. "description": "BranchList",
  7918. "schema": {
  7919. "type": "array",
  7920. "items": {
  7921. "$ref": "#/definitions/Branch"
  7922. }
  7923. }
  7924. },
  7925. "Comment": {
  7926. "description": "Comment",
  7927. "schema": {
  7928. "$ref": "#/definitions/Comment"
  7929. }
  7930. },
  7931. "CommentList": {
  7932. "description": "CommentList",
  7933. "schema": {
  7934. "type": "array",
  7935. "items": {
  7936. "$ref": "#/definitions/Comment"
  7937. }
  7938. }
  7939. },
  7940. "DeployKey": {
  7941. "description": "DeployKey",
  7942. "schema": {
  7943. "$ref": "#/definitions/DeployKey"
  7944. }
  7945. },
  7946. "DeployKeyList": {
  7947. "description": "DeployKeyList",
  7948. "schema": {
  7949. "type": "array",
  7950. "items": {
  7951. "$ref": "#/definitions/DeployKey"
  7952. }
  7953. }
  7954. },
  7955. "EmailList": {
  7956. "description": "EmailList",
  7957. "schema": {
  7958. "type": "array",
  7959. "items": {
  7960. "$ref": "#/definitions/Email"
  7961. }
  7962. }
  7963. },
  7964. "GPGKey": {
  7965. "description": "GPGKey",
  7966. "schema": {
  7967. "$ref": "#/definitions/GPGKey"
  7968. }
  7969. },
  7970. "GPGKeyList": {
  7971. "description": "GPGKeyList",
  7972. "schema": {
  7973. "type": "array",
  7974. "items": {
  7975. "$ref": "#/definitions/GPGKey"
  7976. }
  7977. }
  7978. },
  7979. "Hook": {
  7980. "description": "Hook",
  7981. "schema": {
  7982. "type": "array",
  7983. "items": {
  7984. "$ref": "#/definitions/Branch"
  7985. }
  7986. }
  7987. },
  7988. "HookList": {
  7989. "description": "HookList",
  7990. "schema": {
  7991. "type": "array",
  7992. "items": {
  7993. "$ref": "#/definitions/Branch"
  7994. }
  7995. }
  7996. },
  7997. "Issue": {
  7998. "description": "Issue",
  7999. "schema": {
  8000. "$ref": "#/definitions/Issue"
  8001. }
  8002. },
  8003. "IssueDeadline": {
  8004. "description": "IssueDeadline",
  8005. "schema": {
  8006. "$ref": "#/definitions/IssueDeadline"
  8007. }
  8008. },
  8009. "IssueList": {
  8010. "description": "IssueList",
  8011. "schema": {
  8012. "type": "array",
  8013. "items": {
  8014. "$ref": "#/definitions/Issue"
  8015. }
  8016. }
  8017. },
  8018. "Label": {
  8019. "description": "Label",
  8020. "schema": {
  8021. "$ref": "#/definitions/Label"
  8022. }
  8023. },
  8024. "LabelList": {
  8025. "description": "LabelList",
  8026. "schema": {
  8027. "type": "array",
  8028. "items": {
  8029. "$ref": "#/definitions/Label"
  8030. }
  8031. }
  8032. },
  8033. "MarkdownRender": {
  8034. "description": "MarkdownRender is a rendered markdown document"
  8035. },
  8036. "Milestone": {
  8037. "description": "Milestone",
  8038. "schema": {
  8039. "$ref": "#/definitions/Milestone"
  8040. }
  8041. },
  8042. "MilestoneList": {
  8043. "description": "MilestoneList",
  8044. "schema": {
  8045. "type": "array",
  8046. "items": {
  8047. "$ref": "#/definitions/Milestone"
  8048. }
  8049. }
  8050. },
  8051. "Organization": {
  8052. "description": "Organization",
  8053. "schema": {
  8054. "$ref": "#/definitions/Organization"
  8055. }
  8056. },
  8057. "OrganizationList": {
  8058. "description": "OrganizationList",
  8059. "schema": {
  8060. "type": "array",
  8061. "items": {
  8062. "$ref": "#/definitions/Organization"
  8063. }
  8064. }
  8065. },
  8066. "PublicKey": {
  8067. "description": "PublicKey",
  8068. "schema": {
  8069. "$ref": "#/definitions/PublicKey"
  8070. }
  8071. },
  8072. "PublicKeyList": {
  8073. "description": "PublicKeyList",
  8074. "schema": {
  8075. "type": "array",
  8076. "items": {
  8077. "$ref": "#/definitions/PublicKey"
  8078. }
  8079. }
  8080. },
  8081. "PullRequest": {
  8082. "description": "PullRequest",
  8083. "schema": {
  8084. "$ref": "#/definitions/PullRequest"
  8085. }
  8086. },
  8087. "PullRequestList": {
  8088. "description": "PullRequestList",
  8089. "schema": {
  8090. "type": "array",
  8091. "items": {
  8092. "$ref": "#/definitions/PullRequest"
  8093. }
  8094. }
  8095. },
  8096. "Release": {
  8097. "description": "Release",
  8098. "schema": {
  8099. "$ref": "#/definitions/Release"
  8100. }
  8101. },
  8102. "ReleaseList": {
  8103. "description": "ReleaseList",
  8104. "schema": {
  8105. "type": "array",
  8106. "items": {
  8107. "$ref": "#/definitions/Release"
  8108. }
  8109. }
  8110. },
  8111. "Repository": {
  8112. "description": "Repository",
  8113. "schema": {
  8114. "$ref": "#/definitions/Repository"
  8115. }
  8116. },
  8117. "RepositoryList": {
  8118. "description": "RepositoryList",
  8119. "schema": {
  8120. "type": "array",
  8121. "items": {
  8122. "$ref": "#/definitions/Repository"
  8123. }
  8124. }
  8125. },
  8126. "SearchResults": {
  8127. "description": "SearchResults",
  8128. "schema": {
  8129. "$ref": "#/definitions/SearchResults"
  8130. }
  8131. },
  8132. "ServerVersion": {
  8133. "description": "ServerVersion",
  8134. "schema": {
  8135. "$ref": "#/definitions/ServerVersion"
  8136. }
  8137. },
  8138. "Status": {
  8139. "description": "Status",
  8140. "schema": {
  8141. "$ref": "#/definitions/Status"
  8142. }
  8143. },
  8144. "StatusList": {
  8145. "description": "StatusList",
  8146. "schema": {
  8147. "type": "array",
  8148. "items": {
  8149. "$ref": "#/definitions/Status"
  8150. }
  8151. }
  8152. },
  8153. "Team": {
  8154. "description": "Team",
  8155. "schema": {
  8156. "$ref": "#/definitions/Team"
  8157. }
  8158. },
  8159. "TeamList": {
  8160. "description": "TeamList",
  8161. "schema": {
  8162. "type": "array",
  8163. "items": {
  8164. "$ref": "#/definitions/Team"
  8165. }
  8166. }
  8167. },
  8168. "TrackedTime": {
  8169. "description": "TrackedTime",
  8170. "schema": {
  8171. "$ref": "#/definitions/TrackedTime"
  8172. }
  8173. },
  8174. "TrackedTimeList": {
  8175. "description": "TrackedTimeList",
  8176. "schema": {
  8177. "type": "array",
  8178. "items": {
  8179. "$ref": "#/definitions/TrackedTime"
  8180. }
  8181. }
  8182. },
  8183. "User": {
  8184. "description": "User",
  8185. "schema": {
  8186. "$ref": "#/definitions/User"
  8187. }
  8188. },
  8189. "UserHeatmapData": {
  8190. "description": "UserHeatmapData",
  8191. "schema": {
  8192. "type": "array",
  8193. "items": {
  8194. "$ref": "#/definitions/UserHeatmapData"
  8195. }
  8196. }
  8197. },
  8198. "UserList": {
  8199. "description": "UserList",
  8200. "schema": {
  8201. "type": "array",
  8202. "items": {
  8203. "$ref": "#/definitions/User"
  8204. }
  8205. }
  8206. },
  8207. "WatchInfo": {
  8208. "description": "WatchInfo",
  8209. "schema": {
  8210. "$ref": "#/definitions/WatchInfo"
  8211. }
  8212. },
  8213. "empty": {
  8214. "description": "APIEmpty is an empty response"
  8215. },
  8216. "error": {
  8217. "description": "APIError is error format response",
  8218. "headers": {
  8219. "message": {
  8220. "type": "string"
  8221. },
  8222. "url": {
  8223. "type": "string"
  8224. }
  8225. }
  8226. },
  8227. "forbidden": {
  8228. "description": "APIForbiddenError is a forbidden error response",
  8229. "headers": {
  8230. "message": {
  8231. "type": "string"
  8232. },
  8233. "url": {
  8234. "type": "string"
  8235. }
  8236. }
  8237. },
  8238. "notFound": {
  8239. "description": "APINotFound is a not found empty response"
  8240. },
  8241. "parameterBodies": {
  8242. "description": "parameterBodies",
  8243. "schema": {
  8244. "$ref": "#/definitions/EditAttachmentOptions"
  8245. }
  8246. },
  8247. "redirect": {
  8248. "description": "APIRedirect is a redirect response"
  8249. },
  8250. "validationError": {
  8251. "description": "APIValidationError is error format response related to input validation",
  8252. "headers": {
  8253. "message": {
  8254. "type": "string"
  8255. },
  8256. "url": {
  8257. "type": "string"
  8258. }
  8259. }
  8260. }
  8261. },
  8262. "securityDefinitions": {
  8263. "AccessToken": {
  8264. "type": "apiKey",
  8265. "name": "access_token",
  8266. "in": "query"
  8267. },
  8268. "AuthorizationHeaderToken": {
  8269. "type": "apiKey",
  8270. "name": "Authorization",
  8271. "in": "header"
  8272. },
  8273. "BasicAuth": {
  8274. "type": "basic"
  8275. },
  8276. "SudoHeader": {
  8277. "description": "Sudo API request as the user provided as the key. Admin privileges are required.",
  8278. "type": "apiKey",
  8279. "name": "Sudo",
  8280. "in": "header"
  8281. },
  8282. "SudoParam": {
  8283. "description": "Sudo API request as the user provided as the key. Admin privileges are required.",
  8284. "type": "apiKey",
  8285. "name": "sudo",
  8286. "in": "query"
  8287. },
  8288. "Token": {
  8289. "type": "apiKey",
  8290. "name": "token",
  8291. "in": "query"
  8292. }
  8293. },
  8294. "security": [
  8295. {
  8296. "BasicAuth": []
  8297. },
  8298. {
  8299. "Token": []
  8300. },
  8301. {
  8302. "AccessToken": []
  8303. },
  8304. {
  8305. "AuthorizationHeaderToken": []
  8306. },
  8307. {
  8308. "SudoParam": []
  8309. },
  8310. {
  8311. "SudoHeader": []
  8312. }
  8313. ]
  8314. }