1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463 |
- {
- "consumes": [
- "application/json",
- "text/plain"
- ],
- "produces": [
- "application/json",
- "text/html"
- ],
- "schemes": [
- "http",
- "https"
- ],
- "swagger": "2.0",
- "info": {
- "description": "This documentation describes the Gitea API.",
- "title": "Gitea API.",
- "license": {
- "name": "MIT",
- "url": "http://opensource.org/licenses/MIT"
- },
- "version": "1.1.1"
- },
- "basePath": "{{AppSubUrl}}/api/v1",
- "paths": {
- "/admin/orgs": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "List all organizations",
- "operationId": "adminGetAllOrgs",
- "parameters": [
- {
- "type": "integer",
- "description": "page number of results to return (1-based)",
- "name": "page",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "page size of results, maximum page size is 50",
- "name": "limit",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/OrganizationList"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- }
- }
- }
- },
- "/admin/users": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "List all users",
- "operationId": "adminGetAllUsers",
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Create a user",
- "operationId": "adminCreateUser",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateUserOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/User"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/admin/users/{username}": {
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Delete a user",
- "operationId": "adminDeleteUser",
- "parameters": [
- {
- "type": "string",
- "description": "username of user to delete",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Edit an existing user",
- "operationId": "adminEditUser",
- "parameters": [
- {
- "type": "string",
- "description": "username of user to edit",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditUserOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/User"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/admin/users/{username}/keys": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Add a public key on behalf of a user",
- "operationId": "adminCreatePublicKey",
- "parameters": [
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "name": "key",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateKeyOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/PublicKey"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/admin/users/{username}/keys/{id}": {
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Delete a user's public key",
- "operationId": "adminDeleteUserPublicKey",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the key to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/admin/users/{username}/orgs": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Create an organization",
- "operationId": "adminCreateOrg",
- "parameters": [
- {
- "type": "string",
- "description": "username of the user that will own the created organization",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "name": "organization",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/CreateOrgOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Organization"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/admin/users/{username}/repos": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "admin"
- ],
- "summary": "Create a repository on behalf a user",
- "operationId": "adminCreateRepo",
- "parameters": [
- {
- "type": "string",
- "description": "username of the user. This user will own the created repository",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "name": "repository",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/CreateRepoOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Repository"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/markdown": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "text/html"
- ],
- "tags": [
- "miscellaneous"
- ],
- "summary": "Render a markdown document as HTML",
- "operationId": "renderMarkdown",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/MarkdownOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/MarkdownRender"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/markdown/raw": {
- "post": {
- "consumes": [
- "text/plain"
- ],
- "produces": [
- "text/html"
- ],
- "tags": [
- "miscellaneous"
- ],
- "summary": "Render raw markdown as HTML",
- "operationId": "renderMarkdownRaw",
- "parameters": [
- {
- "description": "Request body to render",
- "name": "body",
- "in": "body",
- "required": true,
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/MarkdownRender"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/org/{org}/repos": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Create a repository in an organization",
- "operationId": "createOrgRepo",
- "parameters": [
- {
- "type": "string",
- "description": "name of organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateRepoOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Repository"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/orgs": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Create an organization",
- "operationId": "orgCreate",
- "parameters": [
- {
- "name": "organization",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/CreateOrgOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Organization"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/orgs/{org}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Get an organization",
- "operationId": "orgGet",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization to get",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Organization"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Delete an organization",
- "operationId": "orgDelete",
- "parameters": [
- {
- "type": "string",
- "description": "organization that is to be deleted",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Edit an organization",
- "operationId": "orgEdit",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization to edit",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/EditOrgOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Organization"
- }
- }
- }
- },
- "/orgs/{org}/hooks": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List an organization's webhooks",
- "operationId": "orgListHooks",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/HookList"
- }
- }
- }
- },
- "/orgs/{org}/hooks/": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Create a hook",
- "operationId": "orgCreateHook",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/CreateHookOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Hook"
- }
- }
- }
- },
- "/orgs/{org}/hooks/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Get a hook",
- "operationId": "orgGetHook",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the hook to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Hook"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Delete a hook",
- "operationId": "orgDeleteHook",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the hook to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Update a hook",
- "operationId": "orgEditHook",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the hook to update",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditHookOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Hook"
- }
- }
- }
- },
- "/orgs/{org}/members": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List an organization's members",
- "operationId": "orgListMembers",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/orgs/{org}/members/{username}": {
- "get": {
- "tags": [
- "organization"
- ],
- "summary": "Check if a user is a member of an organization",
- "operationId": "orgIsMember",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "description": "user is a member"
- },
- "404": {
- "description": "user is not a member"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Remove a member from an organization",
- "operationId": "orgDeleteMember",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "description": "member removed"
- }
- }
- }
- },
- "/orgs/{org}/public_members": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List an organization's public members",
- "operationId": "orgListPublicMembers",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/orgs/{org}/public_members/{username}": {
- "get": {
- "tags": [
- "organization"
- ],
- "summary": "Check if a user is a public member of an organization",
- "operationId": "orgIsPublicMember",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "description": "user is a public member"
- },
- "404": {
- "description": "user is not a public member"
- }
- }
- },
- "put": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Publicize a user's membership",
- "operationId": "orgPublicizeMember",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "description": "membership publicized"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Conceal a user's membership",
- "operationId": "orgConcealMember",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/orgs/{org}/repos": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List an organization's repos",
- "operationId": "orgListRepos",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/orgs/{org}/teams": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List an organization's teams",
- "operationId": "orgListTeams",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/TeamList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Create a team",
- "operationId": "orgCreateTeam",
- "parameters": [
- {
- "type": "string",
- "description": "name of the organization",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateTeamOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Team"
- }
- }
- }
- },
- "/repos/migrate": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Migrate a remote git repository",
- "operationId": "repoMigrate",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/MigrateRepoForm"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Repository"
- }
- }
- }
- },
- "/repos/search": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Search for repositories",
- "operationId": "repoSearch",
- "parameters": [
- {
- "type": "string",
- "description": "keyword",
- "name": "q",
- "in": "query"
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "search only for repos that the user with the given id owns or contributes to",
- "name": "uid",
- "in": "query"
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "search only for repos that the user with the given id has starred",
- "name": "starredBy",
- "in": "query"
- },
- {
- "type": "boolean",
- "description": "include private repositories this user has access to (defaults to true)",
- "name": "private",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "page number of results to return (1-based)",
- "name": "page",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "page size of results, maximum page size is 50",
- "name": "limit",
- "in": "query"
- },
- {
- "type": "string",
- "description": "type of repository to search for. Supported values are \"fork\", \"source\", \"mirror\" and \"collaborative\"",
- "name": "mode",
- "in": "query"
- },
- {
- "type": "boolean",
- "description": "if `uid` is given, search only for repos that the user owns",
- "name": "exclusive",
- "in": "query"
- },
- {
- "type": "string",
- "description": "sort repos by attribute. Supported values are \"alpha\", \"created\", \"updated\", \"size\", and \"id\". Default is \"alpha\"",
- "name": "sort",
- "in": "query"
- },
- {
- "type": "string",
- "description": "sort order, either \"asc\" (ascending) or \"desc\" (descending). Default is \"asc\", ignored if \"sort\" is not specified.",
- "name": "order",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/SearchResults"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/repos/{owner}/{repo}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a repository",
- "operationId": "repoGet",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Repository"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Delete a repository",
- "operationId": "repoDelete",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo to delete",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to delete",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- }
- }
- },
- "patch": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Edit a repository's properties. Only fields that are set will be changed.",
- "operationId": "repoEdit",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo to edit",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to edit",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "description": "Properties of a repo that you can edit",
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditRepoOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Repository"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/archive/{archive}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get an archive of a repository",
- "operationId": "repoGetArchive",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "archive to download, consisting of a git reference and archive",
- "name": "archive",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "description": "success"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/branches": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repository's branches",
- "operationId": "repoListBranches",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/BranchList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/branches/{branch}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Retrieve a specific branch from a repository",
- "operationId": "repoGetBranch",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "branch to get",
- "name": "branch",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Branch"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/collaborators": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repository's collaborators",
- "operationId": "repoListCollaborators",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/collaborators/{collaborator}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Check if a user is a collaborator of a repository",
- "operationId": "repoCheckCollaborator",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the collaborator",
- "name": "collaborator",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "404": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "put": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Add a collaborator to a repository",
- "operationId": "repoAddCollaborator",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the collaborator to add",
- "name": "collaborator",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/AddCollaboratorOption"
- }
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Delete a collaborator from a repository",
- "operationId": "repoDeleteCollaborator",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the collaborator to delete",
- "name": "collaborator",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/commits/{ref}/statuses": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a commit's combined status, by branch/tag/commit reference",
- "operationId": "repoGetCombinedStatusByRef",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of branch/tag/commit",
- "name": "ref",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Status"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/contents": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Gets the metadata of all the entries of the root dir",
- "operationId": "repoGetContentsList",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "The name of the commit/branch/tag. Default the repository’s default branch (usually master)",
- "name": "ref",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/ContentsListResponse"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/contents/{filepath}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir",
- "operationId": "repoGetContents",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "path of the dir, file, symlink or submodule in the repo",
- "name": "filepath",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "The name of the commit/branch/tag. Default the repository’s default branch (usually master)",
- "name": "ref",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/ContentsResponse"
- }
- }
- },
- "put": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Update a file in a repository",
- "operationId": "repoUpdateFile",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "path of the file to update",
- "name": "filepath",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/UpdateFileOptions"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/FileResponse"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Create a file in a repository",
- "operationId": "repoCreateFile",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "path of the file to create",
- "name": "filepath",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/CreateFileOptions"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/FileResponse"
- }
- }
- },
- "delete": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Delete a file in a repository",
- "operationId": "repoDeleteFile",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "path of the file to delete",
- "name": "filepath",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "required": true,
- "schema": {
- "$ref": "#/definitions/DeleteFileOptions"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/FileDeleteResponse"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/editorconfig/{filepath}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get the EditorConfig definitions of a file in a repository",
- "operationId": "repoGetEditorConfig",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "filepath of file to get",
- "name": "filepath",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "description": "success"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/forks": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repository's forks",
- "operationId": "listForks",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- },
- "post": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Fork a repository",
- "operationId": "createFork",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo to fork",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to fork",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateForkOption"
- }
- }
- ],
- "responses": {
- "202": {
- "$ref": "#/responses/Repository"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/git/blobs/{sha}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Gets the blob of a repository.",
- "operationId": "GetBlob",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "sha of the commit",
- "name": "sha",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GitBlobResponse"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/git/commits/{sha}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a single commit from a repository",
- "operationId": "repoGetSingleCommit",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "the commit hash",
- "name": "sha",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Commit"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/git/refs": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get specified ref or filtered repository's refs",
- "operationId": "repoListAllGitRefs",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/ReferenceList"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/git/refs/{ref}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get specified ref or filtered repository's refs",
- "operationId": "repoListGitRefs",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "part or full name of the ref",
- "name": "ref",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/ReferenceList"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/git/tags/{sha}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Gets the tag of a repository.",
- "operationId": "GetTag",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "sha of the tag",
- "name": "sha",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/AnnotatedTag"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/git/trees/{sha}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Gets the tree of a repository.",
- "operationId": "GetTree",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "sha of the commit",
- "name": "sha",
- "in": "path",
- "required": true
- },
- {
- "type": "boolean",
- "description": "show all directories and files",
- "name": "recursive",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "page number; the 'truncated' field in the response will be true if there are still more items after this page, false if the last page",
- "name": "page",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "number of items per page; default is 1000 or what is set in app.ini as DEFAULT_GIT_TREES_PER_PAGE",
- "name": "per_page",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GitTreeResponse"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/hooks": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List the hooks in a repository",
- "operationId": "repoListHooks",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/HookList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Create a hook",
- "operationId": "repoCreateHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateHookOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Hook"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/hooks/git": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List the Git hooks in a repository",
- "operationId": "repoListGitHooks",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GitHookList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/hooks/git/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a Git hook",
- "operationId": "repoGetGitHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "id of the hook to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GitHook"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Delete a Git hook in a repository",
- "operationId": "repoDeleteGitHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "id of the hook to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "patch": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Edit a Git hook in a repository",
- "operationId": "repoEditGitHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "id of the hook to get",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditGitHookOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GitHook"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/hooks/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a hook",
- "operationId": "repoGetHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the hook to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Hook"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Delete a hook in a repository",
- "operationId": "repoDeleteHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the hook to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "patch": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Edit a hook in a repository",
- "operationId": "repoEditHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the hook",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditHookOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Hook"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/hooks/{id}/tests": {
- "post": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Test a push webhook",
- "operationId": "repoTestHook",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the hook to test",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "List a repository's issues",
- "operationId": "issueListIssues",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "whether issue is open or closed",
- "name": "state",
- "in": "query"
- },
- {
- "type": "string",
- "description": "comma separated list of labels. Fetch only issues that have any of this labels. Non existent labels are discarded",
- "name": "labels",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "page number of requested issues",
- "name": "page",
- "in": "query"
- },
- {
- "type": "string",
- "description": "search string",
- "name": "q",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/IssueList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Create an issue. If using deadline only the date will be taken into account, and time of day ignored.",
- "operationId": "issueCreateIssue",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateIssueOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Issue"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/comments": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "List all comments in a repository",
- "operationId": "issueGetRepoComments",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "if provided, only comments updated since the provided time are returned.",
- "name": "since",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/CommentList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/comments/{id}": {
- "delete": {
- "tags": [
- "issue"
- ],
- "summary": "Delete a comment",
- "operationId": "issueDeleteComment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of comment to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Edit a comment",
- "operationId": "issueEditComment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the comment to edit",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditIssueCommentOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Comment"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{id}/times": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "List an issue's tracked times",
- "operationId": "issueTrackedTimes",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/TrackedTimeList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Add a tracked time to a issue",
- "operationId": "issueAddTime",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue to add tracked time to",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/AddTimeOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/TrackedTime"
- },
- "400": {
- "$ref": "#/responses/error"
- },
- "403": {
- "$ref": "#/responses/error"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Get an issue",
- "operationId": "issueGetIssue",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue to get",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Issue"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Edit an issue. If using deadline only the date will be taken into account, and time of day ignored.",
- "operationId": "issueEditIssue",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue to edit",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditIssueOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Issue"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/comments": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "List all comments on an issue",
- "operationId": "issueGetComments",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "if provided, only comments updated since the specified time are returned.",
- "name": "since",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/CommentList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Add a comment to an issue",
- "operationId": "issueCreateComment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateIssueCommentOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Comment"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/comments/{id}": {
- "delete": {
- "tags": [
- "issue"
- ],
- "summary": "Delete a comment",
- "operationId": "issueDeleteCommentDeprecated",
- "deprecated": true,
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "description": "this parameter is ignored",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of comment to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Edit a comment",
- "operationId": "issueEditCommentDeprecated",
- "deprecated": true,
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "description": "this parameter is ignored",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the comment to edit",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditIssueCommentOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Comment"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/deadline": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Set an issue deadline. If set to null, the deadline is deleted. If using deadline only the date will be taken into account, and time of day ignored.",
- "operationId": "issueEditIssueDeadline",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue to create or update a deadline on",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditDeadlineOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/IssueDeadline"
- },
- "403": {
- "description": "Not repo writer"
- },
- "404": {
- "description": "Issue not found"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/labels": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Get an issue's labels",
- "operationId": "issueGetLabels",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/LabelList"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "put": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Replace an issue's labels",
- "operationId": "issueReplaceLabels",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/IssueLabelsOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/LabelList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Add a label to an issue",
- "operationId": "issueAddLabel",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/IssueLabelsOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/LabelList"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Remove all labels from an issue",
- "operationId": "issueClearLabels",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/labels/{id}": {
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Remove a label from an issue",
- "operationId": "issueRemoveLabel",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the label to remove",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/stopwatch/start": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Start stopwatch on an issue.",
- "operationId": "issueStartStopWatch",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue to create the stopwatch on",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "description": "Not repo writer, user does not have rights to toggle stopwatch"
- },
- "404": {
- "description": "Issue not found"
- },
- "409": {
- "description": "Cannot start a stopwatch again if it already exists"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/issues/{index}/stopwatch/stop": {
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Stop an issue's existing stopwatch.",
- "operationId": "issueStopWatch",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the issue to stop the stopwatch on",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "description": "Not repo writer, user does not have rights to toggle stopwatch"
- },
- "404": {
- "description": "Issue not found"
- },
- "409": {
- "description": "Cannot stop a non existent stopwatch"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/keys": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repository's keys",
- "operationId": "repoListKeys",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "description": "the key_id to search for",
- "name": "key_id",
- "in": "query"
- },
- {
- "type": "string",
- "description": "fingerprint of the key",
- "name": "fingerprint",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/DeployKeyList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Add a key to a repository",
- "operationId": "repoCreateKey",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateKeyOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/DeployKey"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/keys/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a repository's key by id",
- "operationId": "repoGetKey",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the key to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/DeployKey"
- }
- }
- },
- "delete": {
- "tags": [
- "repository"
- ],
- "summary": "Delete a key from a repository",
- "operationId": "repoDeleteKey",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the key to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/labels": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Get all of a repository's labels",
- "operationId": "issueListLabels",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/LabelList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Create a label",
- "operationId": "issueCreateLabel",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateLabelOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Label"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/labels/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Get a single label",
- "operationId": "issueGetLabel",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the label to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Label"
- }
- }
- },
- "delete": {
- "tags": [
- "issue"
- ],
- "summary": "Delete a label",
- "operationId": "issueDeleteLabel",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the label to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Update a label",
- "operationId": "issueEditLabel",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the label to edit",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditLabelOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Label"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/milestones": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Get all of a repository's opened milestones",
- "operationId": "issueGetMilestonesList",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "Milestone state, Recognised values are open, closed and all. Defaults to \"open\"",
- "name": "state",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/MilestoneList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Create a milestone",
- "operationId": "issueCreateMilestone",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateMilestoneOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Milestone"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/milestones/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Get a milestone",
- "operationId": "issueGetMilestone",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the milestone",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Milestone"
- }
- }
- },
- "delete": {
- "tags": [
- "issue"
- ],
- "summary": "Delete a milestone",
- "operationId": "issueDeleteMilestone",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the milestone to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "issue"
- ],
- "summary": "Update a milestone",
- "operationId": "issueEditMilestone",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the milestone",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditMilestoneOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Milestone"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/mirror-sync": {
- "post": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Sync a mirrored repository",
- "operationId": "repoMirrorSync",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo to sync",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to sync",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/pulls": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repo's pull requests",
- "operationId": "repoListPullRequests",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "description": "Page number",
- "name": "page",
- "in": "query"
- },
- {
- "enum": [
- "closed",
- "open",
- "all"
- ],
- "type": "string",
- "description": "State of pull request: open or closed (optional)",
- "name": "state",
- "in": "query"
- },
- {
- "enum": [
- "oldest",
- "recentupdate",
- "leastupdate",
- "mostcomment",
- "leastcomment",
- "priority"
- ],
- "type": "string",
- "description": "Type of sort",
- "name": "sort",
- "in": "query"
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "ID of the milestone",
- "name": "milestone",
- "in": "query"
- },
- {
- "type": "array",
- "items": {
- "type": "integer",
- "format": "int64"
- },
- "collectionFormat": "multi",
- "description": "Label IDs",
- "name": "labels",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/PullRequestList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Create a pull request",
- "operationId": "repoCreatePullRequest",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreatePullRequestOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/PullRequest"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/pulls/{index}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a pull request",
- "operationId": "repoGetPullRequest",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the pull request to get",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/PullRequest"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Update a pull request",
- "operationId": "repoEditPullRequest",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the pull request to edit",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditPullRequestOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/PullRequest"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/pulls/{index}/merge": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Check if a pull request has been merged",
- "operationId": "repoPullRequestIsMerged",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the pull request",
- "name": "index",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "description": "pull request has been merged"
- },
- "404": {
- "description": "pull request has not been merged"
- }
- }
- },
- "post": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Merge a pull request",
- "operationId": "repoMergePullRequest",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "index of the pull request to merge",
- "name": "index",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/MergePullRequestOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/empty"
- },
- "405": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/raw/{filepath}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a file from a repository",
- "operationId": "repoGetRawFile",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "filepath of the file to get",
- "name": "filepath",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "description": "success"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/releases": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repo's releases",
- "operationId": "repoListReleases",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "description": "page wants to load",
- "name": "page",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "items count every page wants to load",
- "name": "per_page",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/ReleaseList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Create a release",
- "operationId": "repoCreateRelease",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateReleaseOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Release"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/releases/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a release",
- "operationId": "repoGetRelease",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Release"
- }
- }
- },
- "delete": {
- "tags": [
- "repository"
- ],
- "summary": "Delete a release",
- "operationId": "repoDeleteRelease",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Update a release",
- "operationId": "repoEditRelease",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release to edit",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditReleaseOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Release"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/releases/{id}/assets": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List release's attachments",
- "operationId": "repoListReleaseAttachments",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/AttachmentList"
- }
- }
- },
- "post": {
- "consumes": [
- "multipart/form-data"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Create a release attachment",
- "operationId": "repoCreateReleaseAttachment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the attachment",
- "name": "name",
- "in": "query"
- },
- {
- "type": "file",
- "description": "attachment to upload",
- "name": "attachment",
- "in": "formData",
- "required": true
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Attachment"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a release attachment",
- "operationId": "repoGetReleaseAttachment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the attachment to get",
- "name": "attachment_id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Attachment"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Delete a release attachment",
- "operationId": "repoDeleteReleaseAttachment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the attachment to delete",
- "name": "attachment_id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Edit a release attachment",
- "operationId": "repoEditReleaseAttachment",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the release",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the attachment to edit",
- "name": "attachment_id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditAttachmentOptions"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Attachment"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/stargazers": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repo's stargazers",
- "operationId": "repoListStargazers",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/statuses/{sha}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a commit's statuses",
- "operationId": "repoListStatuses",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "sha of the commit",
- "name": "sha",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/StatusList"
- }
- }
- },
- "post": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Create a commit status",
- "operationId": "repoCreateStatus",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "sha of the commit",
- "name": "sha",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateStatusOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/StatusList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/subscribers": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repo's watchers",
- "operationId": "repoListSubscribers",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/subscription": {
- "get": {
- "tags": [
- "repository"
- ],
- "summary": "Check if the current user is watching a repo",
- "operationId": "userCurrentCheckSubscription",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/WatchInfo"
- }
- }
- },
- "put": {
- "tags": [
- "repository"
- ],
- "summary": "Watch a repo",
- "operationId": "userCurrentPutSubscription",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/WatchInfo"
- }
- }
- },
- "delete": {
- "tags": [
- "repository"
- ],
- "summary": "Unwatch a repo",
- "operationId": "userCurrentDeleteSubscription",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/tags": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repository's tags",
- "operationId": "repoListTags",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/TagList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/times": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "List a repo's tracked times",
- "operationId": "repoTrackedTimes",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/TrackedTimeList"
- }
- }
- }
- },
- "/repos/{owner}/{repo}/times/{user}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List a user's tracked times in a repo",
- "operationId": "userTrackedTimes",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of user",
- "name": "user",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/TrackedTimeList"
- }
- }
- }
- },
- "/repositories/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "Get a repository by id",
- "operationId": "repoGetByID",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the repo to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Repository"
- }
- }
- }
- },
- "/teams/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Get a team",
- "operationId": "orgGetTeam",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Team"
- }
- }
- },
- "delete": {
- "tags": [
- "organization"
- ],
- "summary": "Delete a team",
- "operationId": "orgDeleteTeam",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "description": "team deleted"
- }
- }
- },
- "patch": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Edit a team",
- "operationId": "orgEditTeam",
- "parameters": [
- {
- "type": "integer",
- "description": "id of the team to edit",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/EditTeamOption"
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Team"
- }
- }
- }
- },
- "/teams/{id}/members": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List a team's members",
- "operationId": "orgListTeamMembers",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/teams/{id}/members/{username}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List a particular member of team",
- "operationId": "orgListTeamMember",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the member to list",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/User"
- }
- }
- },
- "put": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Add a team member",
- "operationId": "orgAddTeamMember",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user to add",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Remove a team member",
- "operationId": "orgRemoveTeamMember",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of the user to remove",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/teams/{id}/repos": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List a team's repos",
- "operationId": "orgListTeamRepos",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/teams/{id}/repos/{org}/{repo}": {
- "put": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Add a repository to a team",
- "operationId": "orgAddTeamRepository",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "organization that owns the repo to add",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to add",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "delete": {
- "description": "This does not delete the repository, it only removes the repository from the team.",
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "Remove a repository from a team",
- "operationId": "orgRemoveTeamRepository",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of the team",
- "name": "id",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "organization that owns the repo to remove",
- "name": "org",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to remove",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/topics/search": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository"
- ],
- "summary": "search topics via keyword",
- "operationId": "topicSearch",
- "parameters": [
- {
- "type": "string",
- "description": "keywords to search",
- "name": "q",
- "in": "query",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/Repository"
- }
- }
- }
- },
- "/user": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Get the authenticated user",
- "operationId": "userGetCurrent",
- "responses": {
- "200": {
- "$ref": "#/responses/User"
- }
- }
- }
- },
- "/user/emails": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the authenticated user's email addresses",
- "operationId": "userListEmails",
- "responses": {
- "200": {
- "$ref": "#/responses/EmailList"
- }
- }
- },
- "post": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Add email addresses",
- "operationId": "userAddEmail",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateEmailOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/EmailList"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Delete email addresses",
- "operationId": "userDeleteEmail",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/DeleteEmailOption"
- }
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/user/followers": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the authenticated user's followers",
- "operationId": "userCurrentListFollowers",
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/user/following": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the users that the authenticated user is following",
- "operationId": "userCurrentListFollowing",
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/user/following/{username}": {
- "get": {
- "tags": [
- "user"
- ],
- "summary": "Check whether a user is followed by the authenticated user",
- "operationId": "userCurrentCheckFollowing",
- "parameters": [
- {
- "type": "string",
- "description": "username of followed user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "put": {
- "tags": [
- "user"
- ],
- "summary": "Follow a user",
- "operationId": "userCurrentPutFollow",
- "parameters": [
- {
- "type": "string",
- "description": "username of user to follow",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "delete": {
- "tags": [
- "user"
- ],
- "summary": "Unfollow a user",
- "operationId": "userCurrentDeleteFollow",
- "parameters": [
- {
- "type": "string",
- "description": "username of user to unfollow",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/user/gpg_keys": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the authenticated user's GPG keys",
- "operationId": "userCurrentListGPGKeys",
- "responses": {
- "200": {
- "$ref": "#/responses/GPGKeyList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Create a GPG key",
- "operationId": "userCurrentPostGPGKey",
- "parameters": [
- {
- "name": "Form",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateGPGKeyOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/GPGKey"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/user/gpg_keys/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Get a GPG key",
- "operationId": "userCurrentGetGPGKey",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of key to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GPGKey"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Remove a GPG key",
- "operationId": "userCurrentDeleteGPGKey",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of key to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- }
- }
- }
- },
- "/user/keys": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the authenticated user's public keys",
- "operationId": "userCurrentListKeys",
- "parameters": [
- {
- "type": "string",
- "description": "fingerprint of the key",
- "name": "fingerprint",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/PublicKeyList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Create a public key",
- "operationId": "userCurrentPostKey",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateKeyOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/PublicKey"
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/user/keys/{id}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Get a public key",
- "operationId": "userCurrentGetKey",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of key to get",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/PublicKey"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Delete a public key",
- "operationId": "userCurrentDeleteKey",
- "parameters": [
- {
- "type": "integer",
- "format": "int64",
- "description": "id of key to delete",
- "name": "id",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "403": {
- "$ref": "#/responses/forbidden"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/user/orgs": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List the current user's organizations",
- "operationId": "orgListCurrentUserOrgs",
- "responses": {
- "200": {
- "$ref": "#/responses/OrganizationList"
- }
- }
- }
- },
- "/user/repos": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the repos that the authenticated user owns or has access to",
- "operationId": "userCurrentListRepos",
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "repository",
- "user"
- ],
- "summary": "Create a repository",
- "operationId": "createCurrentUserRepo",
- "parameters": [
- {
- "name": "body",
- "in": "body",
- "schema": {
- "$ref": "#/definitions/CreateRepoOption"
- }
- }
- ],
- "responses": {
- "201": {
- "$ref": "#/responses/Repository"
- },
- "409": {
- "description": "The repository with the same name already exists."
- },
- "422": {
- "$ref": "#/responses/validationError"
- }
- }
- }
- },
- "/user/starred": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "The repos that the authenticated user has starred",
- "operationId": "userCurrentListStarred",
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/user/starred/{owner}/{repo}": {
- "get": {
- "tags": [
- "user"
- ],
- "summary": "Whether the authenticated is starring the repo",
- "operationId": "userCurrentCheckStarring",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- },
- "put": {
- "tags": [
- "user"
- ],
- "summary": "Star the given repo",
- "operationId": "userCurrentPutStar",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo to star",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to star",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- },
- "delete": {
- "tags": [
- "user"
- ],
- "summary": "Unstar the given repo",
- "operationId": "userCurrentDeleteStar",
- "parameters": [
- {
- "type": "string",
- "description": "owner of the repo to unstar",
- "name": "owner",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "name of the repo to unstar",
- "name": "repo",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/user/subscriptions": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List repositories watched by the authenticated user",
- "operationId": "userCurrentListSubscriptions",
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/user/teams": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List all the teams a user belongs to",
- "operationId": "userListTeams",
- "responses": {
- "200": {
- "$ref": "#/responses/TeamList"
- }
- }
- }
- },
- "/user/times": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the current user's tracked times",
- "operationId": "userCurrentTrackedTimes",
- "responses": {
- "200": {
- "$ref": "#/responses/TrackedTimeList"
- }
- }
- }
- },
- "/users/search": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Search for users",
- "operationId": "userSearch",
- "parameters": [
- {
- "type": "string",
- "description": "keyword",
- "name": "q",
- "in": "query"
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "ID of the user to search for",
- "name": "uid",
- "in": "query"
- },
- {
- "type": "integer",
- "description": "maximum number of users to return",
- "name": "limit",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "description": "SearchResults of a successful search",
- "schema": {
- "type": "object",
- "properties": {
- "data": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/User"
- }
- },
- "ok": {
- "type": "boolean"
- }
- }
- }
- }
- }
- }
- },
- "/users/{follower}/following/{followee}": {
- "get": {
- "tags": [
- "user"
- ],
- "summary": "Check if one user is following another user",
- "operationId": "userCheckFollowing",
- "parameters": [
- {
- "type": "string",
- "description": "username of following user",
- "name": "follower",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "username of followed user",
- "name": "followee",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/users/{username}": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Get a user",
- "operationId": "userGet",
- "parameters": [
- {
- "type": "string",
- "description": "username of user to get",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/User"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/users/{username}/followers": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the given user's followers",
- "operationId": "userListFollowers",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/users/{username}/following": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the users that the given user is following",
- "operationId": "userListFollowing",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserList"
- }
- }
- }
- },
- "/users/{username}/gpg_keys": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the given user's GPG keys",
- "operationId": "userListGPGKeys",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/GPGKeyList"
- }
- }
- }
- },
- "/users/{username}/heatmap": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Get a user's heatmap",
- "operationId": "userGetHeatmapData",
- "parameters": [
- {
- "type": "string",
- "description": "username of user to get",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/UserHeatmapData"
- },
- "404": {
- "$ref": "#/responses/notFound"
- }
- }
- }
- },
- "/users/{username}/keys": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the given user's public keys",
- "operationId": "userListKeys",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "type": "string",
- "description": "fingerprint of the key",
- "name": "fingerprint",
- "in": "query"
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/PublicKeyList"
- }
- }
- }
- },
- "/users/{username}/orgs": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "organization"
- ],
- "summary": "List a user's organizations",
- "operationId": "orgListUserOrgs",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/OrganizationList"
- }
- }
- }
- },
- "/users/{username}/repos": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the repos owned by the given user",
- "operationId": "userListRepos",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/users/{username}/starred": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "The repos that the given user has starred",
- "operationId": "userListStarred",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/users/{username}/subscriptions": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the repositories watched by a user",
- "operationId": "userListSubscriptions",
- "parameters": [
- {
- "type": "string",
- "description": "username of the user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/RepositoryList"
- }
- }
- }
- },
- "/users/{username}/tokens": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "List the authenticated user's access tokens",
- "operationId": "userGetTokens",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/AccessTokenList"
- }
- }
- },
- "post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "Create an access token",
- "operationId": "userCreateToken",
- "parameters": [
- {
- "type": "string",
- "x-go-name": "Name",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "name": "accessToken",
- "in": "body",
- "schema": {
- "type": "object",
- "required": [
- "name"
- ],
- "properties": {
- "name": {
- "type": "string"
- }
- }
- }
- }
- ],
- "responses": {
- "200": {
- "$ref": "#/responses/AccessToken"
- }
- }
- }
- },
- "/users/{username}/tokens/{token}": {
- "delete": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "user"
- ],
- "summary": "delete an access token",
- "operationId": "userDeleteAccessToken",
- "parameters": [
- {
- "type": "string",
- "description": "username of user",
- "name": "username",
- "in": "path",
- "required": true
- },
- {
- "type": "integer",
- "format": "int64",
- "description": "token to be deleted",
- "name": "token",
- "in": "path",
- "required": true
- }
- ],
- "responses": {
- "204": {
- "$ref": "#/responses/empty"
- }
- }
- }
- },
- "/version": {
- "get": {
- "produces": [
- "application/json"
- ],
- "tags": [
- "miscellaneous"
- ],
- "summary": "Returns the version of the Gitea application",
- "operationId": "getVersion",
- "responses": {
- "200": {
- "$ref": "#/responses/ServerVersion"
- }
- }
- }
- }
- },
- "definitions": {
- "AccessToken": {
- "type": "object",
- "title": "AccessToken represents an API access token.",
- "properties": {
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "sha1": {
- "type": "string",
- "x-go-name": "Token"
- },
- "token_last_eight": {
- "type": "string",
- "x-go-name": "TokenLastEight"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "AddCollaboratorOption": {
- "description": "AddCollaboratorOption options when adding a user as a collaborator of a repository",
- "type": "object",
- "properties": {
- "permission": {
- "type": "string",
- "x-go-name": "Permission"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "AddTimeOption": {
- "description": "AddTimeOption options for adding time to an issue",
- "type": "object",
- "required": [
- "time"
- ],
- "properties": {
- "time": {
- "description": "time in seconds",
- "type": "integer",
- "format": "int64",
- "x-go-name": "Time"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "AnnotatedTag": {
- "description": "AnnotatedTag represents an annotated tag",
- "type": "object",
- "properties": {
- "message": {
- "type": "string",
- "x-go-name": "Message"
- },
- "object": {
- "$ref": "#/definitions/AnnotatedTagObject"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "tag": {
- "type": "string",
- "x-go-name": "Tag"
- },
- "tagger": {
- "$ref": "#/definitions/CommitUser"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- },
- "verification": {
- "$ref": "#/definitions/PayloadCommitVerification"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "AnnotatedTagObject": {
- "description": "AnnotatedTagObject contains meta information of the tag object",
- "type": "object",
- "properties": {
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "type": {
- "type": "string",
- "x-go-name": "Type"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Attachment": {
- "description": "Attachment a generic attachment",
- "type": "object",
- "properties": {
- "browser_download_url": {
- "type": "string",
- "x-go-name": "DownloadURL"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "download_count": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "DownloadCount"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "size": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Size"
- },
- "uuid": {
- "type": "string",
- "x-go-name": "UUID"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Branch": {
- "description": "Branch represents a repository branch",
- "type": "object",
- "properties": {
- "commit": {
- "$ref": "#/definitions/PayloadCommit"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Comment": {
- "description": "Comment represents a comment on a commit or issue",
- "type": "object",
- "properties": {
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "html_url": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "issue_url": {
- "type": "string",
- "x-go-name": "IssueURL"
- },
- "pull_request_url": {
- "type": "string",
- "x-go-name": "PRURL"
- },
- "updated_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Updated"
- },
- "user": {
- "$ref": "#/definitions/User"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Commit": {
- "type": "object",
- "title": "Commit contains information generated from a Git commit.",
- "properties": {
- "author": {
- "$ref": "#/definitions/User"
- },
- "commit": {
- "$ref": "#/definitions/RepoCommit"
- },
- "committer": {
- "$ref": "#/definitions/User"
- },
- "html_url": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "parents": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/CommitMeta"
- },
- "x-go-name": "Parents"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CommitMeta": {
- "type": "object",
- "title": "CommitMeta contains meta information of a commit in terms of API.",
- "properties": {
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CommitUser": {
- "type": "object",
- "title": "CommitUser contains information of a user in the context of a commit.",
- "properties": {
- "date": {
- "type": "string",
- "x-go-name": "Date"
- },
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "ContentsResponse": {
- "description": "ContentsResponse contains information about a repo's entry's (dir, file, symlink, submodule) metadata and content",
- "type": "object",
- "properties": {
- "_links": {
- "$ref": "#/definitions/FileLinksResponse"
- },
- "content": {
- "description": "`content` is populated when `type` is `file`, otherwise null",
- "type": "string",
- "x-go-name": "Content"
- },
- "download_url": {
- "type": "string",
- "x-go-name": "DownloadURL"
- },
- "encoding": {
- "description": "`encoding` is populated when `type` is `file`, otherwise null",
- "type": "string",
- "x-go-name": "Encoding"
- },
- "git_url": {
- "type": "string",
- "x-go-name": "GitURL"
- },
- "html_url": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "path": {
- "type": "string",
- "x-go-name": "Path"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "size": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Size"
- },
- "submodule_git_url": {
- "description": "`submodule_git_url` is populated when `type` is `submodule`, otherwise null",
- "type": "string",
- "x-go-name": "SubmoduleGitURL"
- },
- "target": {
- "description": "`target` is populated when `type` is `symlink`, otherwise null",
- "type": "string",
- "x-go-name": "Target"
- },
- "type": {
- "description": "`type` will be `file`, `dir`, `symlink`, or `submodule`",
- "type": "string",
- "x-go-name": "Type"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateEmailOption": {
- "description": "CreateEmailOption options when creating email addresses",
- "type": "object",
- "properties": {
- "emails": {
- "description": "email addresses to add",
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Emails"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateFileOptions": {
- "description": "CreateFileOptions options for creating files\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)",
- "type": "object",
- "required": [
- "content"
- ],
- "properties": {
- "author": {
- "$ref": "#/definitions/Identity"
- },
- "branch": {
- "description": "branch (optional) to base this file from. if not given, the default branch is used",
- "type": "string",
- "x-go-name": "BranchName"
- },
- "committer": {
- "$ref": "#/definitions/Identity"
- },
- "content": {
- "description": "content must be base64 encoded",
- "type": "string",
- "x-go-name": "Content"
- },
- "message": {
- "description": "message (optional) for the commit of this file. if not supplied, a default message will be used",
- "type": "string",
- "x-go-name": "Message"
- },
- "new_branch": {
- "description": "new_branch (optional) will make a new branch from `branch` before creating the file",
- "type": "string",
- "x-go-name": "NewBranchName"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateForkOption": {
- "description": "CreateForkOption options for creating a fork",
- "type": "object",
- "properties": {
- "organization": {
- "description": "organization name, if forking into an organization",
- "type": "string",
- "x-go-name": "Organization"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateGPGKeyOption": {
- "description": "CreateGPGKeyOption options create user GPG key",
- "type": "object",
- "required": [
- "armored_public_key"
- ],
- "properties": {
- "armored_public_key": {
- "description": "An armored GPG key to add",
- "type": "string",
- "uniqueItems": true,
- "x-go-name": "ArmoredKey"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateHookOption": {
- "description": "CreateHookOption options when create a hook",
- "type": "object",
- "required": [
- "type",
- "config"
- ],
- "properties": {
- "active": {
- "type": "boolean",
- "default": false,
- "x-go-name": "Active"
- },
- "config": {
- "type": "object",
- "additionalProperties": {
- "type": "string"
- },
- "x-go-name": "Config"
- },
- "events": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Events"
- },
- "type": {
- "type": "string",
- "enum": [
- "gitea",
- "gogs",
- "slack",
- "discord"
- ],
- "x-go-name": "Type"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateIssueCommentOption": {
- "description": "CreateIssueCommentOption options for creating a comment on an issue",
- "type": "object",
- "required": [
- "body"
- ],
- "properties": {
- "body": {
- "type": "string",
- "x-go-name": "Body"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateIssueOption": {
- "description": "CreateIssueOption options to create one issue",
- "type": "object",
- "required": [
- "title"
- ],
- "properties": {
- "assignee": {
- "description": "username of assignee",
- "type": "string",
- "x-go-name": "Assignee"
- },
- "assignees": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Assignees"
- },
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "closed": {
- "type": "boolean",
- "x-go-name": "Closed"
- },
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "labels": {
- "description": "list of label ids",
- "type": "array",
- "items": {
- "type": "integer",
- "format": "int64"
- },
- "x-go-name": "Labels"
- },
- "milestone": {
- "description": "milestone id",
- "type": "integer",
- "format": "int64",
- "x-go-name": "Milestone"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateKeyOption": {
- "description": "CreateKeyOption options when creating a key",
- "type": "object",
- "required": [
- "title",
- "key"
- ],
- "properties": {
- "key": {
- "description": "An armored SSH key to add",
- "type": "string",
- "uniqueItems": true,
- "x-go-name": "Key"
- },
- "read_only": {
- "description": "Describe if the key has only read access or read/write",
- "type": "boolean",
- "x-go-name": "ReadOnly"
- },
- "title": {
- "description": "Title of the key to add",
- "type": "string",
- "uniqueItems": true,
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateLabelOption": {
- "description": "CreateLabelOption options for creating a label",
- "type": "object",
- "required": [
- "name",
- "color"
- ],
- "properties": {
- "color": {
- "type": "string",
- "x-go-name": "Color",
- "example": "#00aabb"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateMilestoneOption": {
- "description": "CreateMilestoneOption options for creating a milestone",
- "type": "object",
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "due_on": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateOrgOption": {
- "description": "CreateOrgOption options for creating an organization",
- "type": "object",
- "required": [
- "username"
- ],
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "full_name": {
- "type": "string",
- "x-go-name": "FullName"
- },
- "location": {
- "type": "string",
- "x-go-name": "Location"
- },
- "username": {
- "type": "string",
- "x-go-name": "UserName"
- },
- "visibility": {
- "description": "possible values are `public` (default), `limited` or `private`",
- "type": "string",
- "enum": [
- "public",
- "limited",
- "private"
- ],
- "x-go-name": "Visibility"
- },
- "website": {
- "type": "string",
- "x-go-name": "Website"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreatePullRequestOption": {
- "description": "CreatePullRequestOption options when creating a pull request",
- "type": "object",
- "properties": {
- "assignee": {
- "type": "string",
- "x-go-name": "Assignee"
- },
- "assignees": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Assignees"
- },
- "base": {
- "type": "string",
- "x-go-name": "Base"
- },
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "head": {
- "type": "string",
- "x-go-name": "Head"
- },
- "labels": {
- "type": "array",
- "items": {
- "type": "integer",
- "format": "int64"
- },
- "x-go-name": "Labels"
- },
- "milestone": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Milestone"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateReleaseOption": {
- "description": "CreateReleaseOption options when creating a release",
- "type": "object",
- "required": [
- "tag_name"
- ],
- "properties": {
- "body": {
- "type": "string",
- "x-go-name": "Note"
- },
- "draft": {
- "type": "boolean",
- "x-go-name": "IsDraft"
- },
- "name": {
- "type": "string",
- "x-go-name": "Title"
- },
- "prerelease": {
- "type": "boolean",
- "x-go-name": "IsPrerelease"
- },
- "tag_name": {
- "type": "string",
- "x-go-name": "TagName"
- },
- "target_commitish": {
- "type": "string",
- "x-go-name": "Target"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateRepoOption": {
- "description": "CreateRepoOption options when creating repository",
- "type": "object",
- "required": [
- "name"
- ],
- "properties": {
- "auto_init": {
- "description": "Whether the repository should be auto-intialized?",
- "type": "boolean",
- "x-go-name": "AutoInit"
- },
- "description": {
- "description": "Description of the repository to create",
- "type": "string",
- "x-go-name": "Description"
- },
- "gitignores": {
- "description": "Gitignores to use",
- "type": "string",
- "x-go-name": "Gitignores"
- },
- "license": {
- "description": "License to use",
- "type": "string",
- "x-go-name": "License"
- },
- "name": {
- "description": "Name of the repository to create",
- "type": "string",
- "uniqueItems": true,
- "x-go-name": "Name"
- },
- "private": {
- "description": "Whether the repository is private",
- "type": "boolean",
- "x-go-name": "Private"
- },
- "readme": {
- "description": "Readme of the repository to create",
- "type": "string",
- "x-go-name": "Readme"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateStatusOption": {
- "description": "CreateStatusOption holds the information needed to create a new Status for a Commit",
- "type": "object",
- "properties": {
- "context": {
- "type": "string",
- "x-go-name": "Context"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "state": {
- "$ref": "#/definitions/StatusState"
- },
- "target_url": {
- "type": "string",
- "x-go-name": "TargetURL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateTeamOption": {
- "description": "CreateTeamOption options for creating a team",
- "type": "object",
- "required": [
- "name"
- ],
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "permission": {
- "type": "string",
- "enum": [
- "read",
- "write",
- "admin"
- ],
- "x-go-name": "Permission"
- },
- "units": {
- "type": "array",
- "enum": [
- "repo.code",
- "repo.issues",
- "repo.ext_issues",
- "repo.wiki",
- "repo.pulls",
- "repo.releases",
- "repo.ext_wiki"
- ],
- "items": {
- "type": "string"
- },
- "x-go-name": "Units"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "CreateUserOption": {
- "description": "CreateUserOption create user options",
- "type": "object",
- "required": [
- "username",
- "email",
- "password"
- ],
- "properties": {
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "full_name": {
- "type": "string",
- "x-go-name": "FullName"
- },
- "login_name": {
- "type": "string",
- "x-go-name": "LoginName"
- },
- "must_change_password": {
- "type": "boolean",
- "x-go-name": "MustChangePassword"
- },
- "password": {
- "type": "string",
- "x-go-name": "Password"
- },
- "send_notify": {
- "type": "boolean",
- "x-go-name": "SendNotify"
- },
- "source_id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "SourceID"
- },
- "username": {
- "type": "string",
- "x-go-name": "Username"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "DeleteEmailOption": {
- "description": "DeleteEmailOption options when deleting email addresses",
- "type": "object",
- "properties": {
- "emails": {
- "description": "email addresses to delete",
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Emails"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "DeleteFileOptions": {
- "description": "DeleteFileOptions options for deleting files (used for other File structs below)\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)",
- "type": "object",
- "required": [
- "sha"
- ],
- "properties": {
- "author": {
- "$ref": "#/definitions/Identity"
- },
- "branch": {
- "description": "branch (optional) to base this file from. if not given, the default branch is used",
- "type": "string",
- "x-go-name": "BranchName"
- },
- "committer": {
- "$ref": "#/definitions/Identity"
- },
- "message": {
- "description": "message (optional) for the commit of this file. if not supplied, a default message will be used",
- "type": "string",
- "x-go-name": "Message"
- },
- "new_branch": {
- "description": "new_branch (optional) will make a new branch from `branch` before creating the file",
- "type": "string",
- "x-go-name": "NewBranchName"
- },
- "sha": {
- "description": "sha is the SHA for the file that already exists",
- "type": "string",
- "x-go-name": "SHA"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "DeployKey": {
- "description": "DeployKey a deploy key",
- "type": "object",
- "properties": {
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "fingerprint": {
- "type": "string",
- "x-go-name": "Fingerprint"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "key": {
- "type": "string",
- "x-go-name": "Key"
- },
- "key_id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "KeyID"
- },
- "read_only": {
- "type": "boolean",
- "x-go-name": "ReadOnly"
- },
- "repository": {
- "$ref": "#/definitions/Repository"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditAttachmentOptions": {
- "description": "EditAttachmentOptions options for editing attachments",
- "type": "object",
- "properties": {
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditDeadlineOption": {
- "description": "EditDeadlineOption options for creating a deadline",
- "type": "object",
- "required": [
- "due_date"
- ],
- "properties": {
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditGitHookOption": {
- "description": "EditGitHookOption options when modifying one Git hook",
- "type": "object",
- "properties": {
- "content": {
- "type": "string",
- "x-go-name": "Content"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditHookOption": {
- "description": "EditHookOption options when modify one hook",
- "type": "object",
- "properties": {
- "active": {
- "type": "boolean",
- "x-go-name": "Active"
- },
- "config": {
- "type": "object",
- "additionalProperties": {
- "type": "string"
- },
- "x-go-name": "Config"
- },
- "events": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Events"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditIssueCommentOption": {
- "description": "EditIssueCommentOption options for editing a comment",
- "type": "object",
- "required": [
- "body"
- ],
- "properties": {
- "body": {
- "type": "string",
- "x-go-name": "Body"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditIssueOption": {
- "description": "EditIssueOption options for editing an issue",
- "type": "object",
- "properties": {
- "assignee": {
- "type": "string",
- "x-go-name": "Assignee"
- },
- "assignees": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Assignees"
- },
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "milestone": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Milestone"
- },
- "state": {
- "type": "string",
- "x-go-name": "State"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditLabelOption": {
- "description": "EditLabelOption options for editing a label",
- "type": "object",
- "properties": {
- "color": {
- "type": "string",
- "x-go-name": "Color"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditMilestoneOption": {
- "description": "EditMilestoneOption options for editing a milestone",
- "type": "object",
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "due_on": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "state": {
- "type": "string",
- "x-go-name": "State"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditOrgOption": {
- "description": "EditOrgOption options for editing an organization",
- "type": "object",
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "full_name": {
- "type": "string",
- "x-go-name": "FullName"
- },
- "location": {
- "type": "string",
- "x-go-name": "Location"
- },
- "visibility": {
- "description": "possible values are `public`, `limited` or `private`",
- "type": "string",
- "enum": [
- "public",
- "limited",
- "private"
- ],
- "x-go-name": "Visibility"
- },
- "website": {
- "type": "string",
- "x-go-name": "Website"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditPullRequestOption": {
- "description": "EditPullRequestOption options when modify pull request",
- "type": "object",
- "properties": {
- "assignee": {
- "type": "string",
- "x-go-name": "Assignee"
- },
- "assignees": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Assignees"
- },
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "labels": {
- "type": "array",
- "items": {
- "type": "integer",
- "format": "int64"
- },
- "x-go-name": "Labels"
- },
- "milestone": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Milestone"
- },
- "state": {
- "type": "string",
- "x-go-name": "State"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditReleaseOption": {
- "description": "EditReleaseOption options when editing a release",
- "type": "object",
- "properties": {
- "body": {
- "type": "string",
- "x-go-name": "Note"
- },
- "draft": {
- "type": "boolean",
- "x-go-name": "IsDraft"
- },
- "name": {
- "type": "string",
- "x-go-name": "Title"
- },
- "prerelease": {
- "type": "boolean",
- "x-go-name": "IsPrerelease"
- },
- "tag_name": {
- "type": "string",
- "x-go-name": "TagName"
- },
- "target_commitish": {
- "type": "string",
- "x-go-name": "Target"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditRepoOption": {
- "description": "EditRepoOption options when editing a repository's properties",
- "type": "object",
- "properties": {
- "allow_merge_commits": {
- "description": "either `true` to allow merging pull requests with a merge commit, or `false` to prevent merging pull requests with merge commits. `has_pull_requests` must be `true`.",
- "type": "boolean",
- "x-go-name": "AllowMerge"
- },
- "allow_rebase": {
- "description": "either `true` to allow rebase-merging pull requests, or `false` to prevent rebase-merging. `has_pull_requests` must be `true`.",
- "type": "boolean",
- "x-go-name": "AllowRebase"
- },
- "allow_rebase_explicit": {
- "description": "either `true` to allow rebase with explicit merge commits (--no-ff), or `false` to prevent rebase with explicit merge commits. `has_pull_requests` must be `true`.",
- "type": "boolean",
- "x-go-name": "AllowRebaseMerge"
- },
- "allow_squash_merge": {
- "description": "either `true` to allow squash-merging pull requests, or `false` to prevent squash-merging. `has_pull_requests` must be `true`.",
- "type": "boolean",
- "x-go-name": "AllowSquash"
- },
- "archived": {
- "description": "set to `true` to archive this repository.",
- "type": "boolean",
- "x-go-name": "Archived"
- },
- "default_branch": {
- "description": "sets the default branch for this repository.",
- "type": "string",
- "x-go-name": "DefaultBranch"
- },
- "description": {
- "description": "a short description of the repository.",
- "type": "string",
- "x-go-name": "Description"
- },
- "has_issues": {
- "description": "either `true` to enable issues for this repository or `false` to disable them.",
- "type": "boolean",
- "x-go-name": "HasIssues"
- },
- "has_pull_requests": {
- "description": "either `true` to allow pull requests, or `false` to prevent pull request.",
- "type": "boolean",
- "x-go-name": "HasPullRequests"
- },
- "has_wiki": {
- "description": "either `true` to enable the wiki for this repository or `false` to disable it.",
- "type": "boolean",
- "x-go-name": "HasWiki"
- },
- "ignore_whitespace_conflicts": {
- "description": "either `true` to ignore whitespace for conflicts, or `false` to not ignore whitespace. `has_pull_requests` must be `true`.",
- "type": "boolean",
- "x-go-name": "IgnoreWhitespaceConflicts"
- },
- "name": {
- "description": "name of the repository",
- "type": "string",
- "uniqueItems": true,
- "x-go-name": "Name"
- },
- "private": {
- "description": "either `true` to make the repository private or `false` to make it public.\nNote: you will get a 422 error if the organization restricts changing repository visibility to organization\nowners and a non-owner tries to change the value of private.",
- "type": "boolean",
- "x-go-name": "Private"
- },
- "website": {
- "description": "a URL with more information about the repository.",
- "type": "string",
- "x-go-name": "Website"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditTeamOption": {
- "description": "EditTeamOption options for editing a team",
- "type": "object",
- "required": [
- "name"
- ],
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "permission": {
- "type": "string",
- "enum": [
- "read",
- "write",
- "admin"
- ],
- "x-go-name": "Permission"
- },
- "units": {
- "type": "array",
- "enum": [
- "repo.code",
- "repo.issues",
- "repo.ext_issues",
- "repo.wiki",
- "repo.pulls",
- "repo.releases",
- "repo.ext_wiki"
- ],
- "items": {
- "type": "string"
- },
- "x-go-name": "Units"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "EditUserOption": {
- "description": "EditUserOption edit user options",
- "type": "object",
- "required": [
- "email"
- ],
- "properties": {
- "active": {
- "type": "boolean",
- "x-go-name": "Active"
- },
- "admin": {
- "type": "boolean",
- "x-go-name": "Admin"
- },
- "allow_create_organization": {
- "type": "boolean",
- "x-go-name": "AllowCreateOrganization"
- },
- "allow_git_hook": {
- "type": "boolean",
- "x-go-name": "AllowGitHook"
- },
- "allow_import_local": {
- "type": "boolean",
- "x-go-name": "AllowImportLocal"
- },
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "full_name": {
- "type": "string",
- "x-go-name": "FullName"
- },
- "location": {
- "type": "string",
- "x-go-name": "Location"
- },
- "login_name": {
- "type": "string",
- "x-go-name": "LoginName"
- },
- "max_repo_creation": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "MaxRepoCreation"
- },
- "must_change_password": {
- "type": "boolean",
- "x-go-name": "MustChangePassword"
- },
- "password": {
- "type": "string",
- "x-go-name": "Password"
- },
- "prohibit_login": {
- "type": "boolean",
- "x-go-name": "ProhibitLogin"
- },
- "source_id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "SourceID"
- },
- "website": {
- "type": "string",
- "x-go-name": "Website"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Email": {
- "description": "Email an email address belonging to a user",
- "type": "object",
- "properties": {
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "primary": {
- "type": "boolean",
- "x-go-name": "Primary"
- },
- "verified": {
- "type": "boolean",
- "x-go-name": "Verified"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "FileCommitResponse": {
- "type": "object",
- "title": "FileCommitResponse contains information generated from a Git commit for a repo's file.",
- "properties": {
- "author": {
- "$ref": "#/definitions/CommitUser"
- },
- "committer": {
- "$ref": "#/definitions/CommitUser"
- },
- "html_url": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "message": {
- "type": "string",
- "x-go-name": "Message"
- },
- "parents": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/CommitMeta"
- },
- "x-go-name": "Parents"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "tree": {
- "$ref": "#/definitions/CommitMeta"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "FileDeleteResponse": {
- "description": "FileDeleteResponse contains information about a repo's file that was deleted",
- "type": "object",
- "properties": {
- "commit": {
- "$ref": "#/definitions/FileCommitResponse"
- },
- "content": {
- "type": "object",
- "x-go-name": "Content"
- },
- "verification": {
- "$ref": "#/definitions/PayloadCommitVerification"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "FileLinksResponse": {
- "description": "FileLinksResponse contains the links for a repo's file",
- "type": "object",
- "properties": {
- "git": {
- "type": "string",
- "x-go-name": "GitURL"
- },
- "html": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "self": {
- "type": "string",
- "x-go-name": "Self"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "FileResponse": {
- "description": "FileResponse contains information about a repo's file",
- "type": "object",
- "properties": {
- "commit": {
- "$ref": "#/definitions/FileCommitResponse"
- },
- "content": {
- "$ref": "#/definitions/ContentsResponse"
- },
- "verification": {
- "$ref": "#/definitions/PayloadCommitVerification"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GPGKey": {
- "description": "GPGKey a user GPG key to sign commit and tag in repository",
- "type": "object",
- "properties": {
- "can_certify": {
- "type": "boolean",
- "x-go-name": "CanCertify"
- },
- "can_encrypt_comms": {
- "type": "boolean",
- "x-go-name": "CanEncryptComms"
- },
- "can_encrypt_storage": {
- "type": "boolean",
- "x-go-name": "CanEncryptStorage"
- },
- "can_sign": {
- "type": "boolean",
- "x-go-name": "CanSign"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "emails": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/GPGKeyEmail"
- },
- "x-go-name": "Emails"
- },
- "expires_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Expires"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "key_id": {
- "type": "string",
- "x-go-name": "KeyID"
- },
- "primary_key_id": {
- "type": "string",
- "x-go-name": "PrimaryKeyID"
- },
- "public_key": {
- "type": "string",
- "x-go-name": "PublicKey"
- },
- "subkeys": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/GPGKey"
- },
- "x-go-name": "SubsKey"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GPGKeyEmail": {
- "description": "GPGKeyEmail an email attached to a GPGKey",
- "type": "object",
- "properties": {
- "email": {
- "type": "string",
- "x-go-name": "Email"
- },
- "verified": {
- "type": "boolean",
- "x-go-name": "Verified"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GitBlobResponse": {
- "description": "GitBlobResponse represents a git blob",
- "type": "object",
- "properties": {
- "content": {
- "type": "string",
- "x-go-name": "Content"
- },
- "encoding": {
- "type": "string",
- "x-go-name": "Encoding"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "size": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Size"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GitEntry": {
- "description": "GitEntry represents a git tree",
- "type": "object",
- "properties": {
- "mode": {
- "type": "string",
- "x-go-name": "Mode"
- },
- "path": {
- "type": "string",
- "x-go-name": "Path"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "size": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Size"
- },
- "type": {
- "type": "string",
- "x-go-name": "Type"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GitHook": {
- "description": "GitHook represents a Git repository hook",
- "type": "object",
- "properties": {
- "content": {
- "type": "string",
- "x-go-name": "Content"
- },
- "is_active": {
- "type": "boolean",
- "x-go-name": "IsActive"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GitObject": {
- "type": "object",
- "title": "GitObject represents a Git object.",
- "properties": {
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "type": {
- "type": "string",
- "x-go-name": "Type"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "GitTreeResponse": {
- "description": "GitTreeResponse returns a git tree",
- "type": "object",
- "properties": {
- "page": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Page"
- },
- "sha": {
- "type": "string",
- "x-go-name": "SHA"
- },
- "total_count": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "TotalCount"
- },
- "tree": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/GitEntry"
- },
- "x-go-name": "Entries"
- },
- "truncated": {
- "type": "boolean",
- "x-go-name": "Truncated"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Hook": {
- "description": "Hook a hook is a web hook when one repository changed",
- "type": "object",
- "properties": {
- "active": {
- "type": "boolean",
- "x-go-name": "Active"
- },
- "config": {
- "type": "object",
- "additionalProperties": {
- "type": "string"
- },
- "x-go-name": "Config"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "events": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Events"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "type": {
- "type": "string",
- "x-go-name": "Type"
- },
- "updated_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Updated"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Identity": {
- "description": "Identity for a person's identity like an author or committer",
- "type": "object",
- "properties": {
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Issue": {
- "description": "Issue represents an issue in a repository",
- "type": "object",
- "properties": {
- "assignee": {
- "$ref": "#/definitions/User"
- },
- "assignees": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/User"
- },
- "x-go-name": "Assignees"
- },
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "closed_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Closed"
- },
- "comments": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Comments"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "labels": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Label"
- },
- "x-go-name": "Labels"
- },
- "milestone": {
- "$ref": "#/definitions/Milestone"
- },
- "number": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Index"
- },
- "pull_request": {
- "$ref": "#/definitions/PullRequestMeta"
- },
- "state": {
- "$ref": "#/definitions/StateType"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- },
- "updated_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Updated"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- },
- "user": {
- "$ref": "#/definitions/User"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "IssueDeadline": {
- "description": "IssueDeadline represents an issue deadline",
- "type": "object",
- "properties": {
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "IssueLabelsOption": {
- "description": "IssueLabelsOption a collection of labels",
- "type": "object",
- "properties": {
- "labels": {
- "description": "list of label IDs",
- "type": "array",
- "items": {
- "type": "integer",
- "format": "int64"
- },
- "x-go-name": "Labels"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Label": {
- "description": "Label a label to an issue or a pr",
- "type": "object",
- "properties": {
- "color": {
- "type": "string",
- "x-go-name": "Color",
- "example": "00aabb"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "MarkdownOption": {
- "description": "MarkdownOption markdown options",
- "type": "object",
- "properties": {
- "Context": {
- "description": "Context to render\n\nin: body",
- "type": "string"
- },
- "Mode": {
- "description": "Mode to render\n\nin: body",
- "type": "string"
- },
- "Text": {
- "description": "Text markdown to render\n\nin: body",
- "type": "string"
- },
- "Wiki": {
- "description": "Is it a wiki page ?\n\nin: body",
- "type": "boolean"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "MergePullRequestOption": {
- "description": "MergePullRequestForm form for merging Pull Request",
- "type": "object",
- "required": [
- "Do"
- ],
- "properties": {
- "Do": {
- "type": "string",
- "enum": [
- "merge",
- "rebase",
- "rebase-merge",
- "squash"
- ]
- },
- "MergeMessageField": {
- "type": "string"
- },
- "MergeTitleField": {
- "type": "string"
- }
- },
- "x-go-name": "MergePullRequestForm",
- "x-go-package": "code.gitea.io/gitea/modules/auth"
- },
- "MigrateRepoForm": {
- "description": "MigrateRepoForm form for migrating repository",
- "type": "object",
- "required": [
- "clone_addr",
- "uid",
- "repo_name"
- ],
- "properties": {
- "auth_password": {
- "type": "string",
- "x-go-name": "AuthPassword"
- },
- "auth_username": {
- "type": "string",
- "x-go-name": "AuthUsername"
- },
- "clone_addr": {
- "type": "string",
- "x-go-name": "CloneAddr"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "issues": {
- "type": "boolean",
- "x-go-name": "Issues"
- },
- "labels": {
- "type": "boolean",
- "x-go-name": "Labels"
- },
- "milestones": {
- "type": "boolean",
- "x-go-name": "Milestones"
- },
- "mirror": {
- "type": "boolean",
- "x-go-name": "Mirror"
- },
- "private": {
- "type": "boolean",
- "x-go-name": "Private"
- },
- "pull_requests": {
- "type": "boolean",
- "x-go-name": "PullRequests"
- },
- "releases": {
- "type": "boolean",
- "x-go-name": "Releases"
- },
- "repo_name": {
- "type": "string",
- "x-go-name": "RepoName"
- },
- "uid": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "UID"
- },
- "wiki": {
- "type": "boolean",
- "x-go-name": "Wiki"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/auth"
- },
- "Milestone": {
- "description": "Milestone milestone is a collection of issues on one repository",
- "type": "object",
- "properties": {
- "closed_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Closed"
- },
- "closed_issues": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ClosedIssues"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "due_on": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "open_issues": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "OpenIssues"
- },
- "state": {
- "$ref": "#/definitions/StateType"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Organization": {
- "description": "Organization represents an organization",
- "type": "object",
- "properties": {
- "avatar_url": {
- "type": "string",
- "x-go-name": "AvatarURL"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "full_name": {
- "type": "string",
- "x-go-name": "FullName"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "location": {
- "type": "string",
- "x-go-name": "Location"
- },
- "username": {
- "type": "string",
- "x-go-name": "UserName"
- },
- "visibility": {
- "type": "string",
- "x-go-name": "Visibility"
- },
- "website": {
- "type": "string",
- "x-go-name": "Website"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PRBranchInfo": {
- "description": "PRBranchInfo information about a branch",
- "type": "object",
- "properties": {
- "label": {
- "type": "string",
- "x-go-name": "Name"
- },
- "ref": {
- "type": "string",
- "x-go-name": "Ref"
- },
- "repo": {
- "$ref": "#/definitions/Repository"
- },
- "repo_id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "RepoID"
- },
- "sha": {
- "type": "string",
- "x-go-name": "Sha"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PayloadCommit": {
- "description": "PayloadCommit represents a commit",
- "type": "object",
- "properties": {
- "added": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Added"
- },
- "author": {
- "$ref": "#/definitions/PayloadUser"
- },
- "committer": {
- "$ref": "#/definitions/PayloadUser"
- },
- "id": {
- "description": "sha1 hash of the commit",
- "type": "string",
- "x-go-name": "ID"
- },
- "message": {
- "type": "string",
- "x-go-name": "Message"
- },
- "modified": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Modified"
- },
- "removed": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "x-go-name": "Removed"
- },
- "timestamp": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Timestamp"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- },
- "verification": {
- "$ref": "#/definitions/PayloadCommitVerification"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PayloadCommitVerification": {
- "description": "PayloadCommitVerification represents the GPG verification of a commit",
- "type": "object",
- "properties": {
- "payload": {
- "type": "string",
- "x-go-name": "Payload"
- },
- "reason": {
- "type": "string",
- "x-go-name": "Reason"
- },
- "signature": {
- "type": "string",
- "x-go-name": "Signature"
- },
- "verified": {
- "type": "boolean",
- "x-go-name": "Verified"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PayloadUser": {
- "description": "PayloadUser represents the author or committer of a commit",
- "type": "object",
- "properties": {
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "name": {
- "description": "Full name of the commit author",
- "type": "string",
- "x-go-name": "Name"
- },
- "username": {
- "type": "string",
- "x-go-name": "UserName"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Permission": {
- "description": "Permission represents a set of permissions",
- "type": "object",
- "properties": {
- "admin": {
- "type": "boolean",
- "x-go-name": "Admin"
- },
- "pull": {
- "type": "boolean",
- "x-go-name": "Pull"
- },
- "push": {
- "type": "boolean",
- "x-go-name": "Push"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PublicKey": {
- "description": "PublicKey publickey is a user key to push code to repository",
- "type": "object",
- "properties": {
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "fingerprint": {
- "type": "string",
- "x-go-name": "Fingerprint"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "key": {
- "type": "string",
- "x-go-name": "Key"
- },
- "key_type": {
- "type": "string",
- "x-go-name": "KeyType"
- },
- "read_only": {
- "type": "boolean",
- "x-go-name": "ReadOnly"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- },
- "user": {
- "$ref": "#/definitions/User"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PullRequest": {
- "description": "PullRequest represents a pull request",
- "type": "object",
- "properties": {
- "assignee": {
- "$ref": "#/definitions/User"
- },
- "assignees": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/User"
- },
- "x-go-name": "Assignees"
- },
- "base": {
- "$ref": "#/definitions/PRBranchInfo"
- },
- "body": {
- "type": "string",
- "x-go-name": "Body"
- },
- "closed_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Closed"
- },
- "comments": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Comments"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "diff_url": {
- "type": "string",
- "x-go-name": "DiffURL"
- },
- "due_date": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Deadline"
- },
- "head": {
- "$ref": "#/definitions/PRBranchInfo"
- },
- "html_url": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "labels": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Label"
- },
- "x-go-name": "Labels"
- },
- "merge_base": {
- "type": "string",
- "x-go-name": "MergeBase"
- },
- "merge_commit_sha": {
- "type": "string",
- "x-go-name": "MergedCommitID"
- },
- "mergeable": {
- "type": "boolean",
- "x-go-name": "Mergeable"
- },
- "merged": {
- "type": "boolean",
- "x-go-name": "HasMerged"
- },
- "merged_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Merged"
- },
- "merged_by": {
- "$ref": "#/definitions/User"
- },
- "milestone": {
- "$ref": "#/definitions/Milestone"
- },
- "number": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Index"
- },
- "patch_url": {
- "type": "string",
- "x-go-name": "PatchURL"
- },
- "state": {
- "$ref": "#/definitions/StateType"
- },
- "title": {
- "type": "string",
- "x-go-name": "Title"
- },
- "updated_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Updated"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- },
- "user": {
- "$ref": "#/definitions/User"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "PullRequestMeta": {
- "description": "PullRequestMeta PR info if an issue is a PR",
- "type": "object",
- "properties": {
- "merged": {
- "type": "boolean",
- "x-go-name": "HasMerged"
- },
- "merged_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Merged"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Reference": {
- "type": "object",
- "title": "Reference represents a Git reference.",
- "properties": {
- "object": {
- "$ref": "#/definitions/GitObject"
- },
- "ref": {
- "type": "string",
- "x-go-name": "Ref"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Release": {
- "description": "Release represents a repository release",
- "type": "object",
- "properties": {
- "assets": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Attachment"
- },
- "x-go-name": "Attachments"
- },
- "author": {
- "$ref": "#/definitions/User"
- },
- "body": {
- "type": "string",
- "x-go-name": "Note"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "CreatedAt"
- },
- "draft": {
- "type": "boolean",
- "x-go-name": "IsDraft"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "name": {
- "type": "string",
- "x-go-name": "Title"
- },
- "prerelease": {
- "type": "boolean",
- "x-go-name": "IsPrerelease"
- },
- "published_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "PublishedAt"
- },
- "tag_name": {
- "type": "string",
- "x-go-name": "TagName"
- },
- "tarball_url": {
- "type": "string",
- "x-go-name": "TarURL"
- },
- "target_commitish": {
- "type": "string",
- "x-go-name": "Target"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- },
- "zipball_url": {
- "type": "string",
- "x-go-name": "ZipURL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "RepoCommit": {
- "type": "object",
- "title": "RepoCommit contains information of a commit in the context of a repository.",
- "properties": {
- "author": {
- "$ref": "#/definitions/CommitUser"
- },
- "committer": {
- "$ref": "#/definitions/CommitUser"
- },
- "message": {
- "type": "string",
- "x-go-name": "Message"
- },
- "tree": {
- "$ref": "#/definitions/CommitMeta"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Repository": {
- "description": "Repository represents a repository",
- "type": "object",
- "properties": {
- "allow_merge_commits": {
- "type": "boolean",
- "x-go-name": "AllowMerge"
- },
- "allow_rebase": {
- "type": "boolean",
- "x-go-name": "AllowRebase"
- },
- "allow_rebase_explicit": {
- "type": "boolean",
- "x-go-name": "AllowRebaseMerge"
- },
- "allow_squash_merge": {
- "type": "boolean",
- "x-go-name": "AllowSquash"
- },
- "archived": {
- "type": "boolean",
- "x-go-name": "Archived"
- },
- "avatar_url": {
- "type": "string",
- "x-go-name": "AvatarURL"
- },
- "clone_url": {
- "type": "string",
- "x-go-name": "CloneURL"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "default_branch": {
- "type": "string",
- "x-go-name": "DefaultBranch"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "empty": {
- "type": "boolean",
- "x-go-name": "Empty"
- },
- "fork": {
- "type": "boolean",
- "x-go-name": "Fork"
- },
- "forks_count": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Forks"
- },
- "full_name": {
- "type": "string",
- "x-go-name": "FullName"
- },
- "has_issues": {
- "type": "boolean",
- "x-go-name": "HasIssues"
- },
- "has_pull_requests": {
- "type": "boolean",
- "x-go-name": "HasPullRequests"
- },
- "has_wiki": {
- "type": "boolean",
- "x-go-name": "HasWiki"
- },
- "html_url": {
- "type": "string",
- "x-go-name": "HTMLURL"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "ignore_whitespace_conflicts": {
- "type": "boolean",
- "x-go-name": "IgnoreWhitespaceConflicts"
- },
- "mirror": {
- "type": "boolean",
- "x-go-name": "Mirror"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "open_issues_count": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "OpenIssues"
- },
- "owner": {
- "$ref": "#/definitions/User"
- },
- "parent": {
- "$ref": "#/definitions/Repository"
- },
- "permissions": {
- "$ref": "#/definitions/Permission"
- },
- "private": {
- "type": "boolean",
- "x-go-name": "Private"
- },
- "size": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Size"
- },
- "ssh_url": {
- "type": "string",
- "x-go-name": "SSHURL"
- },
- "stars_count": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Stars"
- },
- "updated_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Updated"
- },
- "watchers_count": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Watchers"
- },
- "website": {
- "type": "string",
- "x-go-name": "Website"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "SearchResults": {
- "description": "SearchResults results of a successful search",
- "type": "object",
- "properties": {
- "data": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Repository"
- },
- "x-go-name": "Data"
- },
- "ok": {
- "type": "boolean",
- "x-go-name": "OK"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "ServerVersion": {
- "description": "ServerVersion wraps the version of the server",
- "type": "object",
- "properties": {
- "version": {
- "type": "string",
- "x-go-name": "Version"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "StateType": {
- "description": "StateType issue state type",
- "type": "string",
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Status": {
- "description": "Status holds a single Status of a single Commit",
- "type": "object",
- "properties": {
- "context": {
- "type": "string",
- "x-go-name": "Context"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "creator": {
- "$ref": "#/definitions/User"
- },
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "status": {
- "$ref": "#/definitions/StatusState"
- },
- "target_url": {
- "type": "string",
- "x-go-name": "TargetURL"
- },
- "updated_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Updated"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "StatusState": {
- "description": "StatusState holds the state of a Status\nIt can be \"pending\", \"success\", \"error\", \"failure\", and \"warning\"",
- "type": "string",
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Tag": {
- "description": "Tag represents a repository tag",
- "type": "object",
- "properties": {
- "commit": {
- "$ref": "#/definitions/CommitMeta"
- },
- "id": {
- "type": "string",
- "x-go-name": "ID"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "tarball_url": {
- "type": "string",
- "x-go-name": "TarballURL"
- },
- "zipball_url": {
- "type": "string",
- "x-go-name": "ZipballURL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "Team": {
- "description": "Team represents a team in an organization",
- "type": "object",
- "properties": {
- "description": {
- "type": "string",
- "x-go-name": "Description"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "name": {
- "type": "string",
- "x-go-name": "Name"
- },
- "organization": {
- "$ref": "#/definitions/Organization"
- },
- "permission": {
- "type": "string",
- "enum": [
- "none",
- "read",
- "write",
- "admin",
- "owner"
- ],
- "x-go-name": "Permission"
- },
- "units": {
- "type": "array",
- "enum": [
- "repo.code",
- "repo.issues",
- "repo.ext_issues",
- "repo.wiki",
- "repo.pulls",
- "repo.releases",
- "repo.ext_wiki"
- ],
- "items": {
- "type": "string"
- },
- "x-go-name": "Units"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "TimeStamp": {
- "description": "TimeStamp defines a timestamp",
- "type": "integer",
- "format": "int64",
- "x-go-package": "code.gitea.io/gitea/modules/util"
- },
- "TrackedTime": {
- "description": "TrackedTime worked time for an issue / pr",
- "type": "object",
- "properties": {
- "created": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "issue_id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "IssueID"
- },
- "time": {
- "description": "Time in seconds",
- "type": "integer",
- "format": "int64",
- "x-go-name": "Time"
- },
- "user_id": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "UserID"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "UpdateFileOptions": {
- "description": "UpdateFileOptions options for updating files\nNote: `author` and `committer` are optional (if only one is given, it will be used for the other, otherwise the authenticated user will be used)",
- "type": "object",
- "required": [
- "sha",
- "content"
- ],
- "properties": {
- "author": {
- "$ref": "#/definitions/Identity"
- },
- "branch": {
- "description": "branch (optional) to base this file from. if not given, the default branch is used",
- "type": "string",
- "x-go-name": "BranchName"
- },
- "committer": {
- "$ref": "#/definitions/Identity"
- },
- "content": {
- "description": "content must be base64 encoded",
- "type": "string",
- "x-go-name": "Content"
- },
- "from_path": {
- "description": "from_path (optional) is the path of the original file which will be moved/renamed to the path in the URL",
- "type": "string",
- "x-go-name": "FromPath"
- },
- "message": {
- "description": "message (optional) for the commit of this file. if not supplied, a default message will be used",
- "type": "string",
- "x-go-name": "Message"
- },
- "new_branch": {
- "description": "new_branch (optional) will make a new branch from `branch` before creating the file",
- "type": "string",
- "x-go-name": "NewBranchName"
- },
- "sha": {
- "description": "sha is the SHA for the file that already exists",
- "type": "string",
- "x-go-name": "SHA"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "User": {
- "description": "User represents a user",
- "type": "object",
- "properties": {
- "avatar_url": {
- "description": "URL to the user's avatar",
- "type": "string",
- "x-go-name": "AvatarURL"
- },
- "created": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "Created"
- },
- "email": {
- "type": "string",
- "format": "email",
- "x-go-name": "Email"
- },
- "full_name": {
- "description": "the user's full name",
- "type": "string",
- "x-go-name": "FullName"
- },
- "id": {
- "description": "the user's id",
- "type": "integer",
- "format": "int64",
- "x-go-name": "ID"
- },
- "is_admin": {
- "description": "Is the user an administrator",
- "type": "boolean",
- "x-go-name": "IsAdmin"
- },
- "language": {
- "description": "User locale",
- "type": "string",
- "x-go-name": "Language"
- },
- "last_login": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "LastLogin"
- },
- "login": {
- "description": "the user's username",
- "type": "string",
- "x-go-name": "UserName"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- },
- "UserHeatmapData": {
- "description": "UserHeatmapData represents the data needed to create a heatmap",
- "type": "object",
- "properties": {
- "contributions": {
- "type": "integer",
- "format": "int64",
- "x-go-name": "Contributions"
- },
- "timestamp": {
- "$ref": "#/definitions/TimeStamp"
- }
- },
- "x-go-package": "code.gitea.io/gitea/models"
- },
- "WatchInfo": {
- "description": "WatchInfo represents an API watch status of one repository",
- "type": "object",
- "properties": {
- "created_at": {
- "type": "string",
- "format": "date-time",
- "x-go-name": "CreatedAt"
- },
- "ignored": {
- "type": "boolean",
- "x-go-name": "Ignored"
- },
- "reason": {
- "type": "object",
- "x-go-name": "Reason"
- },
- "repository_url": {
- "type": "string",
- "x-go-name": "RepositoryURL"
- },
- "subscribed": {
- "type": "boolean",
- "x-go-name": "Subscribed"
- },
- "url": {
- "type": "string",
- "x-go-name": "URL"
- }
- },
- "x-go-package": "code.gitea.io/gitea/modules/structs"
- }
- },
- "responses": {
- "AccessToken": {
- "description": "AccessToken represents an API access token.",
- "headers": {
- "id": {
- "type": "integer",
- "format": "int64"
- },
- "name": {
- "type": "string"
- },
- "sha1": {
- "type": "string"
- },
- "token_last_eight": {
- "type": "string"
- }
- }
- },
- "AccessTokenList": {
- "description": "AccessTokenList represents a list of API access token.",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/AccessToken"
- }
- }
- },
- "AnnotatedTag": {
- "description": "AnnotatedTag",
- "schema": {
- "$ref": "#/definitions/AnnotatedTag"
- }
- },
- "Attachment": {
- "description": "Attachment",
- "schema": {
- "$ref": "#/definitions/Attachment"
- }
- },
- "AttachmentList": {
- "description": "AttachmentList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Attachment"
- }
- }
- },
- "Branch": {
- "description": "Branch",
- "schema": {
- "$ref": "#/definitions/Branch"
- }
- },
- "BranchList": {
- "description": "BranchList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Branch"
- }
- }
- },
- "Comment": {
- "description": "Comment",
- "schema": {
- "$ref": "#/definitions/Comment"
- }
- },
- "CommentList": {
- "description": "CommentList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Comment"
- }
- }
- },
- "Commit": {
- "description": "Commit",
- "schema": {
- "$ref": "#/definitions/Commit"
- }
- },
- "ContentsListResponse": {
- "description": "ContentsListResponse",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/ContentsResponse"
- }
- }
- },
- "ContentsResponse": {
- "description": "ContentsResponse",
- "schema": {
- "$ref": "#/definitions/ContentsResponse"
- }
- },
- "DeployKey": {
- "description": "DeployKey",
- "schema": {
- "$ref": "#/definitions/DeployKey"
- }
- },
- "DeployKeyList": {
- "description": "DeployKeyList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/DeployKey"
- }
- }
- },
- "EmailList": {
- "description": "EmailList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Email"
- }
- }
- },
- "FileDeleteResponse": {
- "description": "FileDeleteResponse",
- "schema": {
- "$ref": "#/definitions/FileDeleteResponse"
- }
- },
- "FileResponse": {
- "description": "FileResponse",
- "schema": {
- "$ref": "#/definitions/FileResponse"
- }
- },
- "GPGKey": {
- "description": "GPGKey",
- "schema": {
- "$ref": "#/definitions/GPGKey"
- }
- },
- "GPGKeyList": {
- "description": "GPGKeyList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/GPGKey"
- }
- }
- },
- "GitBlobResponse": {
- "description": "GitBlobResponse",
- "schema": {
- "$ref": "#/definitions/GitBlobResponse"
- }
- },
- "GitHook": {
- "description": "GitHook",
- "schema": {
- "$ref": "#/definitions/GitHook"
- }
- },
- "GitHookList": {
- "description": "GitHookList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/GitHook"
- }
- }
- },
- "GitTreeResponse": {
- "description": "GitTreeResponse",
- "schema": {
- "$ref": "#/definitions/GitTreeResponse"
- }
- },
- "Hook": {
- "description": "Hook",
- "schema": {
- "$ref": "#/definitions/Hook"
- }
- },
- "HookList": {
- "description": "HookList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Hook"
- }
- }
- },
- "Issue": {
- "description": "Issue",
- "schema": {
- "$ref": "#/definitions/Issue"
- }
- },
- "IssueDeadline": {
- "description": "IssueDeadline",
- "schema": {
- "$ref": "#/definitions/IssueDeadline"
- }
- },
- "IssueList": {
- "description": "IssueList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Issue"
- }
- }
- },
- "Label": {
- "description": "Label",
- "schema": {
- "$ref": "#/definitions/Label"
- }
- },
- "LabelList": {
- "description": "LabelList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Label"
- }
- }
- },
- "MarkdownRender": {
- "description": "MarkdownRender is a rendered markdown document",
- "schema": {
- "type": "string"
- }
- },
- "Milestone": {
- "description": "Milestone",
- "schema": {
- "$ref": "#/definitions/Milestone"
- }
- },
- "MilestoneList": {
- "description": "MilestoneList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Milestone"
- }
- }
- },
- "Organization": {
- "description": "Organization",
- "schema": {
- "$ref": "#/definitions/Organization"
- }
- },
- "OrganizationList": {
- "description": "OrganizationList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Organization"
- }
- }
- },
- "PublicKey": {
- "description": "PublicKey",
- "schema": {
- "$ref": "#/definitions/PublicKey"
- }
- },
- "PublicKeyList": {
- "description": "PublicKeyList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/PublicKey"
- }
- }
- },
- "PullRequest": {
- "description": "PullRequest",
- "schema": {
- "$ref": "#/definitions/PullRequest"
- }
- },
- "PullRequestList": {
- "description": "PullRequestList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/PullRequest"
- }
- }
- },
- "Reference": {
- "description": "Reference",
- "schema": {
- "$ref": "#/definitions/Reference"
- }
- },
- "ReferenceList": {
- "description": "ReferenceList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Reference"
- }
- }
- },
- "Release": {
- "description": "Release",
- "schema": {
- "$ref": "#/definitions/Release"
- }
- },
- "ReleaseList": {
- "description": "ReleaseList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Release"
- }
- }
- },
- "Repository": {
- "description": "Repository",
- "schema": {
- "$ref": "#/definitions/Repository"
- }
- },
- "RepositoryList": {
- "description": "RepositoryList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Repository"
- }
- }
- },
- "SearchResults": {
- "description": "SearchResults",
- "schema": {
- "$ref": "#/definitions/SearchResults"
- }
- },
- "ServerVersion": {
- "description": "ServerVersion",
- "schema": {
- "$ref": "#/definitions/ServerVersion"
- }
- },
- "Status": {
- "description": "Status",
- "schema": {
- "$ref": "#/definitions/Status"
- }
- },
- "StatusList": {
- "description": "StatusList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Status"
- }
- }
- },
- "Tag": {
- "description": "Tag",
- "schema": {
- "$ref": "#/definitions/Tag"
- }
- },
- "TagList": {
- "description": "TagList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Tag"
- }
- }
- },
- "Team": {
- "description": "Team",
- "schema": {
- "$ref": "#/definitions/Team"
- }
- },
- "TeamList": {
- "description": "TeamList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/Team"
- }
- }
- },
- "TrackedTime": {
- "description": "TrackedTime",
- "schema": {
- "$ref": "#/definitions/TrackedTime"
- }
- },
- "TrackedTimeList": {
- "description": "TrackedTimeList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TrackedTime"
- }
- }
- },
- "User": {
- "description": "User",
- "schema": {
- "$ref": "#/definitions/User"
- }
- },
- "UserHeatmapData": {
- "description": "UserHeatmapData",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/UserHeatmapData"
- }
- }
- },
- "UserList": {
- "description": "UserList",
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/User"
- }
- }
- },
- "WatchInfo": {
- "description": "WatchInfo",
- "schema": {
- "$ref": "#/definitions/WatchInfo"
- }
- },
- "empty": {
- "description": "APIEmpty is an empty response"
- },
- "error": {
- "description": "APIError is error format response",
- "headers": {
- "message": {
- "type": "string"
- },
- "url": {
- "type": "string"
- }
- }
- },
- "forbidden": {
- "description": "APIForbiddenError is a forbidden error response",
- "headers": {
- "message": {
- "type": "string"
- },
- "url": {
- "type": "string"
- }
- }
- },
- "notFound": {
- "description": "APINotFound is a not found empty response"
- },
- "parameterBodies": {
- "description": "parameterBodies",
- "schema": {
- "$ref": "#/definitions/DeleteFileOptions"
- }
- },
- "redirect": {
- "description": "APIRedirect is a redirect response"
- },
- "validationError": {
- "description": "APIValidationError is error format response related to input validation",
- "headers": {
- "message": {
- "type": "string"
- },
- "url": {
- "type": "string"
- }
- }
- }
- },
- "securityDefinitions": {
- "AccessToken": {
- "type": "apiKey",
- "name": "access_token",
- "in": "query"
- },
- "AuthorizationHeaderToken": {
- "type": "apiKey",
- "name": "Authorization",
- "in": "header"
- },
- "BasicAuth": {
- "type": "basic"
- },
- "SudoHeader": {
- "description": "Sudo API request as the user provided as the key. Admin privileges are required.",
- "type": "apiKey",
- "name": "Sudo",
- "in": "header"
- },
- "SudoParam": {
- "description": "Sudo API request as the user provided as the key. Admin privileges are required.",
- "type": "apiKey",
- "name": "sudo",
- "in": "query"
- },
- "Token": {
- "type": "apiKey",
- "name": "token",
- "in": "query"
- }
- },
- "security": [
- {
- "BasicAuth": []
- },
- {
- "Token": []
- },
- {
- "AccessToken": []
- },
- {
- "AuthorizationHeaderToken": []
- },
- {
- "SudoParam": []
- },
- {
- "SudoHeader": []
- }
- ]
- }
|