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

snapshot-of-api.json 362KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208
  1. {
  2. "webServices": [
  3. {
  4. "path": "api/analysis_reports",
  5. "description": "Get details about Compute Engine tasks.",
  6. "actions": [
  7. {
  8. "key": "is_queue_empty",
  9. "description": "Check if the queue of Compute Engine is empty",
  10. "since": "5.1",
  11. "internal": true,
  12. "post": false,
  13. "hasResponseExample": true,
  14. "changelog": []
  15. }
  16. ]
  17. },
  18. {
  19. "path": "api/authentication",
  20. "description": "Handle authentication.",
  21. "actions": [
  22. {
  23. "key": "login",
  24. "description": "Authenticate a user.",
  25. "since": "6.0",
  26. "internal": false,
  27. "post": true,
  28. "hasResponseExample": false,
  29. "changelog": [],
  30. "params": [
  31. {
  32. "key": "login",
  33. "description": "Login of the user",
  34. "required": true,
  35. "internal": false
  36. },
  37. {
  38. "key": "password",
  39. "description": "Password of the user",
  40. "required": true,
  41. "internal": false
  42. }
  43. ]
  44. },
  45. {
  46. "key": "logout",
  47. "description": "Logout a user.",
  48. "since": "6.3",
  49. "internal": false,
  50. "post": true,
  51. "hasResponseExample": false,
  52. "changelog": []
  53. },
  54. {
  55. "key": "validate",
  56. "description": "Check credentials.",
  57. "since": "3.3",
  58. "internal": false,
  59. "post": false,
  60. "hasResponseExample": true,
  61. "changelog": []
  62. }
  63. ]
  64. },
  65. {
  66. "path": "api/ce",
  67. "description": "Get information on Compute Engine tasks.",
  68. "actions": [
  69. {
  70. "key": "activity",
  71. "description": "Search for tasks.<br> Requires the system administration permission, or project administration permission if componentId is set.",
  72. "since": "5.2",
  73. "internal": false,
  74. "post": false,
  75. "hasResponseExample": true,
  76. "changelog": [
  77. {
  78. "description": "fields \"branch\" and \"branchType\" added",
  79. "version": "6.6"
  80. },
  81. {
  82. "description": "field \"logs\" is deprecated and its value is always false",
  83. "version": "6.1"
  84. },
  85. {
  86. "description": "it's no more possible to specify the page parameter.",
  87. "version": "5.5"
  88. }
  89. ],
  90. "params": [
  91. {
  92. "key": "componentId",
  93. "description": "Id of the component (project) to filter on",
  94. "required": false,
  95. "internal": false,
  96. "exampleValue": "AU-TpxcA-iU5OvuD2FL0"
  97. },
  98. {
  99. "key": "componentQuery",
  100. "description": "Limit search to: <ul><li>component names that contain the supplied string</li><li>component keys that are exactly the same as the supplied string</li></ul>Must not be set together with componentId.<br />Deprecated and replaced by 'q'",
  101. "required": false,
  102. "internal": false,
  103. "exampleValue": "Apache",
  104. "deprecatedSince": "5.5"
  105. },
  106. {
  107. "key": "maxExecutedAt",
  108. "description": "Maximum date of end of task processing (inclusive)",
  109. "required": false,
  110. "internal": false,
  111. "exampleValue": "2017-11-10T10:01:57+0100"
  112. },
  113. {
  114. "key": "minSubmittedAt",
  115. "description": "Minimum date of task submission (inclusive)",
  116. "required": false,
  117. "internal": false,
  118. "exampleValue": "2017-11-10T10:01:57+0100"
  119. },
  120. {
  121. "key": "onlyCurrents",
  122. "description": "Filter on the last tasks (only the most recent finished task by project)",
  123. "required": false,
  124. "internal": false,
  125. "defaultValue": "false",
  126. "possibleValues": [
  127. "true",
  128. "false",
  129. "yes",
  130. "no"
  131. ]
  132. },
  133. {
  134. "key": "p",
  135. "description": "Deprecated parameter",
  136. "required": false,
  137. "internal": false,
  138. "deprecatedSince": "5.5",
  139. "deprecatedKey": "pageIndex",
  140. "deprecatedKeySince": "5.4"
  141. },
  142. {
  143. "key": "ps",
  144. "description": "Page size. Must be greater than 0 and less than 1000",
  145. "required": false,
  146. "internal": false,
  147. "defaultValue": "100",
  148. "exampleValue": "20",
  149. "deprecatedKey": "pageSize",
  150. "deprecatedKeySince": "5.2",
  151. "maximumValue": 1000
  152. },
  153. {
  154. "key": "q",
  155. "description": "Limit search to: <ul><li>component names that contain the supplied string</li><li>component keys that are exactly the same as the supplied string</li><li>task ids that are exactly the same as the supplied string</li></ul>Must not be set together with componentId",
  156. "since": "5.5",
  157. "required": false,
  158. "internal": false,
  159. "exampleValue": "Apache"
  160. },
  161. {
  162. "key": "status",
  163. "description": "Comma separated list of task statuses",
  164. "required": false,
  165. "internal": false,
  166. "defaultValue": "SUCCESS,FAILED,CANCELED",
  167. "exampleValue": "IN_PROGRESS,SUCCESS",
  168. "possibleValues": [
  169. "SUCCESS",
  170. "FAILED",
  171. "CANCELED",
  172. "PENDING",
  173. "IN_PROGRESS"
  174. ]
  175. },
  176. {
  177. "key": "type",
  178. "description": "Task type",
  179. "required": false,
  180. "internal": false,
  181. "exampleValue": "REPORT",
  182. "possibleValues": [
  183. "REPORT"
  184. ]
  185. }
  186. ]
  187. },
  188. {
  189. "key": "activity_status",
  190. "description": "Return CE activity related metrics.<br>Requires 'Administer System' permission or 'Administer' rights on the specified project.",
  191. "since": "5.5",
  192. "internal": true,
  193. "post": false,
  194. "hasResponseExample": true,
  195. "changelog": [
  196. {
  197. "description": "New field 'inProgress' in response",
  198. "version": "6.6"
  199. }
  200. ],
  201. "params": [
  202. {
  203. "key": "componentId",
  204. "description": "Id of the component (project) to filter on",
  205. "required": false,
  206. "internal": false,
  207. "exampleValue": "AU-TpxcA-iU5OvuD2FL0"
  208. },
  209. {
  210. "key": "componentKey",
  211. "description": "Key of the component (project) to filter on",
  212. "required": false,
  213. "internal": false,
  214. "exampleValue": "my_project"
  215. }
  216. ]
  217. },
  218. {
  219. "key": "cancel",
  220. "description": "Cancels a pending task.<br/>In-progress tasks cannot be canceled.<br/>Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the project related to the task</li></ul>",
  221. "since": "5.2",
  222. "internal": true,
  223. "post": true,
  224. "hasResponseExample": false,
  225. "changelog": [],
  226. "params": [
  227. {
  228. "key": "id",
  229. "description": "Id of the task to cancel.",
  230. "required": true,
  231. "internal": false,
  232. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  233. }
  234. ]
  235. },
  236. {
  237. "key": "cancel_all",
  238. "description": "Cancels all pending tasks. Requires system administration permission. In-progress tasks are not canceled.",
  239. "since": "5.2",
  240. "internal": true,
  241. "post": true,
  242. "hasResponseExample": false,
  243. "changelog": []
  244. },
  245. {
  246. "key": "component",
  247. "description": "Get the pending tasks, in-progress tasks and the last executed task of a given component (usually a project).<br>Requires the following permission: 'Browse' on the specified component.<br>Either 'componentId' or 'component' must be provided.",
  248. "since": "5.2",
  249. "internal": false,
  250. "post": false,
  251. "hasResponseExample": true,
  252. "changelog": [
  253. {
  254. "description": "fields \"branch\" and \"branchType\" added",
  255. "version": "6.6"
  256. },
  257. {
  258. "description": "field \"logs\" is deprecated and its value is always false",
  259. "version": "6.1"
  260. }
  261. ],
  262. "params": [
  263. {
  264. "key": "component",
  265. "required": false,
  266. "internal": false,
  267. "exampleValue": "my_project",
  268. "deprecatedKey": "componentKey",
  269. "deprecatedKeySince": "6.6"
  270. },
  271. {
  272. "key": "componentId",
  273. "required": false,
  274. "internal": false,
  275. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  276. "deprecatedSince": "6.6"
  277. }
  278. ]
  279. },
  280. {
  281. "key": "submit",
  282. "description": "Submits a scanner report to the queue. Report is processed asynchronously. Requires analysis permission. If the project does not exist, then the provisioning permission is also required.",
  283. "since": "5.2",
  284. "internal": true,
  285. "post": true,
  286. "hasResponseExample": true,
  287. "changelog": [],
  288. "params": [
  289. {
  290. "key": "characteristic",
  291. "description": "Optional characteristic of the analysis. Can be repeated to define multiple characteristics.",
  292. "since": "6.6",
  293. "required": false,
  294. "internal": false,
  295. "exampleValue": "branchType=long"
  296. },
  297. {
  298. "key": "organization",
  299. "description": "Key of the organization the project belongs to",
  300. "since": "6.3",
  301. "required": false,
  302. "internal": true,
  303. "exampleValue": "my-org"
  304. },
  305. {
  306. "key": "projectBranch",
  307. "description": "Optional branch of project",
  308. "required": false,
  309. "internal": false,
  310. "exampleValue": "branch-1.x"
  311. },
  312. {
  313. "key": "projectKey",
  314. "description": "Key of project",
  315. "required": true,
  316. "internal": false,
  317. "exampleValue": "my_project",
  318. "maximumLength": 400
  319. },
  320. {
  321. "key": "projectName",
  322. "description": "Optional name of the project, used only if the project does not exist yet.",
  323. "required": false,
  324. "internal": false,
  325. "exampleValue": "My Project",
  326. "maximumLength": 2000
  327. },
  328. {
  329. "key": "report",
  330. "description": "Report file. Format is not an API, it changes among SonarQube versions.",
  331. "required": true,
  332. "internal": false
  333. }
  334. ]
  335. },
  336. {
  337. "key": "task",
  338. "description": "Give Compute Engine task details such as type, status, duration and associated component.<br />Requires 'Administer System' or 'Execute Analysis' permission.<br/>Since 6.1, field \"logs\" is deprecated and its value is always false.",
  339. "since": "5.2",
  340. "internal": false,
  341. "post": false,
  342. "hasResponseExample": true,
  343. "changelog": [
  344. {
  345. "description": "fields \"branch\" and \"branchType\" added",
  346. "version": "6.6"
  347. }
  348. ],
  349. "params": [
  350. {
  351. "key": "additionalFields",
  352. "description": "Comma-separated list of the optional fields to be returned in response.",
  353. "since": "6.1",
  354. "required": false,
  355. "internal": false,
  356. "possibleValues": [
  357. "stacktrace",
  358. "scannerContext"
  359. ]
  360. },
  361. {
  362. "key": "id",
  363. "description": "Id of task",
  364. "required": true,
  365. "internal": false,
  366. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  367. }
  368. ]
  369. },
  370. {
  371. "key": "task_types",
  372. "description": "List available task types",
  373. "since": "5.5",
  374. "internal": true,
  375. "post": false,
  376. "hasResponseExample": true,
  377. "changelog": []
  378. },
  379. {
  380. "key": "worker_count",
  381. "description": "Return number of Compute Engine workers.<br/>Requires the system administration permission",
  382. "since": "6.5",
  383. "internal": true,
  384. "post": false,
  385. "hasResponseExample": true,
  386. "changelog": []
  387. }
  388. ]
  389. },
  390. {
  391. "path": "api/components",
  392. "since": "4.2",
  393. "description": "Get information about a component (file, directory, project, ...) and its ancestors or descendants. Update a project or module key.",
  394. "actions": [
  395. {
  396. "key": "app",
  397. "description": "Coverage data required for rendering the component viewer.<br>Requires the following permission: 'Browse'.",
  398. "since": "4.4",
  399. "internal": true,
  400. "post": false,
  401. "hasResponseExample": true,
  402. "changelog": [],
  403. "params": [
  404. {
  405. "key": "branch",
  406. "description": "Branch key",
  407. "since": "6.6",
  408. "required": false,
  409. "internal": true,
  410. "exampleValue": "feature/my_branch"
  411. },
  412. {
  413. "key": "component",
  414. "description": "Component key",
  415. "since": "6.4",
  416. "required": false,
  417. "internal": false,
  418. "exampleValue": "my_project"
  419. },
  420. {
  421. "key": "componentId",
  422. "description": "Component ID",
  423. "required": false,
  424. "internal": false,
  425. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  426. "deprecatedSince": "6.4",
  427. "deprecatedKey": "uuid",
  428. "deprecatedKeySince": "6.4"
  429. }
  430. ]
  431. },
  432. {
  433. "key": "search",
  434. "description": "Search for components",
  435. "since": "6.3",
  436. "internal": false,
  437. "post": false,
  438. "hasResponseExample": true,
  439. "changelog": [],
  440. "params": [
  441. {
  442. "key": "language",
  443. "description": "Language key. If provided, only components for the given language are returned.",
  444. "required": false,
  445. "internal": false,
  446. "exampleValue": ""
  447. },
  448. {
  449. "key": "organization",
  450. "description": "Organization key",
  451. "since": "6.3",
  452. "required": false,
  453. "internal": true,
  454. "exampleValue": "my-org"
  455. },
  456. {
  457. "key": "p",
  458. "description": "1-based page number",
  459. "required": false,
  460. "internal": false,
  461. "defaultValue": "1",
  462. "exampleValue": "42",
  463. "deprecatedKey": "pageIndex",
  464. "deprecatedKeySince": "5.2"
  465. },
  466. {
  467. "key": "ps",
  468. "description": "Page size. Must be greater than 0.",
  469. "required": false,
  470. "internal": false,
  471. "defaultValue": "100",
  472. "exampleValue": "20",
  473. "deprecatedKey": "pageSize",
  474. "deprecatedKeySince": "5.2"
  475. },
  476. {
  477. "key": "q",
  478. "description": "Limit search to: <ul><li>component names that contain the supplied string</li><li>component keys that are exactly the same as the supplied string</li></ul>",
  479. "required": false,
  480. "internal": false,
  481. "exampleValue": "sonar"
  482. },
  483. {
  484. "key": "qualifiers",
  485. "description": "Comma-separated list of component qualifiers. Filter the results with the specified qualifiers. Possible values are:<ul><li>BRC - Sub-projects</li><li>DIR - Directories</li><li>FIL - Files</li><li>TRK - Projects</li><li>UTS - Test Files</li></ul>",
  486. "required": true,
  487. "internal": false,
  488. "possibleValues": [
  489. "BRC",
  490. "DIR",
  491. "FIL",
  492. "TRK",
  493. "UTS"
  494. ]
  495. }
  496. ]
  497. },
  498. {
  499. "key": "search_projects",
  500. "description": "Search for projects",
  501. "since": "6.2",
  502. "internal": true,
  503. "post": false,
  504. "hasResponseExample": true,
  505. "changelog": [
  506. {
  507. "description": "The 'filter' parameter now allows 'NO_DATA' as value for numeric metrics",
  508. "version": "6.5"
  509. },
  510. {
  511. "description": "Added the option 'analysisDate' for the 'sort' parameter",
  512. "version": "6.5"
  513. },
  514. {
  515. "description": "Value 'leakPeriodDate' is added to parameter 'f'",
  516. "version": "6.5"
  517. },
  518. {
  519. "description": "The 'languages' parameter accepts 'filter' to filter by language",
  520. "version": "6.4"
  521. },
  522. {
  523. "description": "The 'visibility' field is added",
  524. "version": "6.4"
  525. }
  526. ],
  527. "params": [
  528. {
  529. "key": "asc",
  530. "description": "Ascending sort",
  531. "required": false,
  532. "internal": false,
  533. "defaultValue": "true",
  534. "possibleValues": [
  535. "true",
  536. "false",
  537. "yes",
  538. "no"
  539. ]
  540. },
  541. {
  542. "key": "f",
  543. "description": "Comma-separated list of the fields to be returned in response",
  544. "since": "6.4",
  545. "required": false,
  546. "internal": false,
  547. "possibleValues": [
  548. "analysisDate",
  549. "leakPeriodDate"
  550. ]
  551. },
  552. {
  553. "key": "facets",
  554. "description": "Comma-separated list of the facets to be computed. No facet is computed by default.",
  555. "required": false,
  556. "internal": false,
  557. "possibleValues": [
  558. "alert_status",
  559. "coverage",
  560. "duplicated_lines_density",
  561. "languages",
  562. "ncloc",
  563. "new_coverage",
  564. "new_duplicated_lines_density",
  565. "new_lines",
  566. "new_maintainability_rating",
  567. "new_reliability_rating",
  568. "new_security_rating",
  569. "reliability_rating",
  570. "security_rating",
  571. "sqale_rating",
  572. "tags"
  573. ]
  574. },
  575. {
  576. "key": "filter",
  577. "description": "Filter of projects on name, key, measure value, quality gate, language, tag or whether a project is a favorite or not.<br>The filter must be encoded to form a valid URL (for example '=' must be replaced by '%3D').<br>Examples of use:<ul> <li>to filter my favorite projects with a failed quality gate and a coverage greater than or equals to 60% and a coverage strictly lower than 80%:<br> <code>filter=\"alert_status = ERROR and isFavorite and coverage >= 60 and coverage < 80\"</code></li> <li>to filter projects with a reliability, security and maintainability rating equals or worse than B:<br> <code>filter=\"reliability_rating>=2 and security_rating>=2 and sqale_rating>=2\"</code></li> <li>to filter projects without duplication data:<br> <code>filter=\"duplicated_lines_density = NO_DATA\"</code></li></ul>To filter on project name or key, use the 'query' keyword, for instance : <code>filter='query = \"Sonar\"'</code>.<br><br>To filter on a numeric metric, provide the metric key.<br>These are the supported metric keys:<br><ul><li>alert_status</li><li>coverage</li><li>duplicated_lines_density</li><li>lines</li><li>ncloc</li><li>ncloc_language_distribution</li><li>new_coverage</li><li>new_duplicated_lines_density</li><li>new_lines</li><li>new_maintainability_rating</li><li>new_reliability_rating</li><li>new_security_rating</li><li>reliability_rating</li><li>security_rating</li><li>sqale_rating</li></ul><br>To filter on a rating, provide the corresponding metric key (ex: reliability_rating for reliability rating).<br>The possible values are:<ul> <li>'1' for rating A</li> <li>'2' for rating B</li> <li>'3' for rating C</li> <li>'4' for rating D</li> <li>'5' for rating E</li></ul>To filter on a Quality Gate status use the metric key 'alert_status'. Only the '=' operator can be used.<br>The possible values are:<ul> <li>'OK' for Passed</li> <li>'WARN' for Warning</li> <li>'ERROR' for Failed</li></ul>To filter on language keys use the language key: <ul> <li>to filter on a single language you can use 'language = java'</li> <li>to filter on several languages you must use 'language IN (java, js)'</li></ul>Use the WS api/languages/list to find the key of a language.<br> To filter on tags use the 'tag' keyword:<ul> <li>to filter on one tag you can use <code>tag = finance</code></li> <li>to filter on several tags you must use <code>tag in (offshore, java)</code></li></ul>",
  578. "required": false,
  579. "internal": false
  580. },
  581. {
  582. "key": "organization",
  583. "description": "the organization to search projects in",
  584. "since": "6.3",
  585. "required": false,
  586. "internal": true
  587. },
  588. {
  589. "key": "p",
  590. "description": "1-based page number",
  591. "required": false,
  592. "internal": false,
  593. "defaultValue": "1",
  594. "exampleValue": "42",
  595. "deprecatedKey": "pageIndex",
  596. "deprecatedKeySince": "5.2"
  597. },
  598. {
  599. "key": "ps",
  600. "description": "Page size. Must be greater than 0 and less than 500",
  601. "required": false,
  602. "internal": false,
  603. "defaultValue": "100",
  604. "exampleValue": "20",
  605. "deprecatedKey": "pageSize",
  606. "deprecatedKeySince": "5.2",
  607. "maximumValue": 500
  608. },
  609. {
  610. "key": "s",
  611. "description": "Sort projects by numeric metric key, quality gate status (using 'alert_status'), last analysis date (using 'analysisDate'), or by project name.",
  612. "since": "6.4",
  613. "required": false,
  614. "internal": false,
  615. "defaultValue": "name",
  616. "possibleValues": [
  617. "alert_status",
  618. "analysisDate",
  619. "coverage",
  620. "duplicated_lines_density",
  621. "lines",
  622. "name",
  623. "ncloc",
  624. "ncloc_language_distribution",
  625. "new_coverage",
  626. "new_duplicated_lines_density",
  627. "new_lines",
  628. "new_maintainability_rating",
  629. "new_reliability_rating",
  630. "new_security_rating",
  631. "reliability_rating",
  632. "security_rating",
  633. "sqale_rating"
  634. ]
  635. }
  636. ]
  637. },
  638. {
  639. "key": "show",
  640. "description": "Returns a component (file, directory, project, view…) and its ancestors. The ancestors are ordered from the parent to the root project. The 'componentId' or 'component' parameter must be provided.<br>Requires the following permission: 'Browse' on the project of the specified component.",
  641. "since": "5.4",
  642. "internal": false,
  643. "post": false,
  644. "hasResponseExample": true,
  645. "changelog": [
  646. {
  647. "description": "'branch' is added to the response",
  648. "version": "6.6"
  649. },
  650. {
  651. "description": "'version' is added to the response",
  652. "version": "6.6"
  653. },
  654. {
  655. "description": "Leak period date is added to the response",
  656. "version": "6.5"
  657. },
  658. {
  659. "description": "Analysis date has been added to the response",
  660. "version": "6.4"
  661. },
  662. {
  663. "description": "The field 'id' is deprecated in the response",
  664. "version": "6.4"
  665. },
  666. {
  667. "description": "The 'visibility' field is added to the response",
  668. "version": "6.4"
  669. }
  670. ],
  671. "params": [
  672. {
  673. "key": "branch",
  674. "description": "Branch key",
  675. "since": "6.6",
  676. "required": false,
  677. "internal": true,
  678. "exampleValue": "feature/my_branch"
  679. },
  680. {
  681. "key": "component",
  682. "description": "Component key",
  683. "required": false,
  684. "internal": false,
  685. "exampleValue": "my_project",
  686. "deprecatedKey": "key",
  687. "deprecatedKeySince": "6.4"
  688. },
  689. {
  690. "key": "componentId",
  691. "description": "Component id",
  692. "required": false,
  693. "internal": false,
  694. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  695. "deprecatedSince": "6.4",
  696. "deprecatedKey": "id",
  697. "deprecatedKeySince": "6.4"
  698. }
  699. ]
  700. },
  701. {
  702. "key": "suggestions",
  703. "description": "Internal WS for the top-right search engine. The result will contain component search results, grouped by their qualifiers.<p>Each result contains:<ul><li>the organization key</li><li>the component key</li><li>the component's name (unescaped)</li><li>optionally a display name, which puts emphasis to matching characters (this text contains html tags and parts of the html-escaped name)</li></ul>",
  704. "since": "4.2",
  705. "internal": true,
  706. "post": false,
  707. "hasResponseExample": true,
  708. "changelog": [
  709. {
  710. "description": "Parameter 's' is optional",
  711. "version": "6.4"
  712. }
  713. ],
  714. "params": [
  715. {
  716. "key": "more",
  717. "description": "Category, for which to display the next 20 results (skipping the first 6 results)",
  718. "since": "6.4",
  719. "required": false,
  720. "internal": false,
  721. "possibleValues": [
  722. "VW",
  723. "SVW",
  724. "APP",
  725. "TRK",
  726. "BRC",
  727. "FIL",
  728. "UTS"
  729. ]
  730. },
  731. {
  732. "key": "recentlyBrowsed",
  733. "description": "Comma separated list of component keys, that have recently been browsed by the user. Only the first 50 items will be used. Order is not taken into account.",
  734. "since": "6.4",
  735. "required": false,
  736. "internal": false,
  737. "exampleValue": "org.sonarsource:sonarqube,some.other:project",
  738. "maxValuesAllowed": 50
  739. },
  740. {
  741. "key": "s",
  742. "description": "Search query with a minimum of two characters. Can contain several search tokens, separated by spaces. Search tokens with only one character will be ignored.",
  743. "required": false,
  744. "internal": false,
  745. "exampleValue": "sonar"
  746. }
  747. ]
  748. },
  749. {
  750. "key": "tree",
  751. "description": "Navigate through components based on the chosen strategy. The componentId or the component parameter must be provided.<br>Requires the following permission: 'Browse' on the specified project.<br>When limiting search with the q parameter, directories are not returned.",
  752. "since": "5.4",
  753. "internal": false,
  754. "post": false,
  755. "hasResponseExample": true,
  756. "changelog": [
  757. {
  758. "description": "The field 'id' is deprecated in the response",
  759. "version": "6.4"
  760. }
  761. ],
  762. "params": [
  763. {
  764. "key": "asc",
  765. "description": "Ascending sort",
  766. "required": false,
  767. "internal": false,
  768. "defaultValue": "true",
  769. "possibleValues": [
  770. "true",
  771. "false",
  772. "yes",
  773. "no"
  774. ]
  775. },
  776. {
  777. "key": "branch",
  778. "description": "Branch key",
  779. "since": "6.6",
  780. "required": false,
  781. "internal": true,
  782. "exampleValue": "feature/my_branch"
  783. },
  784. {
  785. "key": "component",
  786. "description": "Base component key. The search is based on this component.",
  787. "required": false,
  788. "internal": false,
  789. "exampleValue": "my_project",
  790. "deprecatedKey": "baseComponentKey",
  791. "deprecatedKeySince": "6.4"
  792. },
  793. {
  794. "key": "componentId",
  795. "description": "Base component id. The search is based on this component.",
  796. "required": false,
  797. "internal": false,
  798. "exampleValue": "AU-TpxcA-iU5OvuD2FLz",
  799. "deprecatedSince": "6.4",
  800. "deprecatedKey": "baseComponentId",
  801. "deprecatedKeySince": "6.4"
  802. },
  803. {
  804. "key": "p",
  805. "description": "1-based page number",
  806. "required": false,
  807. "internal": false,
  808. "defaultValue": "1",
  809. "exampleValue": "42",
  810. "deprecatedKey": "pageIndex",
  811. "deprecatedKeySince": "5.2"
  812. },
  813. {
  814. "key": "ps",
  815. "description": "Page size. Must be greater than 0 and less than 500",
  816. "required": false,
  817. "internal": false,
  818. "defaultValue": "100",
  819. "exampleValue": "20",
  820. "deprecatedKey": "pageSize",
  821. "deprecatedKeySince": "5.2",
  822. "maximumValue": 500
  823. },
  824. {
  825. "key": "q",
  826. "description": "Limit search to: <ul><li>component names that contain the supplied string</li><li>component keys that are exactly the same as the supplied string</li></ul>Must have at least 3 characters",
  827. "required": false,
  828. "internal": false,
  829. "exampleValue": "FILE_NAM"
  830. },
  831. {
  832. "key": "qualifiers",
  833. "description": "Comma-separated list of component qualifiers. Filter the results with the specified qualifiers. Possible values are:<ul><li>BRC - Sub-projects</li><li>DIR - Directories</li><li>FIL - Files</li><li>TRK - Projects</li><li>UTS - Test Files</li></ul>",
  834. "required": false,
  835. "internal": false,
  836. "possibleValues": [
  837. "BRC",
  838. "DIR",
  839. "FIL",
  840. "TRK",
  841. "UTS"
  842. ]
  843. },
  844. {
  845. "key": "s",
  846. "description": "Comma-separated list of sort fields",
  847. "required": false,
  848. "internal": false,
  849. "defaultValue": "name",
  850. "exampleValue": "name, path",
  851. "deprecatedKey": "sort",
  852. "deprecatedKeySince": "5.4",
  853. "possibleValues": [
  854. "name",
  855. "path",
  856. "qualifier"
  857. ]
  858. },
  859. {
  860. "key": "strategy",
  861. "description": "Strategy to search for base component descendants:<ul><li>children: return the children components of the base component. Grandchildren components are not returned</li><li>all: return all the descendants components of the base component. Grandchildren are returned.</li><li>leaves: return all the descendant components (files, in general) which don't have other children. They are the leaves of the component tree.</li></ul>",
  862. "required": false,
  863. "internal": false,
  864. "defaultValue": "all",
  865. "possibleValues": [
  866. "all",
  867. "children",
  868. "leaves"
  869. ]
  870. }
  871. ]
  872. }
  873. ]
  874. },
  875. {
  876. "path": "api/duplications",
  877. "since": "4.4",
  878. "description": "Get duplication information for a project.",
  879. "actions": [
  880. {
  881. "key": "show",
  882. "description": "Get duplications. Require Browse permission on file's project",
  883. "since": "4.4",
  884. "internal": false,
  885. "post": false,
  886. "hasResponseExample": true,
  887. "changelog": [
  888. {
  889. "description": "The fields 'uuid', 'projectUuid', 'subProjectUuid' are deprecated in the response.",
  890. "version": "6.5"
  891. }
  892. ],
  893. "params": [
  894. {
  895. "key": "branch",
  896. "description": "Branch key",
  897. "required": false,
  898. "internal": true,
  899. "exampleValue": "feature/my_branch"
  900. },
  901. {
  902. "key": "key",
  903. "description": "File key",
  904. "required": false,
  905. "internal": false,
  906. "exampleValue": "my_project:/src/foo/Bar.php"
  907. },
  908. {
  909. "key": "uuid",
  910. "description": "File ID. If provided, 'key' must not be provided.",
  911. "required": false,
  912. "internal": false,
  913. "exampleValue": "584a89f2-8037-4f7b-b82c-8b45d2d63fb2",
  914. "deprecatedSince": "6.5"
  915. }
  916. ]
  917. }
  918. ]
  919. },
  920. {
  921. "path": "api/editions",
  922. "since": "6.7",
  923. "description": "Manage SonarSource commercial editions.",
  924. "actions": [
  925. {
  926. "key": "apply_license",
  927. "description": "Apply changes to SonarQube to match the specified license. Clear error message of previous automatic install of an edition, if there is any. Require 'Administer System' permission.",
  928. "since": "6.7",
  929. "internal": false,
  930. "post": true,
  931. "hasResponseExample": true,
  932. "changelog": [],
  933. "params": [
  934. {
  935. "key": "license",
  936. "description": "the license",
  937. "since": "6.7",
  938. "required": true,
  939. "internal": false
  940. }
  941. ]
  942. },
  943. {
  944. "key": "clear_error_message",
  945. "description": "Clear error message of last install of an edition (if any). Require 'Administer System' permission.",
  946. "since": "6.7",
  947. "internal": false,
  948. "post": true,
  949. "hasResponseExample": false,
  950. "changelog": []
  951. },
  952. {
  953. "key": "form_data",
  954. "description": "Provide data to prefill license request forms: the server ID and the total number of lines of code.",
  955. "since": "6.7",
  956. "internal": true,
  957. "post": false,
  958. "hasResponseExample": true,
  959. "changelog": []
  960. },
  961. {
  962. "key": "preview",
  963. "description": "Preview the changes to SonarQube to match the specified license. Requires 'Administer System' permission.",
  964. "since": "6.7",
  965. "internal": false,
  966. "post": true,
  967. "hasResponseExample": true,
  968. "changelog": [],
  969. "params": [
  970. {
  971. "key": "license",
  972. "description": "the license",
  973. "since": "6.7",
  974. "required": true,
  975. "internal": false
  976. }
  977. ]
  978. },
  979. {
  980. "key": "status",
  981. "description": "Provide status of SonarSource commercial edition of the current SonarQube. Requires 'Administer System' permission.",
  982. "since": "6.7",
  983. "internal": false,
  984. "post": false,
  985. "hasResponseExample": true,
  986. "changelog": []
  987. },
  988. {
  989. "key": "uninstall",
  990. "description": "Uninstall the currently installed edition. Requires 'Administer System' permission.",
  991. "since": "6.7",
  992. "internal": false,
  993. "post": true,
  994. "hasResponseExample": false,
  995. "changelog": []
  996. }
  997. ]
  998. },
  999. {
  1000. "path": "api/emails",
  1001. "since": "6.1",
  1002. "description": "Manage emails",
  1003. "actions": [
  1004. {
  1005. "key": "send",
  1006. "description": "Test email configuration by sending an email<br>Requires 'Administer System' permission.",
  1007. "since": "6.1",
  1008. "internal": true,
  1009. "post": true,
  1010. "hasResponseExample": false,
  1011. "changelog": [],
  1012. "params": [
  1013. {
  1014. "key": "message",
  1015. "description": "Content of the email",
  1016. "required": true,
  1017. "internal": false
  1018. },
  1019. {
  1020. "key": "subject",
  1021. "description": "Subject of the email",
  1022. "required": false,
  1023. "internal": false,
  1024. "exampleValue": "Test Message from SonarQube"
  1025. },
  1026. {
  1027. "key": "to",
  1028. "description": "Email address",
  1029. "required": true,
  1030. "internal": false,
  1031. "exampleValue": "john@doo.com"
  1032. }
  1033. ]
  1034. }
  1035. ]
  1036. },
  1037. {
  1038. "path": "api/favorites",
  1039. "since": "6.3",
  1040. "description": "Manage user favorites",
  1041. "actions": [
  1042. {
  1043. "key": "add",
  1044. "description": "Add a component (project, directory, file etc.) as favorite for the authenticated user.<br>Requires authentication and the following permission: 'Browse' on the project of the specified component.",
  1045. "since": "6.3",
  1046. "internal": false,
  1047. "post": true,
  1048. "hasResponseExample": false,
  1049. "changelog": [],
  1050. "params": [
  1051. {
  1052. "key": "component",
  1053. "description": "Component key",
  1054. "required": true,
  1055. "internal": false,
  1056. "exampleValue": "my_project:/src/foo/Bar.php"
  1057. }
  1058. ]
  1059. },
  1060. {
  1061. "key": "remove",
  1062. "description": "Remove a component (project, directory, file etc.) as favorite for the authenticated user.<br>Requires authentication.",
  1063. "since": "6.3",
  1064. "internal": false,
  1065. "post": true,
  1066. "hasResponseExample": false,
  1067. "changelog": [],
  1068. "params": [
  1069. {
  1070. "key": "component",
  1071. "description": "Component key",
  1072. "required": true,
  1073. "internal": false,
  1074. "exampleValue": "my_project"
  1075. }
  1076. ]
  1077. },
  1078. {
  1079. "key": "search",
  1080. "description": "Search for the authenticated user favorites.<br>Requires authentication.",
  1081. "since": "6.3",
  1082. "internal": false,
  1083. "post": false,
  1084. "hasResponseExample": true,
  1085. "changelog": [],
  1086. "params": [
  1087. {
  1088. "key": "p",
  1089. "description": "1-based page number",
  1090. "required": false,
  1091. "internal": false,
  1092. "defaultValue": "1",
  1093. "exampleValue": "42",
  1094. "deprecatedKey": "pageIndex",
  1095. "deprecatedKeySince": "5.2"
  1096. },
  1097. {
  1098. "key": "ps",
  1099. "description": "Page size. Must be greater than 0 and less than 500",
  1100. "required": false,
  1101. "internal": false,
  1102. "defaultValue": "100",
  1103. "exampleValue": "20",
  1104. "deprecatedKey": "pageSize",
  1105. "deprecatedKeySince": "5.2",
  1106. "maximumValue": 500
  1107. }
  1108. ]
  1109. }
  1110. ]
  1111. },
  1112. {
  1113. "path": "api/favourites",
  1114. "since": "2.6",
  1115. "description": "Removed since 6.3, please use api/favorites instead",
  1116. "actions": [
  1117. {
  1118. "key": "index",
  1119. "description": "The web service is removed and you're invited to use api/favorites instead",
  1120. "since": "2.6",
  1121. "deprecatedSince": "6.3",
  1122. "internal": false,
  1123. "post": false,
  1124. "hasResponseExample": true,
  1125. "changelog": []
  1126. }
  1127. ]
  1128. },
  1129. {
  1130. "path": "api/issues",
  1131. "since": "3.6",
  1132. "description": "Read and update issues.",
  1133. "actions": [
  1134. {
  1135. "key": "add_comment",
  1136. "description": "Add a comment.<br/>Requires authentication and the following permission: 'Browse' on the project of the specified issue.",
  1137. "since": "3.6",
  1138. "internal": false,
  1139. "post": true,
  1140. "hasResponseExample": true,
  1141. "changelog": [
  1142. {
  1143. "description": "the database ids of the components are removed from the response",
  1144. "version": "6.5"
  1145. },
  1146. {
  1147. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  1148. "version": "6.5"
  1149. },
  1150. {
  1151. "description": "the response returns the issue with all its details",
  1152. "version": "6.3"
  1153. }
  1154. ],
  1155. "params": [
  1156. {
  1157. "key": "issue",
  1158. "description": "Issue key",
  1159. "required": true,
  1160. "internal": false,
  1161. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  1162. },
  1163. {
  1164. "key": "text",
  1165. "description": "Comment text",
  1166. "required": true,
  1167. "internal": false,
  1168. "exampleValue": "Won't fix because it doesn't apply to the context"
  1169. }
  1170. ]
  1171. },
  1172. {
  1173. "key": "assign",
  1174. "description": "Assign/Unassign an issue. Requires authentication and Browse permission on project",
  1175. "since": "3.6",
  1176. "internal": false,
  1177. "post": true,
  1178. "hasResponseExample": true,
  1179. "changelog": [
  1180. {
  1181. "description": "the database ids of the components are removed from the response",
  1182. "version": "6.5"
  1183. },
  1184. {
  1185. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  1186. "version": "6.5"
  1187. }
  1188. ],
  1189. "params": [
  1190. {
  1191. "key": "assignee",
  1192. "description": "Login of the assignee. When not set, it will unassign the issue. Use '_me' to assign to current user",
  1193. "required": false,
  1194. "internal": false,
  1195. "exampleValue": "admin"
  1196. },
  1197. {
  1198. "key": "issue",
  1199. "description": "Issue key",
  1200. "required": true,
  1201. "internal": false,
  1202. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  1203. },
  1204. {
  1205. "key": "me",
  1206. "description": "(deprecated) Assign the issue to the logged-in user. Replaced by the parameter assignee=_me",
  1207. "required": false,
  1208. "internal": false,
  1209. "deprecatedSince": "5.2",
  1210. "possibleValues": [
  1211. "true",
  1212. "false",
  1213. "yes",
  1214. "no"
  1215. ]
  1216. }
  1217. ]
  1218. },
  1219. {
  1220. "key": "authors",
  1221. "description": "Search SCM accounts which match a given query",
  1222. "since": "5.1",
  1223. "internal": false,
  1224. "post": false,
  1225. "hasResponseExample": true,
  1226. "changelog": [],
  1227. "params": [
  1228. {
  1229. "key": "ps",
  1230. "description": "The size of the list to return",
  1231. "required": false,
  1232. "internal": false,
  1233. "defaultValue": "10",
  1234. "exampleValue": "25"
  1235. },
  1236. {
  1237. "key": "q",
  1238. "description": "A pattern to match SCM accounts against",
  1239. "required": false,
  1240. "internal": false,
  1241. "exampleValue": "luke"
  1242. }
  1243. ]
  1244. },
  1245. {
  1246. "key": "bulk_change",
  1247. "description": "Bulk change on issues.<br/>Requires authentication.",
  1248. "since": "3.7",
  1249. "internal": false,
  1250. "post": true,
  1251. "hasResponseExample": true,
  1252. "changelog": [
  1253. {
  1254. "description": "'actions' parameter is ignored",
  1255. "version": "6.3"
  1256. }
  1257. ],
  1258. "params": [
  1259. {
  1260. "key": "add_tags",
  1261. "description": "Add tags",
  1262. "required": false,
  1263. "internal": false,
  1264. "exampleValue": "security,java8",
  1265. "deprecatedKey": "add_tags.tags",
  1266. "deprecatedKeySince": "6.2"
  1267. },
  1268. {
  1269. "key": "assign",
  1270. "description": "To assign the list of issues to a specific user (login), or un-assign all the issues",
  1271. "required": false,
  1272. "internal": false,
  1273. "exampleValue": "john.smith",
  1274. "deprecatedKey": "assign.assignee",
  1275. "deprecatedKeySince": "6.2"
  1276. },
  1277. {
  1278. "key": "comment",
  1279. "description": "To add a comment to a list of issues",
  1280. "required": false,
  1281. "internal": false,
  1282. "exampleValue": "Here is my comment"
  1283. },
  1284. {
  1285. "key": "do_transition",
  1286. "description": "Transition",
  1287. "required": false,
  1288. "internal": false,
  1289. "exampleValue": "reopen",
  1290. "deprecatedKey": "do_transition.transition",
  1291. "deprecatedKeySince": "6.2",
  1292. "possibleValues": [
  1293. "confirm",
  1294. "unconfirm",
  1295. "reopen",
  1296. "resolve",
  1297. "falsepositive",
  1298. "wontfix",
  1299. "close"
  1300. ]
  1301. },
  1302. {
  1303. "key": "issues",
  1304. "description": "Comma-separated list of issue keys",
  1305. "required": true,
  1306. "internal": false,
  1307. "exampleValue": "AU-Tpxb--iU5OvuD2FLy,AU-TpxcA-iU5OvuD2FLz"
  1308. },
  1309. {
  1310. "key": "plan",
  1311. "description": "In 5.5, action plans are dropped. Has no effect. To plan the list of issues to a specific action plan (key), or unlink all the issues from an action plan",
  1312. "required": false,
  1313. "internal": false,
  1314. "deprecatedSince": "5.5"
  1315. },
  1316. {
  1317. "key": "remove_tags",
  1318. "description": "Remove tags",
  1319. "required": false,
  1320. "internal": false,
  1321. "exampleValue": "security,java8",
  1322. "deprecatedKey": "remove_tags.tags",
  1323. "deprecatedKeySince": "6.2"
  1324. },
  1325. {
  1326. "key": "sendNotifications",
  1327. "since": "4.0",
  1328. "required": false,
  1329. "internal": false,
  1330. "defaultValue": "false",
  1331. "possibleValues": [
  1332. "true",
  1333. "false",
  1334. "yes",
  1335. "no"
  1336. ]
  1337. },
  1338. {
  1339. "key": "set_severity",
  1340. "description": "To change the severity of the list of issues",
  1341. "required": false,
  1342. "internal": false,
  1343. "exampleValue": "BLOCKER",
  1344. "deprecatedKey": "set_severity.severity",
  1345. "deprecatedKeySince": "6.2",
  1346. "possibleValues": [
  1347. "INFO",
  1348. "MINOR",
  1349. "MAJOR",
  1350. "CRITICAL",
  1351. "BLOCKER"
  1352. ]
  1353. },
  1354. {
  1355. "key": "set_type",
  1356. "description": "To change the type of the list of issues",
  1357. "since": "5.5",
  1358. "required": false,
  1359. "internal": false,
  1360. "exampleValue": "BUG",
  1361. "deprecatedKey": "set_type.type",
  1362. "deprecatedKeySince": "6.2",
  1363. "possibleValues": [
  1364. "CODE_SMELL",
  1365. "BUG",
  1366. "VULNERABILITY"
  1367. ]
  1368. }
  1369. ]
  1370. },
  1371. {
  1372. "key": "changelog",
  1373. "description": "Display changelog of an issue.<br/>Requires the 'Browse' permission on the project of the specified issue.",
  1374. "since": "4.1",
  1375. "internal": false,
  1376. "post": false,
  1377. "hasResponseExample": true,
  1378. "changelog": [
  1379. {
  1380. "description": "changes on effort is expressed with the raw value in minutes (instead of the duration previously)",
  1381. "version": "6.3"
  1382. }
  1383. ],
  1384. "params": [
  1385. {
  1386. "key": "issue",
  1387. "description": "Issue key",
  1388. "required": true,
  1389. "internal": false,
  1390. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  1391. }
  1392. ]
  1393. },
  1394. {
  1395. "key": "component_tags",
  1396. "description": "List tags for the issues under a given component (including issues on the descendants of the component)",
  1397. "since": "5.1",
  1398. "internal": true,
  1399. "post": false,
  1400. "hasResponseExample": true,
  1401. "changelog": [],
  1402. "params": [
  1403. {
  1404. "key": "componentUuid",
  1405. "description": "A component UUID",
  1406. "required": true,
  1407. "internal": false,
  1408. "exampleValue": "7d8749e8-3070-4903-9188-bdd82933bb92"
  1409. },
  1410. {
  1411. "key": "createdAfter",
  1412. "description": "To retrieve tags on issues created after the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided.",
  1413. "required": false,
  1414. "internal": false,
  1415. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  1416. },
  1417. {
  1418. "key": "ps",
  1419. "description": "The maximum size of the list to return",
  1420. "required": false,
  1421. "internal": false,
  1422. "defaultValue": "10",
  1423. "exampleValue": "25"
  1424. }
  1425. ]
  1426. },
  1427. {
  1428. "key": "delete_comment",
  1429. "description": "Delete a comment.<br/>Requires authentication and the following permission: 'Browse' on the project of the specified issue.",
  1430. "since": "3.6",
  1431. "internal": false,
  1432. "post": true,
  1433. "hasResponseExample": true,
  1434. "changelog": [
  1435. {
  1436. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  1437. "version": "6.5"
  1438. },
  1439. {
  1440. "description": "the database ids of the components are removed from the response",
  1441. "version": "6.5"
  1442. },
  1443. {
  1444. "description": "the response returns the issue with all its details",
  1445. "version": "6.3"
  1446. },
  1447. {
  1448. "description": "the 'key' parameter is renamed 'comment'",
  1449. "version": "6.3"
  1450. }
  1451. ],
  1452. "params": [
  1453. {
  1454. "key": "comment",
  1455. "description": "Comment key",
  1456. "since": "6.3",
  1457. "required": true,
  1458. "internal": false,
  1459. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  1460. "deprecatedKey": "key",
  1461. "deprecatedKeySince": "6.3"
  1462. }
  1463. ]
  1464. },
  1465. {
  1466. "key": "do_transition",
  1467. "description": "Do workflow transition on an issue. Requires authentication and Browse permission on project.<br/>The transitions 'wontfix' and 'falsepositive' require the permission 'Administer Issues'.",
  1468. "since": "3.6",
  1469. "internal": false,
  1470. "post": true,
  1471. "hasResponseExample": true,
  1472. "changelog": [
  1473. {
  1474. "description": "the database ids of the components are removed from the response",
  1475. "version": "6.5"
  1476. },
  1477. {
  1478. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  1479. "version": "6.5"
  1480. }
  1481. ],
  1482. "params": [
  1483. {
  1484. "key": "issue",
  1485. "description": "Issue key",
  1486. "required": true,
  1487. "internal": false,
  1488. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  1489. },
  1490. {
  1491. "key": "transition",
  1492. "description": "Transition",
  1493. "required": true,
  1494. "internal": false,
  1495. "possibleValues": [
  1496. "confirm",
  1497. "unconfirm",
  1498. "reopen",
  1499. "resolve",
  1500. "falsepositive",
  1501. "wontfix",
  1502. "close"
  1503. ]
  1504. }
  1505. ]
  1506. },
  1507. {
  1508. "key": "edit_comment",
  1509. "description": "Edit a comment.<br/>Requires authentication and the following permission: 'Browse' on the project of the specified issue.",
  1510. "since": "3.6",
  1511. "internal": false,
  1512. "post": true,
  1513. "hasResponseExample": true,
  1514. "changelog": [
  1515. {
  1516. "description": "the database ids of the components are removed from the response",
  1517. "version": "6.5"
  1518. },
  1519. {
  1520. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  1521. "version": "6.5"
  1522. },
  1523. {
  1524. "description": "the response returns the issue with all its details",
  1525. "version": "6.3"
  1526. },
  1527. {
  1528. "description": "the 'key' parameter has been renamed comment",
  1529. "version": "6.3"
  1530. }
  1531. ],
  1532. "params": [
  1533. {
  1534. "key": "comment",
  1535. "description": "Comment key",
  1536. "since": "6.3",
  1537. "required": true,
  1538. "internal": false,
  1539. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  1540. "deprecatedKey": "key",
  1541. "deprecatedKeySince": "6.3"
  1542. },
  1543. {
  1544. "key": "text",
  1545. "description": "Comment text",
  1546. "required": true,
  1547. "internal": false,
  1548. "exampleValue": "Won't fix because it doesn't apply to the context"
  1549. }
  1550. ]
  1551. },
  1552. {
  1553. "key": "search",
  1554. "description": "Search for issues.<br>At most one of the following parameters can be provided at the same time: componentKeys, componentUuids, components, componentRootUuids, componentRoots.<br>Requires the 'Browse' permission on the specified project(s).",
  1555. "since": "3.6",
  1556. "internal": false,
  1557. "post": false,
  1558. "hasResponseExample": true,
  1559. "changelog": [
  1560. {
  1561. "description": "parameters 'projects', 'projectUuids', 'moduleUuids', 'directories', 'fileUuids' are marked as internal",
  1562. "version": "6.5"
  1563. },
  1564. {
  1565. "description": "response field 'email' is renamed 'avatar'",
  1566. "version": "6.3"
  1567. },
  1568. {
  1569. "description": "response fields 'reporter' and 'actionPlan' are removed (drop of action plan and manual issue features)",
  1570. "version": "5.5"
  1571. },
  1572. {
  1573. "description": "parameters 'reporters', 'actionPlans' and 'planned' are dropped and therefore ignored (drop of action plan and manual issue features)",
  1574. "version": "5.5"
  1575. },
  1576. {
  1577. "description": "response field 'debt' is renamed 'effort'",
  1578. "version": "5.5"
  1579. }
  1580. ],
  1581. "params": [
  1582. {
  1583. "key": "additionalFields",
  1584. "description": "Comma-separated list of the optional fields to be returned in response. Action plans are dropped in 5.5, it is not returned in the response.",
  1585. "since": "5.2",
  1586. "required": false,
  1587. "internal": false,
  1588. "possibleValues": [
  1589. "_all",
  1590. "comments",
  1591. "languages",
  1592. "actionPlans",
  1593. "rules",
  1594. "transitions",
  1595. "actions",
  1596. "users"
  1597. ]
  1598. },
  1599. {
  1600. "key": "asc",
  1601. "description": "Ascending sort",
  1602. "required": false,
  1603. "internal": false,
  1604. "defaultValue": "true",
  1605. "possibleValues": [
  1606. "true",
  1607. "false",
  1608. "yes",
  1609. "no"
  1610. ]
  1611. },
  1612. {
  1613. "key": "assigned",
  1614. "description": "To retrieve assigned or unassigned issues",
  1615. "required": false,
  1616. "internal": false,
  1617. "possibleValues": [
  1618. "true",
  1619. "false",
  1620. "yes",
  1621. "no"
  1622. ]
  1623. },
  1624. {
  1625. "key": "assignees",
  1626. "description": "Comma-separated list of assignee logins. The value '__me__' can be used as a placeholder for user who performs the request",
  1627. "required": false,
  1628. "internal": false,
  1629. "exampleValue": "admin,usera,__me__"
  1630. },
  1631. {
  1632. "key": "authors",
  1633. "description": "Comma-separated list of SCM accounts",
  1634. "required": false,
  1635. "internal": false,
  1636. "exampleValue": "torvalds@linux-foundation.org"
  1637. },
  1638. {
  1639. "key": "branch",
  1640. "description": "Branch key",
  1641. "since": "6.6",
  1642. "required": false,
  1643. "internal": true,
  1644. "exampleValue": "feature/my_branch"
  1645. },
  1646. {
  1647. "key": "componentKeys",
  1648. "description": "Comma-separated list of component keys. Retrieve issues associated to a specific list of components (and all its descendants). A component can be a portfolio, project, module, directory or file.",
  1649. "required": false,
  1650. "internal": false,
  1651. "exampleValue": "my_project"
  1652. },
  1653. {
  1654. "key": "componentRootUuids",
  1655. "description": "If used, will have the same meaning as componentUuids AND onComponentOnly=false.",
  1656. "required": false,
  1657. "internal": false,
  1658. "deprecatedSince": "5.1"
  1659. },
  1660. {
  1661. "key": "componentRoots",
  1662. "description": "If used, will have the same meaning as componentKeys AND onComponentOnly=false.",
  1663. "required": false,
  1664. "internal": false,
  1665. "deprecatedSince": "5.1"
  1666. },
  1667. {
  1668. "key": "componentUuids",
  1669. "description": "To retrieve issues associated to a specific list of components their sub-components (comma-separated list of component IDs). This parameter is mostly used by the Issues page, please prefer usage of the componentKeys parameter. A component can be a project, module, directory or file.",
  1670. "required": false,
  1671. "internal": false,
  1672. "exampleValue": "584a89f2-8037-4f7b-b82c-8b45d2d63fb2",
  1673. "deprecatedSince": "6.5"
  1674. },
  1675. {
  1676. "key": "components",
  1677. "description": "If used, will have the same meaning as componentKeys AND onComponentOnly=true.",
  1678. "required": false,
  1679. "internal": false,
  1680. "deprecatedSince": "5.1"
  1681. },
  1682. {
  1683. "key": "createdAfter",
  1684. "description": "To retrieve issues created after the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided. <br>If this parameter is set, createdInLast must not be set",
  1685. "required": false,
  1686. "internal": false,
  1687. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  1688. },
  1689. {
  1690. "key": "createdAt",
  1691. "description": "Datetime to retrieve issues created during a specific analysis",
  1692. "required": false,
  1693. "internal": false,
  1694. "exampleValue": "2017-10-19T13:00:00+0200"
  1695. },
  1696. {
  1697. "key": "createdBefore",
  1698. "description": "To retrieve issues created before the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided.",
  1699. "required": false,
  1700. "internal": false,
  1701. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  1702. },
  1703. {
  1704. "key": "createdInLast",
  1705. "description": "To retrieve issues created during a time span before the current time (exclusive). Accepted units are 'y' for year, 'm' for month, 'w' for week and 'd' for day. If this parameter is set, createdAfter must not be set",
  1706. "required": false,
  1707. "internal": false,
  1708. "exampleValue": "1m2w (1 month 2 weeks)"
  1709. },
  1710. {
  1711. "key": "directories",
  1712. "description": "To retrieve issues associated to a specific list of directories (comma-separated list of directory paths). This parameter is only meaningful when a module is selected. This parameter is mostly used by the Issues page, please prefer usage of the componentKeys parameter. ",
  1713. "since": "5.1",
  1714. "required": false,
  1715. "internal": true,
  1716. "exampleValue": "src/main/java/org/sonar/server/"
  1717. },
  1718. {
  1719. "key": "facetMode",
  1720. "description": "Choose the returned value for facet items, either count of issues or sum of debt.<br/>Since 5.5, 'debt' mode is deprecated and replaced by 'effort'",
  1721. "required": false,
  1722. "internal": false,
  1723. "defaultValue": "count",
  1724. "possibleValues": [
  1725. "count",
  1726. "effort",
  1727. "debt"
  1728. ]
  1729. },
  1730. {
  1731. "key": "facets",
  1732. "description": "Comma-separated list of the facets to be computed. No facet is computed by default.<br/>Since 5.5, facet 'actionPlans' is deprecated.<br/>Since 5.5, facet 'reporters' is deprecated.",
  1733. "required": false,
  1734. "internal": false,
  1735. "possibleValues": [
  1736. "severities",
  1737. "statuses",
  1738. "resolutions",
  1739. "actionPlans",
  1740. "projectUuids",
  1741. "rules",
  1742. "assignees",
  1743. "assigned_to_me",
  1744. "reporters",
  1745. "authors",
  1746. "moduleUuids",
  1747. "fileUuids",
  1748. "directories",
  1749. "languages",
  1750. "tags",
  1751. "types",
  1752. "createdAt"
  1753. ]
  1754. },
  1755. {
  1756. "key": "fileUuids",
  1757. "description": "To retrieve issues associated to a specific list of files (comma-separated list of file IDs). This parameter is mostly used by the Issues page, please prefer usage of the componentKeys parameter. ",
  1758. "required": false,
  1759. "internal": true,
  1760. "exampleValue": "bdd82933-3070-4903-9188-7d8749e8bb92"
  1761. },
  1762. {
  1763. "key": "issues",
  1764. "description": "Comma-separated list of issue keys",
  1765. "required": false,
  1766. "internal": false,
  1767. "exampleValue": "5bccd6e8-f525-43a2-8d76-fcb13dde79ef"
  1768. },
  1769. {
  1770. "key": "languages",
  1771. "description": "Comma-separated list of languages. Available since 4.4",
  1772. "required": false,
  1773. "internal": false,
  1774. "exampleValue": "java,js"
  1775. },
  1776. {
  1777. "key": "moduleUuids",
  1778. "description": "To retrieve issues associated to a specific list of modules (comma-separated list of module IDs). This parameter is mostly used by the Issues page, please prefer usage of the componentKeys parameter. ",
  1779. "required": false,
  1780. "internal": true,
  1781. "exampleValue": "7d8749e8-3070-4903-9188-bdd82933bb92"
  1782. },
  1783. {
  1784. "key": "onComponentOnly",
  1785. "description": "Return only issues at a component's level, not on its descendants (modules, directories, files, etc). This parameter is only considered when componentKeys or componentUuids is set. Using the deprecated componentRoots or componentRootUuids parameters will set this parameter to false. Using the deprecated components parameter will set this parameter to true.",
  1786. "required": false,
  1787. "internal": false,
  1788. "defaultValue": "false",
  1789. "possibleValues": [
  1790. "true",
  1791. "false",
  1792. "yes",
  1793. "no"
  1794. ]
  1795. },
  1796. {
  1797. "key": "organization",
  1798. "description": "Organization key",
  1799. "since": "6.4",
  1800. "required": false,
  1801. "internal": true,
  1802. "exampleValue": "my-org"
  1803. },
  1804. {
  1805. "key": "p",
  1806. "description": "1-based page number",
  1807. "required": false,
  1808. "internal": false,
  1809. "defaultValue": "1",
  1810. "exampleValue": "42",
  1811. "deprecatedKey": "pageIndex",
  1812. "deprecatedKeySince": "5.2"
  1813. },
  1814. {
  1815. "key": "projectUuids",
  1816. "description": "To retrieve issues associated to a specific list of projects (comma-separated list of project IDs). This parameter is mostly used by the Issues page, please prefer usage of the componentKeys parameter. Portfolios are not supported. If this parameter is set, 'projects' must not be set.",
  1817. "required": false,
  1818. "internal": true,
  1819. "exampleValue": "7d8749e8-3070-4903-9188-bdd82933bb92"
  1820. },
  1821. {
  1822. "key": "projects",
  1823. "description": "To retrieve issues associated to a specific list of projects (comma-separated list of project keys). This parameter is mostly used by the Issues page, please prefer usage of the componentKeys parameter. If this parameter is set, projectUuids must not be set.",
  1824. "required": false,
  1825. "internal": true,
  1826. "exampleValue": "my_project",
  1827. "deprecatedKey": "projectKeys",
  1828. "deprecatedKeySince": "6.5"
  1829. },
  1830. {
  1831. "key": "ps",
  1832. "description": "Page size. Must be greater than 0 and less than 500",
  1833. "required": false,
  1834. "internal": false,
  1835. "defaultValue": "100",
  1836. "exampleValue": "20",
  1837. "deprecatedKey": "pageSize",
  1838. "deprecatedKeySince": "5.2",
  1839. "maximumValue": 500
  1840. },
  1841. {
  1842. "key": "resolutions",
  1843. "description": "Comma-separated list of resolutions",
  1844. "required": false,
  1845. "internal": false,
  1846. "exampleValue": "FIXED,REMOVED",
  1847. "possibleValues": [
  1848. "FALSE-POSITIVE",
  1849. "WONTFIX",
  1850. "FIXED",
  1851. "REMOVED"
  1852. ]
  1853. },
  1854. {
  1855. "key": "resolved",
  1856. "description": "To match resolved or unresolved issues",
  1857. "required": false,
  1858. "internal": false,
  1859. "possibleValues": [
  1860. "true",
  1861. "false",
  1862. "yes",
  1863. "no"
  1864. ]
  1865. },
  1866. {
  1867. "key": "rules",
  1868. "description": "Comma-separated list of coding rule keys. Format is &lt;repository&gt;:&lt;rule&gt;",
  1869. "required": false,
  1870. "internal": false,
  1871. "exampleValue": "squid:AvoidCycles"
  1872. },
  1873. {
  1874. "key": "s",
  1875. "description": "Sort field",
  1876. "required": false,
  1877. "internal": false,
  1878. "deprecatedKey": "sort",
  1879. "deprecatedKeySince": "5.4",
  1880. "possibleValues": [
  1881. "CREATION_DATE",
  1882. "UPDATE_DATE",
  1883. "CLOSE_DATE",
  1884. "ASSIGNEE",
  1885. "SEVERITY",
  1886. "STATUS",
  1887. "FILE_LINE"
  1888. ]
  1889. },
  1890. {
  1891. "key": "severities",
  1892. "description": "Comma-separated list of severities",
  1893. "required": false,
  1894. "internal": false,
  1895. "exampleValue": "BLOCKER,CRITICAL",
  1896. "possibleValues": [
  1897. "INFO",
  1898. "MINOR",
  1899. "MAJOR",
  1900. "CRITICAL",
  1901. "BLOCKER"
  1902. ]
  1903. },
  1904. {
  1905. "key": "sinceLeakPeriod",
  1906. "description": "To retrieve issues created since the leak period.<br>If this parameter is set to a truthy value, createdAfter must not be set and one component id or key must be provided.",
  1907. "required": false,
  1908. "internal": false,
  1909. "defaultValue": "false",
  1910. "possibleValues": [
  1911. "true",
  1912. "false",
  1913. "yes",
  1914. "no"
  1915. ]
  1916. },
  1917. {
  1918. "key": "statuses",
  1919. "description": "Comma-separated list of statuses",
  1920. "required": false,
  1921. "internal": false,
  1922. "exampleValue": "OPEN,REOPENED",
  1923. "possibleValues": [
  1924. "OPEN",
  1925. "CONFIRMED",
  1926. "REOPENED",
  1927. "RESOLVED",
  1928. "CLOSED"
  1929. ]
  1930. },
  1931. {
  1932. "key": "tags",
  1933. "description": "Comma-separated list of tags.",
  1934. "required": false,
  1935. "internal": false,
  1936. "exampleValue": "security,convention"
  1937. },
  1938. {
  1939. "key": "types",
  1940. "description": "Comma-separated list of types.",
  1941. "since": "5.5",
  1942. "required": false,
  1943. "internal": false,
  1944. "exampleValue": "CODE_SMELL,BUG",
  1945. "possibleValues": [
  1946. "CODE_SMELL",
  1947. "BUG",
  1948. "VULNERABILITY"
  1949. ]
  1950. }
  1951. ]
  1952. },
  1953. {
  1954. "key": "set_severity",
  1955. "description": "Change severity.<br/>Requires the following permissions:<ul> <li>'Authentication'</li> <li>'Browse' rights on project of the specified issue</li> <li>'Administer Issues' rights on project of the specified issue</li></ul>",
  1956. "since": "3.6",
  1957. "internal": false,
  1958. "post": true,
  1959. "hasResponseExample": true,
  1960. "changelog": [
  1961. {
  1962. "description": "the database ids of the components are removed from the response",
  1963. "version": "6.5"
  1964. },
  1965. {
  1966. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  1967. "version": "6.5"
  1968. }
  1969. ],
  1970. "params": [
  1971. {
  1972. "key": "issue",
  1973. "description": "Issue key",
  1974. "required": true,
  1975. "internal": false,
  1976. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  1977. },
  1978. {
  1979. "key": "severity",
  1980. "description": "New severity",
  1981. "required": true,
  1982. "internal": false,
  1983. "possibleValues": [
  1984. "INFO",
  1985. "MINOR",
  1986. "MAJOR",
  1987. "CRITICAL",
  1988. "BLOCKER"
  1989. ]
  1990. }
  1991. ]
  1992. },
  1993. {
  1994. "key": "set_tags",
  1995. "description": "Set tags on an issue. <br/>Requires authentication and Browse permission on project",
  1996. "since": "5.1",
  1997. "internal": false,
  1998. "post": true,
  1999. "hasResponseExample": true,
  2000. "changelog": [
  2001. {
  2002. "description": "the database ids of the components are removed from the response",
  2003. "version": "6.5"
  2004. },
  2005. {
  2006. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  2007. "version": "6.5"
  2008. },
  2009. {
  2010. "description": "response contains issue information instead of list of tags",
  2011. "version": "6.4"
  2012. }
  2013. ],
  2014. "params": [
  2015. {
  2016. "key": "issue",
  2017. "description": "Issue key",
  2018. "since": "6.3",
  2019. "required": true,
  2020. "internal": false,
  2021. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  2022. "deprecatedKey": "key",
  2023. "deprecatedKeySince": "6.3"
  2024. },
  2025. {
  2026. "key": "tags",
  2027. "description": "Comma-separated list of tags. All tags are removed if parameter is empty or not set.",
  2028. "required": false,
  2029. "internal": false,
  2030. "exampleValue": "security,cwe,misra-c"
  2031. }
  2032. ]
  2033. },
  2034. {
  2035. "key": "set_type",
  2036. "description": "Change type of issue, for instance from 'code smell' to 'bug'.<br/>Requires the following permissions:<ul> <li>'Authentication'</li> <li>'Browse' rights on project of the specified issue</li> <li>'Administer Issues' rights on project of the specified issue</li></ul>",
  2037. "since": "5.5",
  2038. "internal": false,
  2039. "post": true,
  2040. "hasResponseExample": true,
  2041. "changelog": [
  2042. {
  2043. "description": "the database ids of the components are removed from the response",
  2044. "version": "6.5"
  2045. },
  2046. {
  2047. "description": "the response field components.uuid is deprecated. Use components.key instead.",
  2048. "version": "6.5"
  2049. }
  2050. ],
  2051. "params": [
  2052. {
  2053. "key": "issue",
  2054. "description": "Issue key",
  2055. "required": true,
  2056. "internal": false,
  2057. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  2058. },
  2059. {
  2060. "key": "type",
  2061. "description": "New type",
  2062. "required": true,
  2063. "internal": false,
  2064. "possibleValues": [
  2065. "CODE_SMELL",
  2066. "BUG",
  2067. "VULNERABILITY"
  2068. ]
  2069. }
  2070. ]
  2071. },
  2072. {
  2073. "key": "tags",
  2074. "description": "List tags matching a given query",
  2075. "since": "5.1",
  2076. "internal": false,
  2077. "post": false,
  2078. "hasResponseExample": true,
  2079. "changelog": [],
  2080. "params": [
  2081. {
  2082. "key": "organization",
  2083. "description": "Organization key",
  2084. "since": "6.4",
  2085. "required": false,
  2086. "internal": true,
  2087. "exampleValue": "my-org"
  2088. },
  2089. {
  2090. "key": "ps",
  2091. "description": "Page size. Must be greater than 0 and less than 100",
  2092. "required": false,
  2093. "internal": false,
  2094. "defaultValue": "10",
  2095. "exampleValue": "20",
  2096. "deprecatedKey": "pageSize",
  2097. "deprecatedKeySince": "5.2",
  2098. "maximumValue": 100
  2099. },
  2100. {
  2101. "key": "q",
  2102. "description": "Limit search to tags that contain the supplied string.",
  2103. "required": false,
  2104. "internal": false,
  2105. "exampleValue": "misra"
  2106. }
  2107. ]
  2108. }
  2109. ]
  2110. },
  2111. {
  2112. "path": "api/l10n",
  2113. "since": "4.4",
  2114. "description": "Manage localization.",
  2115. "actions": [
  2116. {
  2117. "key": "index",
  2118. "description": "Get all localization messages for a given locale",
  2119. "since": "4.4",
  2120. "internal": true,
  2121. "post": false,
  2122. "hasResponseExample": true,
  2123. "changelog": [],
  2124. "params": [
  2125. {
  2126. "key": "locale",
  2127. "description": "BCP47 language tag, used to override the browser Accept-Language header",
  2128. "required": false,
  2129. "internal": false,
  2130. "defaultValue": "en",
  2131. "exampleValue": "fr-CH"
  2132. },
  2133. {
  2134. "key": "ts",
  2135. "description": "Date of the last cache update.",
  2136. "required": false,
  2137. "internal": false,
  2138. "exampleValue": "2014-06-04T09:31:42+0000"
  2139. }
  2140. ]
  2141. }
  2142. ]
  2143. },
  2144. {
  2145. "path": "api/languages",
  2146. "since": "5.1",
  2147. "description": "Get the list of programming languages supported in this instance.",
  2148. "actions": [
  2149. {
  2150. "key": "list",
  2151. "description": "List supported programming languages",
  2152. "since": "5.1",
  2153. "internal": false,
  2154. "post": false,
  2155. "hasResponseExample": true,
  2156. "changelog": [],
  2157. "params": [
  2158. {
  2159. "key": "ps",
  2160. "description": "The size of the list to return, 0 for all languages",
  2161. "required": false,
  2162. "internal": false,
  2163. "defaultValue": "0",
  2164. "exampleValue": "25"
  2165. },
  2166. {
  2167. "key": "q",
  2168. "description": "A pattern to match language keys/names against",
  2169. "required": false,
  2170. "internal": false,
  2171. "exampleValue": "java"
  2172. }
  2173. ]
  2174. }
  2175. ]
  2176. },
  2177. {
  2178. "path": "api/measures",
  2179. "since": "5.4",
  2180. "description": "Get components or children with specified measures.",
  2181. "actions": [
  2182. {
  2183. "key": "component",
  2184. "description": "Return component with specified measures. The componentId or the component parameter must be provided.<br>Requires the following permission: 'Browse' on the project of specified component.",
  2185. "since": "5.4",
  2186. "internal": false,
  2187. "post": false,
  2188. "hasResponseExample": true,
  2189. "changelog": [
  2190. {
  2191. "description": "the response field id is deprecated. Use key instead.",
  2192. "version": "6.6"
  2193. },
  2194. {
  2195. "description": "the response field refId is deprecated. Use refKey instead.",
  2196. "version": "6.6"
  2197. }
  2198. ],
  2199. "params": [
  2200. {
  2201. "key": "additionalFields",
  2202. "description": "Comma-separated list of additional fields that can be returned in the response.",
  2203. "required": false,
  2204. "internal": false,
  2205. "exampleValue": "periods,metrics",
  2206. "possibleValues": [
  2207. "metrics",
  2208. "periods"
  2209. ]
  2210. },
  2211. {
  2212. "key": "branch",
  2213. "description": "Branch key",
  2214. "since": "6.6",
  2215. "required": false,
  2216. "internal": true,
  2217. "exampleValue": "feature/my_branch"
  2218. },
  2219. {
  2220. "key": "component",
  2221. "description": "Component key",
  2222. "required": false,
  2223. "internal": false,
  2224. "exampleValue": "my_project",
  2225. "deprecatedKey": "componentKey",
  2226. "deprecatedKeySince": "6.6"
  2227. },
  2228. {
  2229. "key": "componentId",
  2230. "description": "Component id",
  2231. "required": false,
  2232. "internal": false,
  2233. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  2234. "deprecatedSince": "6.6"
  2235. },
  2236. {
  2237. "key": "developerId",
  2238. "description": "Deprecated parameter, used previously with the Developer Cockpit plugin. No measures are returned if parameter is set.",
  2239. "required": false,
  2240. "internal": false,
  2241. "deprecatedSince": "6.4"
  2242. },
  2243. {
  2244. "key": "developerKey",
  2245. "description": "Deprecated parameter, used previously with the Developer Cockpit plugin. No measures are returned if parameter is set.",
  2246. "required": false,
  2247. "internal": false,
  2248. "deprecatedSince": "6.4"
  2249. },
  2250. {
  2251. "key": "metricKeys",
  2252. "description": "Metric keys",
  2253. "required": true,
  2254. "internal": false,
  2255. "exampleValue": "ncloc,complexity,violations"
  2256. }
  2257. ]
  2258. },
  2259. {
  2260. "key": "component_tree",
  2261. "description": "Navigate through components based on the chosen strategy with specified measures. The baseComponentId or the component parameter must be provided.<br>Requires the following permission: 'Browse' on the specified project.<br>When limiting search with the q parameter, directories are not returned.",
  2262. "since": "5.4",
  2263. "internal": false,
  2264. "post": false,
  2265. "hasResponseExample": true,
  2266. "changelog": [
  2267. {
  2268. "description": "the response field id is deprecated. Use key instead.",
  2269. "version": "6.6"
  2270. },
  2271. {
  2272. "description": "the response field refId is deprecated. Use refKey instead.",
  2273. "version": "6.6"
  2274. },
  2275. {
  2276. "description": "Number of metric keys is limited to 15",
  2277. "version": "6.3"
  2278. }
  2279. ],
  2280. "params": [
  2281. {
  2282. "key": "additionalFields",
  2283. "description": "Comma-separated list of additional fields that can be returned in the response.",
  2284. "required": false,
  2285. "internal": false,
  2286. "exampleValue": "periods,metrics",
  2287. "possibleValues": [
  2288. "metrics",
  2289. "periods"
  2290. ]
  2291. },
  2292. {
  2293. "key": "asc",
  2294. "description": "Ascending sort",
  2295. "required": false,
  2296. "internal": false,
  2297. "defaultValue": "true",
  2298. "possibleValues": [
  2299. "true",
  2300. "false",
  2301. "yes",
  2302. "no"
  2303. ]
  2304. },
  2305. {
  2306. "key": "baseComponentId",
  2307. "description": "Base component id. The search is based on this component.",
  2308. "required": false,
  2309. "internal": false,
  2310. "exampleValue": "AU-TpxcA-iU5OvuD2FLz",
  2311. "deprecatedSince": "6.6"
  2312. },
  2313. {
  2314. "key": "branch",
  2315. "description": "Branch key",
  2316. "since": "6.6",
  2317. "required": false,
  2318. "internal": true,
  2319. "exampleValue": "feature/my_branch"
  2320. },
  2321. {
  2322. "key": "component",
  2323. "description": "Component key. The search is based on this component.",
  2324. "required": false,
  2325. "internal": false,
  2326. "exampleValue": "my_project",
  2327. "deprecatedKey": "baseComponentKey",
  2328. "deprecatedKeySince": "6.6"
  2329. },
  2330. {
  2331. "key": "developerId",
  2332. "description": "Deprecated parameter, used previously with the Developer Cockpit plugin. No measures are returned if parameter is set.",
  2333. "required": false,
  2334. "internal": false,
  2335. "deprecatedSince": "6.4"
  2336. },
  2337. {
  2338. "key": "developerKey",
  2339. "description": "Deprecated parameter, used previously with the Developer Cockpit plugin. No measures are returned if parameter is set.",
  2340. "required": false,
  2341. "internal": false,
  2342. "deprecatedSince": "6.4"
  2343. },
  2344. {
  2345. "key": "metricKeys",
  2346. "description": "Metric keys. Types DISTRIB, DATA are not allowed",
  2347. "required": true,
  2348. "internal": false,
  2349. "exampleValue": "ncloc,complexity,violations",
  2350. "maxValuesAllowed": 15
  2351. },
  2352. {
  2353. "key": "metricPeriodSort",
  2354. "description": "Sort measures by leak period or not ?. The 's' parameter must contain the 'metricPeriod' value.",
  2355. "since": "5.5",
  2356. "required": false,
  2357. "internal": false,
  2358. "possibleValues": [
  2359. "1"
  2360. ]
  2361. },
  2362. {
  2363. "key": "metricSort",
  2364. "description": "Metric key to sort by. The 's' parameter must contain the 'metric' or 'metricPeriod' value. It must be part of the 'metricKeys' parameter",
  2365. "required": false,
  2366. "internal": false,
  2367. "exampleValue": "ncloc"
  2368. },
  2369. {
  2370. "key": "metricSortFilter",
  2371. "description": "Filter components. Sort must be on a metric. Possible values are: <ul><li>all: return all components</li><li>withMeasuresOnly: filter out components that do not have a measure on the sorted metric</li></ul>",
  2372. "required": false,
  2373. "internal": false,
  2374. "defaultValue": "all",
  2375. "possibleValues": [
  2376. "all",
  2377. "withMeasuresOnly"
  2378. ]
  2379. },
  2380. {
  2381. "key": "p",
  2382. "description": "1-based page number",
  2383. "required": false,
  2384. "internal": false,
  2385. "defaultValue": "1",
  2386. "exampleValue": "42",
  2387. "deprecatedKey": "pageIndex",
  2388. "deprecatedKeySince": "5.2"
  2389. },
  2390. {
  2391. "key": "ps",
  2392. "description": "Page size. Must be greater than 0 and less than 500",
  2393. "required": false,
  2394. "internal": false,
  2395. "defaultValue": "100",
  2396. "exampleValue": "20",
  2397. "deprecatedKey": "pageSize",
  2398. "deprecatedKeySince": "5.2",
  2399. "maximumValue": 500
  2400. },
  2401. {
  2402. "key": "q",
  2403. "description": "Limit search to: <ul><li>component names that contain the supplied string</li><li>component keys that are exactly the same as the supplied string</li></ul>Must have at least 3 characters.",
  2404. "required": false,
  2405. "internal": false,
  2406. "exampleValue": "FILE_NAM"
  2407. },
  2408. {
  2409. "key": "qualifiers",
  2410. "description": "Comma-separated list of component qualifiers. Filter the results with the specified qualifiers. Possible values are:<ul><li>BRC - Sub-projects</li><li>DIR - Directories</li><li>FIL - Files</li><li>TRK - Projects</li><li>UTS - Test Files</li></ul>",
  2411. "required": false,
  2412. "internal": false,
  2413. "possibleValues": [
  2414. "BRC",
  2415. "DIR",
  2416. "FIL",
  2417. "TRK",
  2418. "UTS"
  2419. ]
  2420. },
  2421. {
  2422. "key": "s",
  2423. "description": "Comma-separated list of sort fields",
  2424. "required": false,
  2425. "internal": false,
  2426. "defaultValue": "name",
  2427. "exampleValue": "name,path",
  2428. "deprecatedKey": "sort",
  2429. "deprecatedKeySince": "5.4",
  2430. "possibleValues": [
  2431. "metric",
  2432. "metricPeriod",
  2433. "name",
  2434. "path",
  2435. "qualifier"
  2436. ]
  2437. },
  2438. {
  2439. "key": "strategy",
  2440. "description": "Strategy to search for base component descendants:<ul><li>children: return the children components of the base component. Grandchildren components are not returned</li><li>all: return all the descendants components of the base component. Grandchildren are returned.</li><li>leaves: return all the descendant components (files, in general) which don't have other children. They are the leaves of the component tree.</li></ul>",
  2441. "required": false,
  2442. "internal": false,
  2443. "defaultValue": "all",
  2444. "possibleValues": [
  2445. "all",
  2446. "children",
  2447. "leaves"
  2448. ]
  2449. }
  2450. ]
  2451. },
  2452. {
  2453. "key": "search",
  2454. "description": "Search for project measures ordered by project names.<br>At most 100 projects can be provided.<br>Returns the projects with the 'Browse' permission.",
  2455. "since": "6.2",
  2456. "internal": true,
  2457. "post": false,
  2458. "hasResponseExample": true,
  2459. "changelog": [],
  2460. "params": [
  2461. {
  2462. "key": "metricKeys",
  2463. "description": "Metric keys",
  2464. "required": true,
  2465. "internal": false,
  2466. "exampleValue": "ncloc,complexity,violations"
  2467. },
  2468. {
  2469. "key": "projectKeys",
  2470. "description": "Comma-separated list of project, view or sub-view keys",
  2471. "required": true,
  2472. "internal": false,
  2473. "exampleValue": "my_project,another_project"
  2474. }
  2475. ]
  2476. },
  2477. {
  2478. "key": "search_history",
  2479. "description": "Search measures history of a component.<br>Measures are ordered chronologically.<br>Pagination applies to the number of measures for each metric.<br>Requires the following permission: 'Browse' on the specified component",
  2480. "since": "6.3",
  2481. "internal": false,
  2482. "post": false,
  2483. "hasResponseExample": true,
  2484. "changelog": [],
  2485. "params": [
  2486. {
  2487. "key": "branch",
  2488. "description": "Branch key",
  2489. "since": "6.6",
  2490. "required": false,
  2491. "internal": true,
  2492. "exampleValue": "feature/my_branch"
  2493. },
  2494. {
  2495. "key": "component",
  2496. "description": "Component key",
  2497. "required": true,
  2498. "internal": false,
  2499. "exampleValue": "my_project"
  2500. },
  2501. {
  2502. "key": "from",
  2503. "description": "Filter measures created after the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided",
  2504. "required": false,
  2505. "internal": false,
  2506. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  2507. },
  2508. {
  2509. "key": "metrics",
  2510. "description": "Comma-separated list of metric keys",
  2511. "required": true,
  2512. "internal": false,
  2513. "exampleValue": "ncloc,coverage,new_violations"
  2514. },
  2515. {
  2516. "key": "p",
  2517. "description": "1-based page number",
  2518. "required": false,
  2519. "internal": false,
  2520. "defaultValue": "1",
  2521. "exampleValue": "42",
  2522. "deprecatedKey": "pageIndex",
  2523. "deprecatedKeySince": "5.2"
  2524. },
  2525. {
  2526. "key": "ps",
  2527. "description": "Page size. Must be greater than 0 and less than 1000",
  2528. "required": false,
  2529. "internal": false,
  2530. "defaultValue": "100",
  2531. "exampleValue": "20",
  2532. "deprecatedKey": "pageSize",
  2533. "deprecatedKeySince": "5.2",
  2534. "maximumValue": 1000
  2535. },
  2536. {
  2537. "key": "to",
  2538. "description": "Filter measures created before the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided",
  2539. "required": false,
  2540. "internal": false,
  2541. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  2542. }
  2543. ]
  2544. }
  2545. ]
  2546. },
  2547. {
  2548. "path": "api/metrics",
  2549. "since": "2.6",
  2550. "description": "Get information on automatic metrics, and manage metrics.",
  2551. "actions": [
  2552. {
  2553. "key": "search",
  2554. "description": "Search for metrics",
  2555. "since": "5.2",
  2556. "internal": false,
  2557. "post": false,
  2558. "hasResponseExample": true,
  2559. "changelog": [],
  2560. "params": [
  2561. {
  2562. "key": "f",
  2563. "description": "Comma-separated list of the fields to be returned in response. All the fields are returned by default.",
  2564. "required": false,
  2565. "internal": false,
  2566. "possibleValues": [
  2567. "name",
  2568. "description",
  2569. "domain",
  2570. "direction",
  2571. "qualitative",
  2572. "hidden",
  2573. "custom",
  2574. "decimalScale"
  2575. ]
  2576. },
  2577. {
  2578. "key": "isCustom",
  2579. "description": "Choose custom metrics following 3 cases:<ul><li>true: only custom metrics are returned</li><li>false: only non custom metrics are returned</li><li>not specified: all metrics are returned</li></ul>",
  2580. "required": false,
  2581. "internal": false,
  2582. "exampleValue": "true"
  2583. },
  2584. {
  2585. "key": "p",
  2586. "description": "1-based page number",
  2587. "required": false,
  2588. "internal": false,
  2589. "defaultValue": "1",
  2590. "exampleValue": "42",
  2591. "deprecatedKey": "pageIndex",
  2592. "deprecatedKeySince": "5.2"
  2593. },
  2594. {
  2595. "key": "ps",
  2596. "description": "Page size. Must be greater than 0 and less than 500",
  2597. "required": false,
  2598. "internal": false,
  2599. "defaultValue": "100",
  2600. "exampleValue": "20",
  2601. "deprecatedKey": "pageSize",
  2602. "deprecatedKeySince": "5.2",
  2603. "maximumValue": 500
  2604. }
  2605. ]
  2606. },
  2607. {
  2608. "key": "types",
  2609. "description": "List all available metric types.",
  2610. "since": "5.2",
  2611. "internal": false,
  2612. "post": false,
  2613. "hasResponseExample": true,
  2614. "changelog": []
  2615. }
  2616. ]
  2617. },
  2618. {
  2619. "path": "api/navigation",
  2620. "since": "5.2",
  2621. "description": "Get information required to build navigation UI components",
  2622. "actions": [
  2623. {
  2624. "key": "component",
  2625. "description": "Get information concerning component navigation for the current user. Requires the 'Browse' permission on the component's project.",
  2626. "since": "5.2",
  2627. "internal": true,
  2628. "post": false,
  2629. "hasResponseExample": true,
  2630. "changelog": [
  2631. {
  2632. "description": "The 'visibility' field is added",
  2633. "version": "6.4"
  2634. }
  2635. ],
  2636. "params": [
  2637. {
  2638. "key": "branch",
  2639. "description": "Branch key",
  2640. "required": false,
  2641. "internal": true,
  2642. "exampleValue": "feature/my_branch"
  2643. },
  2644. {
  2645. "key": "component",
  2646. "description": "A component key.",
  2647. "required": false,
  2648. "internal": false,
  2649. "exampleValue": "my_project",
  2650. "deprecatedKey": "componentKey",
  2651. "deprecatedKeySince": "6.4"
  2652. }
  2653. ]
  2654. },
  2655. {
  2656. "key": "global",
  2657. "description": "Get information concerning global navigation for the current user.",
  2658. "since": "5.2",
  2659. "internal": true,
  2660. "post": false,
  2661. "hasResponseExample": true,
  2662. "changelog": []
  2663. },
  2664. {
  2665. "key": "organization",
  2666. "description": "Get information concerning organization navigation for the current user",
  2667. "since": "6.3",
  2668. "internal": true,
  2669. "post": false,
  2670. "hasResponseExample": true,
  2671. "changelog": [
  2672. {
  2673. "description": "The field 'projectVisibility' is added",
  2674. "version": "6.4"
  2675. }
  2676. ],
  2677. "params": [
  2678. {
  2679. "key": "organization",
  2680. "description": "the organization key",
  2681. "required": true,
  2682. "internal": false,
  2683. "exampleValue": "my-org"
  2684. }
  2685. ]
  2686. },
  2687. {
  2688. "key": "settings",
  2689. "description": "Get configuration information for the settings page:<ul> <li>List plugin-contributed pages</li> <li>Show update center (or not)</li></ul>",
  2690. "since": "5.2",
  2691. "internal": true,
  2692. "post": false,
  2693. "hasResponseExample": true,
  2694. "changelog": []
  2695. }
  2696. ]
  2697. },
  2698. {
  2699. "path": "api/notifications",
  2700. "since": "6.3",
  2701. "description": "Manage notifications of the authenticated user",
  2702. "actions": [
  2703. {
  2704. "key": "add",
  2705. "description": "Add a notification for the authenticated user.<br>Requires one of the following permissions:<ul> <li>Authentication if no login is provided. If a project is provided, requires the 'Browse' permission on the specified project.</li> <li>System administration if a login is provided. If a project is provided, requires the 'Browse' permission on the specified project.</li></ul>",
  2706. "since": "6.3",
  2707. "internal": false,
  2708. "post": true,
  2709. "hasResponseExample": false,
  2710. "changelog": [],
  2711. "params": [
  2712. {
  2713. "key": "channel",
  2714. "description": "Channel through which the notification is sent. For example, notifications can be sent by email.",
  2715. "required": false,
  2716. "internal": false,
  2717. "defaultValue": "EmailNotificationChannel",
  2718. "possibleValues": [
  2719. "EmailNotificationChannel"
  2720. ]
  2721. },
  2722. {
  2723. "key": "login",
  2724. "description": "User login",
  2725. "since": "6.4",
  2726. "required": false,
  2727. "internal": false
  2728. },
  2729. {
  2730. "key": "project",
  2731. "description": "Project key",
  2732. "required": false,
  2733. "internal": false,
  2734. "exampleValue": "my_project"
  2735. },
  2736. {
  2737. "key": "type",
  2738. "description": "Notification type. Possible values are for:<ul> <li>Global notifications: CeReportTaskFailure, ChangesOnMyIssue, NewAlerts, NewFalsePositiveIssue, NewIssues, SQ-MyNewIssues</li> <li>Per project notifications: CeReportTaskFailure, ChangesOnMyIssue, NewAlerts, NewFalsePositiveIssue, NewIssues, SQ-MyNewIssues</li></ul>",
  2739. "required": true,
  2740. "internal": false,
  2741. "exampleValue": "SQ-MyNewIssues"
  2742. }
  2743. ]
  2744. },
  2745. {
  2746. "key": "list",
  2747. "description": "List notifications of the authenticated user.<br>Requires one of the following permissions:<ul> <li>Authentication if no login is provided</li> <li>System administration if a login is provided</li></ul>",
  2748. "since": "6.3",
  2749. "internal": false,
  2750. "post": false,
  2751. "hasResponseExample": true,
  2752. "changelog": [],
  2753. "params": [
  2754. {
  2755. "key": "login",
  2756. "description": "User login",
  2757. "since": "6.4",
  2758. "required": false,
  2759. "internal": false
  2760. }
  2761. ]
  2762. },
  2763. {
  2764. "key": "remove",
  2765. "description": "Remove a notification for the authenticated user.<br>Requires one of the following permissions:<ul> <li>Authentication if no login is provided</li> <li>System administration if a login is provided</li></ul>",
  2766. "since": "6.3",
  2767. "internal": false,
  2768. "post": true,
  2769. "hasResponseExample": false,
  2770. "changelog": [],
  2771. "params": [
  2772. {
  2773. "key": "channel",
  2774. "description": "Channel through which the notification is sent. For example, notifications can be sent by email.",
  2775. "required": false,
  2776. "internal": false,
  2777. "defaultValue": "EmailNotificationChannel",
  2778. "possibleValues": [
  2779. "EmailNotificationChannel"
  2780. ]
  2781. },
  2782. {
  2783. "key": "login",
  2784. "description": "User login",
  2785. "since": "6.4",
  2786. "required": false,
  2787. "internal": false
  2788. },
  2789. {
  2790. "key": "project",
  2791. "description": "Project key",
  2792. "required": false,
  2793. "internal": false,
  2794. "exampleValue": "my_project"
  2795. },
  2796. {
  2797. "key": "type",
  2798. "description": "Notification type. Possible values are for:<ul> <li>Global notifications: CeReportTaskFailure, ChangesOnMyIssue, NewAlerts, NewFalsePositiveIssue, NewIssues, SQ-MyNewIssues</li> <li>Per project notifications: CeReportTaskFailure, ChangesOnMyIssue, NewAlerts, NewFalsePositiveIssue, NewIssues, SQ-MyNewIssues</li></ul>",
  2799. "required": true,
  2800. "internal": false,
  2801. "exampleValue": "SQ-MyNewIssues"
  2802. }
  2803. ]
  2804. }
  2805. ]
  2806. },
  2807. {
  2808. "path": "api/orchestrator",
  2809. "description": "Orchestrator web service",
  2810. "actions": [
  2811. {
  2812. "key": "reset",
  2813. "description": "Reset data",
  2814. "since": "Orchestrator 3.4",
  2815. "internal": true,
  2816. "post": true,
  2817. "hasResponseExample": false,
  2818. "changelog": []
  2819. }
  2820. ]
  2821. },
  2822. {
  2823. "path": "api/organizations",
  2824. "since": "6.2",
  2825. "description": "Manage organizations.",
  2826. "actions": [
  2827. {
  2828. "key": "add_member",
  2829. "description": "Add a user as a member of an organization.<br>Requires 'Administer System' permission on the specified organization.",
  2830. "since": "6.4",
  2831. "internal": true,
  2832. "post": true,
  2833. "hasResponseExample": true,
  2834. "changelog": [],
  2835. "params": [
  2836. {
  2837. "key": "login",
  2838. "description": "User login",
  2839. "required": true,
  2840. "internal": false,
  2841. "exampleValue": "ray.bradbury"
  2842. },
  2843. {
  2844. "key": "organization",
  2845. "description": "Organization key",
  2846. "required": true,
  2847. "internal": false,
  2848. "exampleValue": "my-org"
  2849. }
  2850. ]
  2851. },
  2852. {
  2853. "key": "create",
  2854. "description": "Create an organization.<br />Requires 'Administer System' permission unless any logged in user is allowed to create an organization (see appropriate setting). Organization support must be enabled.",
  2855. "since": "6.2",
  2856. "internal": true,
  2857. "post": true,
  2858. "hasResponseExample": true,
  2859. "changelog": [],
  2860. "params": [
  2861. {
  2862. "key": "avatar",
  2863. "description": "URL of the organization avatar.<br/> It must be less than 256 chars long.",
  2864. "required": false,
  2865. "internal": false,
  2866. "exampleValue": "https://www.foo.com/foo.png",
  2867. "maximumLength": 256
  2868. },
  2869. {
  2870. "key": "description",
  2871. "description": "Description of the organization.<br/> It must be less than 256 chars long.",
  2872. "required": false,
  2873. "internal": false,
  2874. "exampleValue": "The Foo company produces quality software for Bar.",
  2875. "maximumLength": 256
  2876. },
  2877. {
  2878. "key": "key",
  2879. "description": "Key of the organization. <br />The key is unique to the whole SonarQube. <br/>When not specified, the key is computed from the name. <br />Otherwise, it must be between 2 and 32 chars long. All chars must be lower-case letters (a to z), digits or dash (but dash can neither be trailing nor heading)",
  2880. "required": false,
  2881. "internal": false,
  2882. "exampleValue": "foo-company",
  2883. "maximumLength": 32
  2884. },
  2885. {
  2886. "key": "name",
  2887. "description": "Name of the organization. <br />It must be between 2 and 64 chars longs.",
  2888. "required": true,
  2889. "internal": false,
  2890. "exampleValue": "Foo Company",
  2891. "maximumLength": 64
  2892. },
  2893. {
  2894. "key": "url",
  2895. "description": "URL of the organization.<br/> It must be less than 256 chars long.",
  2896. "required": false,
  2897. "internal": false,
  2898. "exampleValue": "https://www.foo.com",
  2899. "maximumLength": 256
  2900. }
  2901. ]
  2902. },
  2903. {
  2904. "key": "delete",
  2905. "description": "Delete an organization.<br/>Require 'Administer System' permission on the specified organization. Organization support must be enabled.",
  2906. "since": "6.2",
  2907. "internal": true,
  2908. "post": true,
  2909. "hasResponseExample": false,
  2910. "changelog": [],
  2911. "params": [
  2912. {
  2913. "key": "organization",
  2914. "description": "Organization key",
  2915. "required": true,
  2916. "internal": false,
  2917. "exampleValue": "foo-company",
  2918. "deprecatedKey": "key",
  2919. "deprecatedKeySince": "6.4"
  2920. }
  2921. ]
  2922. },
  2923. {
  2924. "key": "enable_support",
  2925. "description": "Enable support of organizations.<br />'Administer System' permission is required. The logged-in user will be flagged as root and will be able to manage organizations and other root users.",
  2926. "since": "6.3",
  2927. "internal": true,
  2928. "post": true,
  2929. "hasResponseExample": false,
  2930. "changelog": [
  2931. {
  2932. "description": "Create default 'Members' group",
  2933. "version": "6.4"
  2934. }
  2935. ]
  2936. },
  2937. {
  2938. "key": "remove_member",
  2939. "description": "Remove a member from an organization.<br>Requires 'Administer System' permission on the specified organization.",
  2940. "since": "6.4",
  2941. "internal": true,
  2942. "post": true,
  2943. "hasResponseExample": false,
  2944. "changelog": [],
  2945. "params": [
  2946. {
  2947. "key": "login",
  2948. "description": "User login",
  2949. "required": true,
  2950. "internal": false,
  2951. "exampleValue": "ray.bradbury"
  2952. },
  2953. {
  2954. "key": "organization",
  2955. "description": "Organization key",
  2956. "required": true,
  2957. "internal": false,
  2958. "exampleValue": "my-org"
  2959. }
  2960. ]
  2961. },
  2962. {
  2963. "key": "search",
  2964. "description": "Search for organizations",
  2965. "since": "6.2",
  2966. "internal": true,
  2967. "post": false,
  2968. "hasResponseExample": true,
  2969. "changelog": [
  2970. {
  2971. "description": "Paging fields have been added to the response",
  2972. "version": "6.4"
  2973. }
  2974. ],
  2975. "params": [
  2976. {
  2977. "key": "organizations",
  2978. "description": "Comma-separated list of organization keys",
  2979. "since": "6.3",
  2980. "required": false,
  2981. "internal": false,
  2982. "exampleValue": "my-org-1,foocorp"
  2983. },
  2984. {
  2985. "key": "p",
  2986. "description": "1-based page number",
  2987. "required": false,
  2988. "internal": false,
  2989. "defaultValue": "1",
  2990. "exampleValue": "42",
  2991. "deprecatedKey": "pageIndex",
  2992. "deprecatedKeySince": "5.2"
  2993. },
  2994. {
  2995. "key": "ps",
  2996. "description": "Page size. Must be greater than 0.",
  2997. "required": false,
  2998. "internal": false,
  2999. "defaultValue": "25",
  3000. "exampleValue": "20",
  3001. "deprecatedKey": "pageSize",
  3002. "deprecatedKeySince": "5.2"
  3003. }
  3004. ]
  3005. },
  3006. {
  3007. "key": "search_members",
  3008. "description": "Search members of an organization",
  3009. "since": "6.4",
  3010. "internal": true,
  3011. "post": false,
  3012. "hasResponseExample": true,
  3013. "changelog": [],
  3014. "params": [
  3015. {
  3016. "key": "organization",
  3017. "description": "Organization key",
  3018. "required": false,
  3019. "internal": true
  3020. },
  3021. {
  3022. "key": "p",
  3023. "description": "1-based page number",
  3024. "required": false,
  3025. "internal": false,
  3026. "defaultValue": "1",
  3027. "exampleValue": "42",
  3028. "deprecatedKey": "pageIndex",
  3029. "deprecatedKeySince": "5.2"
  3030. },
  3031. {
  3032. "key": "ps",
  3033. "description": "Page size. Must be greater than 0 and less than 500",
  3034. "required": false,
  3035. "internal": false,
  3036. "defaultValue": "50",
  3037. "exampleValue": "20",
  3038. "deprecatedKey": "pageSize",
  3039. "deprecatedKeySince": "5.2",
  3040. "maximumValue": 500
  3041. },
  3042. {
  3043. "key": "q",
  3044. "description": "Limit search to names or logins that contain the supplied string.",
  3045. "required": false,
  3046. "internal": false,
  3047. "exampleValue": "orwe"
  3048. },
  3049. {
  3050. "key": "selected",
  3051. "description": "Depending on the value, show only selected items (selected=selected) or deselected items (selected=deselected).",
  3052. "required": false,
  3053. "internal": true,
  3054. "defaultValue": "selected",
  3055. "possibleValues": [
  3056. "selected",
  3057. "deselected"
  3058. ]
  3059. }
  3060. ]
  3061. },
  3062. {
  3063. "key": "search_my_organizations",
  3064. "description": "List keys of the organizations for which the currently authenticated user has the System Administer permission for.",
  3065. "since": "6.3",
  3066. "internal": true,
  3067. "post": false,
  3068. "hasResponseExample": true,
  3069. "changelog": []
  3070. },
  3071. {
  3072. "key": "update",
  3073. "description": "Update an organization.<br/>Require 'Administer System' permission. Organization support must be enabled.",
  3074. "since": "6.2",
  3075. "internal": true,
  3076. "post": true,
  3077. "hasResponseExample": false,
  3078. "changelog": [],
  3079. "params": [
  3080. {
  3081. "key": "avatar",
  3082. "description": "URL of the organization avatar.<br/> It must be less than 256 chars long.",
  3083. "required": false,
  3084. "internal": false,
  3085. "exampleValue": "https://www.foo.com/foo.png",
  3086. "maximumLength": 256
  3087. },
  3088. {
  3089. "key": "description",
  3090. "description": "Description of the organization.<br/> It must be less than 256 chars long.",
  3091. "required": false,
  3092. "internal": false,
  3093. "exampleValue": "The Foo company produces quality software for Bar.",
  3094. "maximumLength": 256
  3095. },
  3096. {
  3097. "key": "key",
  3098. "description": "Organization key",
  3099. "required": true,
  3100. "internal": false,
  3101. "exampleValue": "foo-company"
  3102. },
  3103. {
  3104. "key": "name",
  3105. "description": "Name of the organization. <br />It must be between 2 and 64 chars longs.",
  3106. "required": false,
  3107. "internal": false,
  3108. "exampleValue": "Foo Company",
  3109. "maximumLength": 64
  3110. },
  3111. {
  3112. "key": "url",
  3113. "description": "URL of the organization.<br/> It must be less than 256 chars long.",
  3114. "required": false,
  3115. "internal": false,
  3116. "exampleValue": "https://www.foo.com",
  3117. "maximumLength": 256
  3118. }
  3119. ]
  3120. },
  3121. {
  3122. "key": "update_project_visibility",
  3123. "description": "Update the default visibility for new projects of the specified organization.",
  3124. "since": "6.4",
  3125. "internal": true,
  3126. "post": true,
  3127. "hasResponseExample": false,
  3128. "changelog": [],
  3129. "params": [
  3130. {
  3131. "key": "organization",
  3132. "description": "Organization key",
  3133. "required": true,
  3134. "internal": false,
  3135. "exampleValue": "foo-company"
  3136. },
  3137. {
  3138. "key": "projectVisibility",
  3139. "description": "Default visibility for projects",
  3140. "required": true,
  3141. "internal": false,
  3142. "possibleValues": [
  3143. "private",
  3144. "public"
  3145. ]
  3146. }
  3147. ]
  3148. }
  3149. ]
  3150. },
  3151. {
  3152. "path": "api/permissions",
  3153. "since": "3.7",
  3154. "description": "Manage permission templates, and the granting and revoking of permissions at the global and project levels.",
  3155. "actions": [
  3156. {
  3157. "key": "add_group",
  3158. "description": "Add permission to a group.<br /> This service defaults to global permissions, but can be limited to project permissions by providing project id or project key.<br /> The group name or group id must be provided. <br />Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  3159. "since": "5.2",
  3160. "internal": false,
  3161. "post": true,
  3162. "hasResponseExample": false,
  3163. "changelog": [],
  3164. "params": [
  3165. {
  3166. "key": "groupId",
  3167. "description": "Group id",
  3168. "required": false,
  3169. "internal": false,
  3170. "exampleValue": "42"
  3171. },
  3172. {
  3173. "key": "groupName",
  3174. "description": "Group name or 'anyone' (case insensitive)",
  3175. "required": false,
  3176. "internal": false,
  3177. "exampleValue": "sonar-administrators"
  3178. },
  3179. {
  3180. "key": "organization",
  3181. "description": "Key of organization, used when group name is set",
  3182. "since": "6.2",
  3183. "required": false,
  3184. "internal": true,
  3185. "exampleValue": "my-org"
  3186. },
  3187. {
  3188. "key": "permission",
  3189. "description": "Permission<ul><li>Possible values for global permissions: admin, profileadmin, gateadmin, scan, provisioning</li><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3190. "required": true,
  3191. "internal": false
  3192. },
  3193. {
  3194. "key": "projectId",
  3195. "description": "Project id",
  3196. "required": false,
  3197. "internal": false,
  3198. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  3199. },
  3200. {
  3201. "key": "projectKey",
  3202. "description": "Project key",
  3203. "required": false,
  3204. "internal": false,
  3205. "exampleValue": "my_project"
  3206. }
  3207. ]
  3208. },
  3209. {
  3210. "key": "add_group_to_template",
  3211. "description": "Add a group to a permission template.<br /> The group id or group name must be provided. <br />Requires the following permission: 'Administer System'.",
  3212. "since": "5.2",
  3213. "internal": false,
  3214. "post": true,
  3215. "hasResponseExample": false,
  3216. "changelog": [],
  3217. "params": [
  3218. {
  3219. "key": "groupId",
  3220. "description": "Group id",
  3221. "required": false,
  3222. "internal": false,
  3223. "exampleValue": "42"
  3224. },
  3225. {
  3226. "key": "groupName",
  3227. "description": "Group name or 'anyone' (case insensitive)",
  3228. "required": false,
  3229. "internal": false,
  3230. "exampleValue": "sonar-administrators"
  3231. },
  3232. {
  3233. "key": "organization",
  3234. "description": "Key of organization, used when group name is set",
  3235. "required": false,
  3236. "internal": true,
  3237. "exampleValue": "my-org"
  3238. },
  3239. {
  3240. "key": "permission",
  3241. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3242. "required": true,
  3243. "internal": false,
  3244. "possibleValues": [
  3245. "admin",
  3246. "codeviewer",
  3247. "issueadmin",
  3248. "scan",
  3249. "user"
  3250. ]
  3251. },
  3252. {
  3253. "key": "templateId",
  3254. "description": "Template id",
  3255. "required": false,
  3256. "internal": false,
  3257. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3258. },
  3259. {
  3260. "key": "templateName",
  3261. "description": "Template name",
  3262. "required": false,
  3263. "internal": false,
  3264. "exampleValue": "Default Permission Template for Projects"
  3265. }
  3266. ]
  3267. },
  3268. {
  3269. "key": "add_project_creator_to_template",
  3270. "description": "Add a project creator to a permission template.<br>Requires the following permission: 'Administer System'.",
  3271. "since": "6.0",
  3272. "internal": false,
  3273. "post": true,
  3274. "hasResponseExample": false,
  3275. "changelog": [],
  3276. "params": [
  3277. {
  3278. "key": "organization",
  3279. "description": "Key of organization, used when group name is set",
  3280. "required": false,
  3281. "internal": true,
  3282. "exampleValue": "my-org"
  3283. },
  3284. {
  3285. "key": "permission",
  3286. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3287. "required": true,
  3288. "internal": false,
  3289. "possibleValues": [
  3290. "admin",
  3291. "codeviewer",
  3292. "issueadmin",
  3293. "scan",
  3294. "user"
  3295. ]
  3296. },
  3297. {
  3298. "key": "templateId",
  3299. "description": "Template id",
  3300. "required": false,
  3301. "internal": false,
  3302. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3303. },
  3304. {
  3305. "key": "templateName",
  3306. "description": "Template name",
  3307. "required": false,
  3308. "internal": false,
  3309. "exampleValue": "Default Permission Template for Projects"
  3310. }
  3311. ]
  3312. },
  3313. {
  3314. "key": "add_user",
  3315. "description": "Add permission to a user.<br /> This service defaults to global permissions, but can be limited to project permissions by providing project id or project key.<br />Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  3316. "since": "5.2",
  3317. "internal": false,
  3318. "post": true,
  3319. "hasResponseExample": false,
  3320. "changelog": [],
  3321. "params": [
  3322. {
  3323. "key": "login",
  3324. "description": "User login",
  3325. "required": true,
  3326. "internal": false,
  3327. "exampleValue": "g.hopper"
  3328. },
  3329. {
  3330. "key": "organization",
  3331. "description": "Key of organization, cannot be used at the same time with projectId and projectKey",
  3332. "since": "6.2",
  3333. "required": false,
  3334. "internal": true,
  3335. "exampleValue": "my-org"
  3336. },
  3337. {
  3338. "key": "permission",
  3339. "description": "Permission<ul><li>Possible values for global permissions: admin, profileadmin, gateadmin, scan, provisioning</li><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3340. "required": true,
  3341. "internal": false
  3342. },
  3343. {
  3344. "key": "projectId",
  3345. "description": "Project id",
  3346. "required": false,
  3347. "internal": false,
  3348. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  3349. },
  3350. {
  3351. "key": "projectKey",
  3352. "description": "Project key",
  3353. "required": false,
  3354. "internal": false,
  3355. "exampleValue": "my_project"
  3356. }
  3357. ]
  3358. },
  3359. {
  3360. "key": "add_user_to_template",
  3361. "description": "Add a user to a permission template.<br /> Requires the following permission: 'Administer System'.",
  3362. "since": "5.2",
  3363. "internal": false,
  3364. "post": true,
  3365. "hasResponseExample": false,
  3366. "changelog": [],
  3367. "params": [
  3368. {
  3369. "key": "login",
  3370. "description": "User login",
  3371. "required": true,
  3372. "internal": false,
  3373. "exampleValue": "g.hopper"
  3374. },
  3375. {
  3376. "key": "organization",
  3377. "description": "Key of organization, used when group name is set",
  3378. "required": false,
  3379. "internal": true,
  3380. "exampleValue": "my-org"
  3381. },
  3382. {
  3383. "key": "permission",
  3384. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3385. "required": true,
  3386. "internal": false,
  3387. "possibleValues": [
  3388. "admin",
  3389. "codeviewer",
  3390. "issueadmin",
  3391. "scan",
  3392. "user"
  3393. ]
  3394. },
  3395. {
  3396. "key": "templateId",
  3397. "description": "Template id",
  3398. "required": false,
  3399. "internal": false,
  3400. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3401. },
  3402. {
  3403. "key": "templateName",
  3404. "description": "Template name",
  3405. "required": false,
  3406. "internal": false,
  3407. "exampleValue": "Default Permission Template for Projects"
  3408. }
  3409. ]
  3410. },
  3411. {
  3412. "key": "apply_template",
  3413. "description": "Apply a permission template to one project.<br>The project id or project key must be provided.<br>The template id or name must be provided.<br>Requires the following permission: 'Administer System'.",
  3414. "since": "5.2",
  3415. "internal": false,
  3416. "post": true,
  3417. "hasResponseExample": false,
  3418. "changelog": [],
  3419. "params": [
  3420. {
  3421. "key": "organization",
  3422. "description": "Key of organization, used when group name is set",
  3423. "required": false,
  3424. "internal": true,
  3425. "exampleValue": "my-org"
  3426. },
  3427. {
  3428. "key": "projectId",
  3429. "description": "Project id",
  3430. "required": false,
  3431. "internal": false,
  3432. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  3433. },
  3434. {
  3435. "key": "projectKey",
  3436. "description": "Project key",
  3437. "required": false,
  3438. "internal": false,
  3439. "exampleValue": "my_project"
  3440. },
  3441. {
  3442. "key": "templateId",
  3443. "description": "Template id",
  3444. "required": false,
  3445. "internal": false,
  3446. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3447. },
  3448. {
  3449. "key": "templateName",
  3450. "description": "Template name",
  3451. "required": false,
  3452. "internal": false,
  3453. "exampleValue": "Default Permission Template for Projects"
  3454. }
  3455. ]
  3456. },
  3457. {
  3458. "key": "bulk_apply_template",
  3459. "description": "Apply a permission template to several projects.<br />The template id or name must be provided.<br />Requires the following permission: 'Administer System'.",
  3460. "since": "5.5",
  3461. "internal": false,
  3462. "post": true,
  3463. "hasResponseExample": false,
  3464. "changelog": [],
  3465. "params": [
  3466. {
  3467. "key": "analyzedBefore",
  3468. "description": "Filter the projects for which last analysis is older than the given date (exclusive).<br> Either a date (server timezone) or datetime can be provided.",
  3469. "since": "6.6",
  3470. "required": false,
  3471. "internal": false,
  3472. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  3473. },
  3474. {
  3475. "key": "onProvisionedOnly",
  3476. "description": "Filter the projects that are provisioned",
  3477. "since": "6.6",
  3478. "required": false,
  3479. "internal": false,
  3480. "defaultValue": "false",
  3481. "possibleValues": [
  3482. "true",
  3483. "false",
  3484. "yes",
  3485. "no"
  3486. ]
  3487. },
  3488. {
  3489. "key": "organization",
  3490. "description": "Key of organization, used when group name is set",
  3491. "required": false,
  3492. "internal": true,
  3493. "exampleValue": "my-org"
  3494. },
  3495. {
  3496. "key": "projects",
  3497. "description": "Comma-separated list of project keys",
  3498. "since": "6.6",
  3499. "required": false,
  3500. "internal": false,
  3501. "exampleValue": "my_project,another_project"
  3502. },
  3503. {
  3504. "key": "q",
  3505. "description": "Limit search to: <ul><li>project names that contain the supplied string</li><li>project keys that are exactly the same as the supplied string</li></ul>",
  3506. "required": false,
  3507. "internal": false,
  3508. "exampleValue": "apac"
  3509. },
  3510. {
  3511. "key": "qualifiers",
  3512. "description": "Comma-separated list of component qualifiers. Filter the results with the specified qualifiers. Possible values are:<ul><li>TRK - Projects</li></ul>",
  3513. "required": false,
  3514. "internal": false,
  3515. "defaultValue": "TRK",
  3516. "deprecatedKey": "qualifier",
  3517. "deprecatedKeySince": "6.6",
  3518. "possibleValues": [
  3519. "TRK"
  3520. ]
  3521. },
  3522. {
  3523. "key": "templateId",
  3524. "description": "Template id",
  3525. "required": false,
  3526. "internal": false,
  3527. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3528. },
  3529. {
  3530. "key": "templateName",
  3531. "description": "Template name",
  3532. "required": false,
  3533. "internal": false,
  3534. "exampleValue": "Default Permission Template for Projects"
  3535. },
  3536. {
  3537. "key": "visibility",
  3538. "description": "Filter the projects that should be visible to everyone (public), or only specific user/groups (private).<br/>If no visibility is specified, the default project visibility of the organization will be used.",
  3539. "since": "6.6",
  3540. "required": false,
  3541. "internal": true,
  3542. "possibleValues": [
  3543. "private",
  3544. "public"
  3545. ]
  3546. }
  3547. ]
  3548. },
  3549. {
  3550. "key": "create_template",
  3551. "description": "Create a permission template.<br />Requires the following permission: 'Administer System'.",
  3552. "since": "5.2",
  3553. "internal": false,
  3554. "post": true,
  3555. "hasResponseExample": true,
  3556. "changelog": [],
  3557. "params": [
  3558. {
  3559. "key": "description",
  3560. "description": "Description",
  3561. "required": false,
  3562. "internal": false,
  3563. "exampleValue": "Permissions for all projects related to the financial service"
  3564. },
  3565. {
  3566. "key": "name",
  3567. "description": "Name",
  3568. "required": true,
  3569. "internal": false,
  3570. "exampleValue": "Financial Service Permissions"
  3571. },
  3572. {
  3573. "key": "organization",
  3574. "description": "Key of organization, used when group name is set",
  3575. "since": "6.2",
  3576. "required": false,
  3577. "internal": true,
  3578. "exampleValue": "my-org"
  3579. },
  3580. {
  3581. "key": "projectKeyPattern",
  3582. "description": "Project key pattern. Must be a valid Java regular expression",
  3583. "required": false,
  3584. "internal": false,
  3585. "exampleValue": ".*\\.finance\\..*"
  3586. }
  3587. ]
  3588. },
  3589. {
  3590. "key": "delete_template",
  3591. "description": "Delete a permission template.<br />Requires the following permission: 'Administer System'.",
  3592. "since": "5.2",
  3593. "internal": false,
  3594. "post": true,
  3595. "hasResponseExample": false,
  3596. "changelog": [],
  3597. "params": [
  3598. {
  3599. "key": "organization",
  3600. "description": "Key of organization, used when group name is set",
  3601. "required": false,
  3602. "internal": true,
  3603. "exampleValue": "my-org"
  3604. },
  3605. {
  3606. "key": "templateId",
  3607. "description": "Template id",
  3608. "required": false,
  3609. "internal": false,
  3610. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3611. },
  3612. {
  3613. "key": "templateName",
  3614. "description": "Template name",
  3615. "required": false,
  3616. "internal": false,
  3617. "exampleValue": "Default Permission Template for Projects"
  3618. }
  3619. ]
  3620. },
  3621. {
  3622. "key": "groups",
  3623. "description": "Limit search to group names that contain the supplied string. Must have at least 3 characters.<br/>When this parameter is not set, only groups having at least one permission are returned.",
  3624. "since": "5.2",
  3625. "internal": true,
  3626. "post": false,
  3627. "hasResponseExample": true,
  3628. "changelog": [],
  3629. "params": [
  3630. {
  3631. "key": "organization",
  3632. "description": "Key of organization, used when group name is set",
  3633. "since": "6.2",
  3634. "required": false,
  3635. "internal": true,
  3636. "exampleValue": "my-org"
  3637. },
  3638. {
  3639. "key": "p",
  3640. "description": "1-based page number",
  3641. "required": false,
  3642. "internal": false,
  3643. "defaultValue": "1",
  3644. "exampleValue": "42",
  3645. "deprecatedKey": "pageIndex",
  3646. "deprecatedKeySince": "5.2"
  3647. },
  3648. {
  3649. "key": "permission",
  3650. "description": "Permission<ul><li>Possible values for global permissions: admin, profileadmin, gateadmin, scan, provisioning</li><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3651. "required": false,
  3652. "internal": false
  3653. },
  3654. {
  3655. "key": "projectId",
  3656. "description": "Project id",
  3657. "required": false,
  3658. "internal": false,
  3659. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  3660. },
  3661. {
  3662. "key": "projectKey",
  3663. "description": "Project key",
  3664. "required": false,
  3665. "internal": false,
  3666. "exampleValue": "my_project"
  3667. },
  3668. {
  3669. "key": "ps",
  3670. "description": "Page size. Must be greater than 0 and less than 100",
  3671. "required": false,
  3672. "internal": false,
  3673. "defaultValue": "20",
  3674. "exampleValue": "20",
  3675. "deprecatedKey": "pageSize",
  3676. "deprecatedKeySince": "5.2",
  3677. "maximumValue": 100
  3678. },
  3679. {
  3680. "key": "q",
  3681. "description": "Limit search to names that contain the supplied string.",
  3682. "required": false,
  3683. "internal": false,
  3684. "exampleValue": "sonar"
  3685. }
  3686. ]
  3687. },
  3688. {
  3689. "key": "remove_group",
  3690. "description": "Remove a permission from a group.<br /> This service defaults to global permissions, but can be limited to project permissions by providing project id or project key.<br /> The group id or group name must be provided, not both.<br />Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  3691. "since": "5.2",
  3692. "internal": false,
  3693. "post": true,
  3694. "hasResponseExample": false,
  3695. "changelog": [],
  3696. "params": [
  3697. {
  3698. "key": "groupId",
  3699. "description": "Group id",
  3700. "required": false,
  3701. "internal": false,
  3702. "exampleValue": "42"
  3703. },
  3704. {
  3705. "key": "groupName",
  3706. "description": "Group name or 'anyone' (case insensitive)",
  3707. "required": false,
  3708. "internal": false,
  3709. "exampleValue": "sonar-administrators"
  3710. },
  3711. {
  3712. "key": "organization",
  3713. "description": "Key of organization, used when group name is set",
  3714. "since": "6.2",
  3715. "required": false,
  3716. "internal": true,
  3717. "exampleValue": "my-org"
  3718. },
  3719. {
  3720. "key": "permission",
  3721. "description": "Permission<ul><li>Possible values for global permissions: admin, profileadmin, gateadmin, scan, provisioning</li><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3722. "required": true,
  3723. "internal": false
  3724. },
  3725. {
  3726. "key": "projectId",
  3727. "description": "Project id",
  3728. "required": false,
  3729. "internal": false,
  3730. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  3731. },
  3732. {
  3733. "key": "projectKey",
  3734. "description": "Project key",
  3735. "required": false,
  3736. "internal": false,
  3737. "exampleValue": "my_project"
  3738. }
  3739. ]
  3740. },
  3741. {
  3742. "key": "remove_group_from_template",
  3743. "description": "Remove a group from a permission template.<br /> The group id or group name must be provided. <br />Requires the following permission: 'Administer System'.",
  3744. "since": "5.2",
  3745. "internal": false,
  3746. "post": true,
  3747. "hasResponseExample": false,
  3748. "changelog": [],
  3749. "params": [
  3750. {
  3751. "key": "groupId",
  3752. "description": "Group id",
  3753. "required": false,
  3754. "internal": false,
  3755. "exampleValue": "42"
  3756. },
  3757. {
  3758. "key": "groupName",
  3759. "description": "Group name or 'anyone' (case insensitive)",
  3760. "required": false,
  3761. "internal": false,
  3762. "exampleValue": "sonar-administrators"
  3763. },
  3764. {
  3765. "key": "organization",
  3766. "description": "Key of organization, used when group name is set",
  3767. "required": false,
  3768. "internal": true,
  3769. "exampleValue": "my-org"
  3770. },
  3771. {
  3772. "key": "permission",
  3773. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3774. "required": true,
  3775. "internal": false,
  3776. "possibleValues": [
  3777. "admin",
  3778. "codeviewer",
  3779. "issueadmin",
  3780. "scan",
  3781. "user"
  3782. ]
  3783. },
  3784. {
  3785. "key": "templateId",
  3786. "description": "Template id",
  3787. "required": false,
  3788. "internal": false,
  3789. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3790. },
  3791. {
  3792. "key": "templateName",
  3793. "description": "Template name",
  3794. "required": false,
  3795. "internal": false,
  3796. "exampleValue": "Default Permission Template for Projects"
  3797. }
  3798. ]
  3799. },
  3800. {
  3801. "key": "remove_project_creator_from_template",
  3802. "description": "Remove a project creator from a permission template.<br>Requires the following permission: 'Administer System'.",
  3803. "since": "6.0",
  3804. "internal": false,
  3805. "post": true,
  3806. "hasResponseExample": false,
  3807. "changelog": [],
  3808. "params": [
  3809. {
  3810. "key": "organization",
  3811. "description": "Key of organization, used when group name is set",
  3812. "required": false,
  3813. "internal": true,
  3814. "exampleValue": "my-org"
  3815. },
  3816. {
  3817. "key": "permission",
  3818. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3819. "required": true,
  3820. "internal": false,
  3821. "possibleValues": [
  3822. "admin",
  3823. "codeviewer",
  3824. "issueadmin",
  3825. "scan",
  3826. "user"
  3827. ]
  3828. },
  3829. {
  3830. "key": "templateId",
  3831. "description": "Template id",
  3832. "required": false,
  3833. "internal": false,
  3834. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3835. },
  3836. {
  3837. "key": "templateName",
  3838. "description": "Template name",
  3839. "required": false,
  3840. "internal": false,
  3841. "exampleValue": "Default Permission Template for Projects"
  3842. }
  3843. ]
  3844. },
  3845. {
  3846. "key": "remove_user",
  3847. "description": "Remove permission from a user.<br /> This service defaults to global permissions, but can be limited to project permissions by providing project id or project key.<br /> Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  3848. "since": "5.2",
  3849. "internal": false,
  3850. "post": true,
  3851. "hasResponseExample": false,
  3852. "changelog": [],
  3853. "params": [
  3854. {
  3855. "key": "login",
  3856. "description": "User login",
  3857. "required": true,
  3858. "internal": false,
  3859. "exampleValue": "g.hopper"
  3860. },
  3861. {
  3862. "key": "organization",
  3863. "description": "Key of organization, used when group name is set",
  3864. "since": "6.2",
  3865. "required": false,
  3866. "internal": true,
  3867. "exampleValue": "my-org"
  3868. },
  3869. {
  3870. "key": "permission",
  3871. "description": "Permission<ul><li>Possible values for global permissions: admin, profileadmin, gateadmin, scan, provisioning</li><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3872. "required": true,
  3873. "internal": false
  3874. },
  3875. {
  3876. "key": "projectId",
  3877. "description": "Project id",
  3878. "required": false,
  3879. "internal": false,
  3880. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  3881. },
  3882. {
  3883. "key": "projectKey",
  3884. "description": "Project key",
  3885. "required": false,
  3886. "internal": false,
  3887. "exampleValue": "my_project"
  3888. }
  3889. ]
  3890. },
  3891. {
  3892. "key": "remove_user_from_template",
  3893. "description": "Remove a user from a permission template.<br /> Requires the following permission: 'Administer System'.",
  3894. "since": "5.2",
  3895. "internal": false,
  3896. "post": true,
  3897. "hasResponseExample": false,
  3898. "changelog": [],
  3899. "params": [
  3900. {
  3901. "key": "login",
  3902. "description": "User login",
  3903. "required": true,
  3904. "internal": false,
  3905. "exampleValue": "g.hopper"
  3906. },
  3907. {
  3908. "key": "organization",
  3909. "description": "Key of organization, used when group name is set",
  3910. "required": false,
  3911. "internal": true,
  3912. "exampleValue": "my-org"
  3913. },
  3914. {
  3915. "key": "permission",
  3916. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  3917. "required": true,
  3918. "internal": false,
  3919. "possibleValues": [
  3920. "admin",
  3921. "codeviewer",
  3922. "issueadmin",
  3923. "scan",
  3924. "user"
  3925. ]
  3926. },
  3927. {
  3928. "key": "templateId",
  3929. "description": "Template id",
  3930. "required": false,
  3931. "internal": false,
  3932. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  3933. },
  3934. {
  3935. "key": "templateName",
  3936. "description": "Template name",
  3937. "required": false,
  3938. "internal": false,
  3939. "exampleValue": "Default Permission Template for Projects"
  3940. }
  3941. ]
  3942. },
  3943. {
  3944. "key": "search_templates",
  3945. "description": "List permission templates.<br />Requires the following permission: 'Administer System'.",
  3946. "since": "5.2",
  3947. "internal": false,
  3948. "post": false,
  3949. "hasResponseExample": true,
  3950. "changelog": [],
  3951. "params": [
  3952. {
  3953. "key": "organization",
  3954. "description": "Key of organization, used when group name is set",
  3955. "since": "6.2",
  3956. "required": false,
  3957. "internal": true,
  3958. "exampleValue": "my-org"
  3959. },
  3960. {
  3961. "key": "q",
  3962. "description": "Limit search to permission template names that contain the supplied string.",
  3963. "required": false,
  3964. "internal": false,
  3965. "exampleValue": "defau"
  3966. }
  3967. ]
  3968. },
  3969. {
  3970. "key": "set_default_template",
  3971. "description": "Set a permission template as default.<br />Requires the following permission: 'Administer System'.",
  3972. "since": "5.2",
  3973. "internal": false,
  3974. "post": true,
  3975. "hasResponseExample": false,
  3976. "changelog": [],
  3977. "params": [
  3978. {
  3979. "key": "organization",
  3980. "description": "Key of organization, used when group name is set",
  3981. "required": false,
  3982. "internal": true,
  3983. "exampleValue": "my-org"
  3984. },
  3985. {
  3986. "key": "qualifier",
  3987. "description": "Project qualifier. Filter the results with the specified qualifier. Possible values are:<ul><li>TRK - Projects</li></ul>",
  3988. "required": false,
  3989. "internal": false,
  3990. "defaultValue": "TRK",
  3991. "possibleValues": [
  3992. "TRK"
  3993. ]
  3994. },
  3995. {
  3996. "key": "templateId",
  3997. "description": "Template id",
  3998. "required": false,
  3999. "internal": false,
  4000. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  4001. },
  4002. {
  4003. "key": "templateName",
  4004. "description": "Template name",
  4005. "required": false,
  4006. "internal": false,
  4007. "exampleValue": "Default Permission Template for Projects"
  4008. }
  4009. ]
  4010. },
  4011. {
  4012. "key": "template_groups",
  4013. "description": "Lists the groups with their permission as individual groups rather than through user affiliation on the chosen template.<br />This service defaults to all groups, but can be limited to groups with a specific permission by providing the desired permission.<br>Requires the following permission: 'Administer System'.",
  4014. "since": "5.2",
  4015. "internal": true,
  4016. "post": false,
  4017. "hasResponseExample": true,
  4018. "changelog": [],
  4019. "params": [
  4020. {
  4021. "key": "organization",
  4022. "description": "Key of organization, used when group name is set",
  4023. "required": false,
  4024. "internal": true,
  4025. "exampleValue": "my-org"
  4026. },
  4027. {
  4028. "key": "p",
  4029. "description": "1-based page number",
  4030. "required": false,
  4031. "internal": false,
  4032. "defaultValue": "1",
  4033. "exampleValue": "42",
  4034. "deprecatedKey": "pageIndex",
  4035. "deprecatedKeySince": "5.2"
  4036. },
  4037. {
  4038. "key": "permission",
  4039. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  4040. "required": true,
  4041. "internal": false,
  4042. "possibleValues": [
  4043. "admin",
  4044. "codeviewer",
  4045. "issueadmin",
  4046. "scan",
  4047. "user"
  4048. ]
  4049. },
  4050. {
  4051. "key": "ps",
  4052. "description": "Page size. Must be greater than 0 and less than 100",
  4053. "required": false,
  4054. "internal": false,
  4055. "defaultValue": "20",
  4056. "exampleValue": "20",
  4057. "deprecatedKey": "pageSize",
  4058. "deprecatedKeySince": "5.2",
  4059. "maximumValue": 100
  4060. },
  4061. {
  4062. "key": "q",
  4063. "description": "Limit search to group names that contain the supplied string. Must have at least 3 characters.<br/>When this parameter is not set, only group having at least one permission are returned.",
  4064. "required": false,
  4065. "internal": false,
  4066. "exampleValue": "eri"
  4067. },
  4068. {
  4069. "key": "templateId",
  4070. "description": "Template id",
  4071. "required": false,
  4072. "internal": false,
  4073. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  4074. },
  4075. {
  4076. "key": "templateName",
  4077. "description": "Template name",
  4078. "required": false,
  4079. "internal": false,
  4080. "exampleValue": "Default Permission Template for Projects"
  4081. }
  4082. ]
  4083. },
  4084. {
  4085. "key": "template_users",
  4086. "description": "Lists the users with their permission as individual users rather than through group affiliation on the chosen template. <br />This service defaults to all users, but can be limited to users with a specific permission by providing the desired permission.<br>Requires the following permission: 'Administer System'.",
  4087. "since": "5.2",
  4088. "internal": true,
  4089. "post": false,
  4090. "hasResponseExample": true,
  4091. "changelog": [],
  4092. "params": [
  4093. {
  4094. "key": "organization",
  4095. "description": "Key of organization, used when group name is set",
  4096. "required": false,
  4097. "internal": true,
  4098. "exampleValue": "my-org"
  4099. },
  4100. {
  4101. "key": "p",
  4102. "description": "1-based page number",
  4103. "required": false,
  4104. "internal": false,
  4105. "defaultValue": "1",
  4106. "exampleValue": "42",
  4107. "deprecatedKey": "pageIndex",
  4108. "deprecatedKeySince": "5.2"
  4109. },
  4110. {
  4111. "key": "permission",
  4112. "description": "Permission<ul><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  4113. "required": false,
  4114. "internal": false,
  4115. "possibleValues": [
  4116. "admin",
  4117. "codeviewer",
  4118. "issueadmin",
  4119. "scan",
  4120. "user"
  4121. ]
  4122. },
  4123. {
  4124. "key": "ps",
  4125. "description": "Page size. Must be greater than 0 and less than 100",
  4126. "required": false,
  4127. "internal": false,
  4128. "defaultValue": "20",
  4129. "exampleValue": "20",
  4130. "deprecatedKey": "pageSize",
  4131. "deprecatedKeySince": "5.2",
  4132. "maximumValue": 100
  4133. },
  4134. {
  4135. "key": "q",
  4136. "description": "Limit search to user names that contain the supplied string. Must have at least 3 characters.<br/>When this parameter is not set, only users having at least one permission are returned.",
  4137. "required": false,
  4138. "internal": false,
  4139. "exampleValue": "eri"
  4140. },
  4141. {
  4142. "key": "templateId",
  4143. "description": "Template id",
  4144. "required": false,
  4145. "internal": false,
  4146. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  4147. },
  4148. {
  4149. "key": "templateName",
  4150. "description": "Template name",
  4151. "required": false,
  4152. "internal": false,
  4153. "exampleValue": "Default Permission Template for Projects"
  4154. }
  4155. ]
  4156. },
  4157. {
  4158. "key": "update_template",
  4159. "description": "Update a permission template.<br />Requires the following permission: 'Administer System'.",
  4160. "since": "5.2",
  4161. "internal": false,
  4162. "post": true,
  4163. "hasResponseExample": true,
  4164. "changelog": [],
  4165. "params": [
  4166. {
  4167. "key": "description",
  4168. "description": "Description",
  4169. "required": false,
  4170. "internal": false,
  4171. "exampleValue": "Permissions for all projects related to the financial service"
  4172. },
  4173. {
  4174. "key": "id",
  4175. "description": "Id",
  4176. "required": true,
  4177. "internal": false,
  4178. "exampleValue": "af8cb8cc-1e78-4c4e-8c00-ee8e814009a5"
  4179. },
  4180. {
  4181. "key": "name",
  4182. "description": "Name",
  4183. "required": false,
  4184. "internal": false,
  4185. "exampleValue": "Financial Service Permissions"
  4186. },
  4187. {
  4188. "key": "projectKeyPattern",
  4189. "description": "Project key pattern. Must be a valid Java regular expression",
  4190. "required": false,
  4191. "internal": false,
  4192. "exampleValue": ".*\\.finance\\..*"
  4193. }
  4194. ]
  4195. },
  4196. {
  4197. "key": "users",
  4198. "description": "Lists the users with their permissions as individual users rather than through group affiliation.<br>This service defaults to global permissions, but can be limited to project permissions by providing project id or project key.<br> This service defaults to all users, but can be limited to users with a specific permission by providing the desired permission.<br>Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  4199. "since": "5.2",
  4200. "internal": true,
  4201. "post": false,
  4202. "hasResponseExample": true,
  4203. "changelog": [],
  4204. "params": [
  4205. {
  4206. "key": "organization",
  4207. "description": "Key of organization, used when group name is set",
  4208. "since": "6.2",
  4209. "required": false,
  4210. "internal": true,
  4211. "exampleValue": "my-org"
  4212. },
  4213. {
  4214. "key": "p",
  4215. "description": "1-based page number",
  4216. "required": false,
  4217. "internal": false,
  4218. "defaultValue": "1",
  4219. "exampleValue": "42",
  4220. "deprecatedKey": "pageIndex",
  4221. "deprecatedKeySince": "5.2"
  4222. },
  4223. {
  4224. "key": "permission",
  4225. "description": "Permission<ul><li>Possible values for global permissions: admin, profileadmin, gateadmin, scan, provisioning</li><li>Possible values for project permissions admin, codeviewer, issueadmin, scan, user</li></ul>",
  4226. "required": false,
  4227. "internal": false
  4228. },
  4229. {
  4230. "key": "projectId",
  4231. "description": "Project id",
  4232. "required": false,
  4233. "internal": false,
  4234. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d"
  4235. },
  4236. {
  4237. "key": "projectKey",
  4238. "description": "Project key",
  4239. "required": false,
  4240. "internal": false,
  4241. "exampleValue": "my_project"
  4242. },
  4243. {
  4244. "key": "ps",
  4245. "description": "Page size. Must be greater than 0 and less than 100",
  4246. "required": false,
  4247. "internal": false,
  4248. "defaultValue": "20",
  4249. "exampleValue": "20",
  4250. "deprecatedKey": "pageSize",
  4251. "deprecatedKeySince": "5.2",
  4252. "maximumValue": 100
  4253. },
  4254. {
  4255. "key": "q",
  4256. "description": "Limit search to user names that contain the supplied string. Must have at least 3 characters.<br/>When this parameter is not set, only users having at least one permission are returned.",
  4257. "required": false,
  4258. "internal": false,
  4259. "exampleValue": "eri"
  4260. }
  4261. ]
  4262. }
  4263. ]
  4264. },
  4265. {
  4266. "path": "api/plugins",
  4267. "since": "5.2",
  4268. "description": "Manage the plugins on the server, including installing, uninstalling, and upgrading.",
  4269. "actions": [
  4270. {
  4271. "key": "available",
  4272. "description": "Get the list of all the plugins available for installation on the SonarQube instance, sorted by plugin name.<br/>Plugin information is retrieved from Update Center. Date and time at which Update Center was last refreshed is provided in the response.<br/>Update status values are: <ul><li>COMPATIBLE: plugin is compatible with current SonarQube instance.</li><li>INCOMPATIBLE: plugin is not compatible with current SonarQube instance.</li><li>REQUIRES_SYSTEM_UPGRADE: plugin requires SonarQube to be upgraded before being installed.</li><li>DEPS_REQUIRE_SYSTEM_UPGRADE: at least one plugin on which the plugin is dependent requires SonarQube to be upgraded.</li></ul>Require 'Administer System' permission.",
  4273. "since": "5.2",
  4274. "internal": false,
  4275. "post": false,
  4276. "hasResponseExample": true,
  4277. "changelog": []
  4278. },
  4279. {
  4280. "key": "cancel_all",
  4281. "description": "Cancels any operation pending on any plugin (install, update or uninstall)<br/>Requires user to be authenticated with Administer System permissions",
  4282. "since": "5.2",
  4283. "internal": false,
  4284. "post": true,
  4285. "hasResponseExample": false,
  4286. "changelog": []
  4287. },
  4288. {
  4289. "key": "install",
  4290. "description": "Installs the latest version of a plugin specified by its key.<br/>Plugin information is retrieved from Update Center.<br/>Requires user to be authenticated with Administer System permissions",
  4291. "since": "5.2",
  4292. "internal": false,
  4293. "post": true,
  4294. "hasResponseExample": false,
  4295. "changelog": [],
  4296. "params": [
  4297. {
  4298. "key": "key",
  4299. "description": "The key identifying the plugin to install",
  4300. "required": true,
  4301. "internal": false
  4302. }
  4303. ]
  4304. },
  4305. {
  4306. "key": "installed",
  4307. "description": "Get the list of all the plugins installed on the SonarQube instance, sorted by plugin name.",
  4308. "since": "5.2",
  4309. "internal": false,
  4310. "post": false,
  4311. "hasResponseExample": true,
  4312. "changelog": [
  4313. {
  4314. "description": "The 'filename' field is added",
  4315. "version": "6.6"
  4316. },
  4317. {
  4318. "description": "The 'fileHash' field is added",
  4319. "version": "6.6"
  4320. },
  4321. {
  4322. "description": "The 'sonarLintSupported' field is added",
  4323. "version": "6.6"
  4324. },
  4325. {
  4326. "description": "The 'updatedAt' field is added",
  4327. "version": "6.6"
  4328. }
  4329. ],
  4330. "params": [
  4331. {
  4332. "key": "f",
  4333. "description": "Comma-separated list of the additional fields to be returned in response. No additional field is returned by default. Possible values are:<ul><li>category - category as defined in the Update Center. A connection to the Update Center is needed</li></lu>",
  4334. "since": "5.6",
  4335. "required": false,
  4336. "internal": false,
  4337. "possibleValues": [
  4338. "category"
  4339. ]
  4340. }
  4341. ]
  4342. },
  4343. {
  4344. "key": "pending",
  4345. "description": "Get the list of plugins which will either be installed or removed at the next startup of the SonarQube instance, sorted by plugin name.<br/>Require 'Administer System' permission.",
  4346. "since": "5.2",
  4347. "internal": false,
  4348. "post": false,
  4349. "hasResponseExample": true,
  4350. "changelog": []
  4351. },
  4352. {
  4353. "key": "uninstall",
  4354. "description": "Uninstalls the plugin specified by its key.<br/>Requires user to be authenticated with Administer System permissions.",
  4355. "since": "5.2",
  4356. "internal": false,
  4357. "post": true,
  4358. "hasResponseExample": false,
  4359. "changelog": [],
  4360. "params": [
  4361. {
  4362. "key": "key",
  4363. "description": "The key identifying the plugin to uninstall",
  4364. "required": true,
  4365. "internal": false
  4366. }
  4367. ]
  4368. },
  4369. {
  4370. "key": "update",
  4371. "description": "Updates a plugin specified by its key to the latest version compatible with the SonarQube instance.<br/>Plugin information is retrieved from Update Center.<br/>Requires user to be authenticated with Administer System permissions",
  4372. "since": "5.2",
  4373. "internal": false,
  4374. "post": true,
  4375. "hasResponseExample": false,
  4376. "changelog": [],
  4377. "params": [
  4378. {
  4379. "key": "key",
  4380. "description": "The key identifying the plugin to update",
  4381. "required": true,
  4382. "internal": false
  4383. }
  4384. ]
  4385. },
  4386. {
  4387. "key": "updates",
  4388. "description": "Lists plugins installed on the SonarQube instance for which at least one newer version is available, sorted by plugin name.<br/>Each newer version is listed, ordered from the oldest to the newest, with its own update/compatibility status.<br/>Plugin information is retrieved from Update Center. Date and time at which Update Center was last refreshed is provided in the response.<br/>Update status values are: [COMPATIBLE, INCOMPATIBLE, REQUIRES_UPGRADE, DEPS_REQUIRE_UPGRADE].<br/>Require 'Administer System' permission.",
  4389. "since": "5.2",
  4390. "internal": false,
  4391. "post": false,
  4392. "hasResponseExample": true,
  4393. "changelog": []
  4394. }
  4395. ]
  4396. },
  4397. {
  4398. "path": "api/profiles",
  4399. "since": "4.4",
  4400. "description": "Removed since 6.3, please use api/qualityprofiles instead",
  4401. "actions": [
  4402. {
  4403. "key": "index",
  4404. "description": "Get a profile.<br/>The web service is removed and you're invited to use api/qualityprofiles/search instead",
  4405. "since": "3.3",
  4406. "deprecatedSince": "5.2",
  4407. "internal": false,
  4408. "post": false,
  4409. "hasResponseExample": true,
  4410. "changelog": []
  4411. },
  4412. {
  4413. "key": "list",
  4414. "description": "Get a list of profiles.<br/>The web service is removed and you're invited to use api/qualityprofiles/search instead",
  4415. "since": "3.3",
  4416. "deprecatedSince": "5.2",
  4417. "internal": false,
  4418. "post": false,
  4419. "hasResponseExample": true,
  4420. "changelog": []
  4421. }
  4422. ]
  4423. },
  4424. {
  4425. "path": "api/project_analyses",
  4426. "since": "6.3",
  4427. "description": "Manage project analyses.",
  4428. "actions": [
  4429. {
  4430. "key": "create_event",
  4431. "description": "Create a project analysis event.<br>Only event of category 'VERSION' and 'OTHER' can be created.<br>Requires one of the following permissions:<ul> <li>'Administer System'</li> <li>'Administer' rights on the specified project</li></ul>",
  4432. "since": "6.3",
  4433. "internal": false,
  4434. "post": true,
  4435. "hasResponseExample": true,
  4436. "changelog": [],
  4437. "params": [
  4438. {
  4439. "key": "analysis",
  4440. "description": "Analysis key",
  4441. "required": true,
  4442. "internal": false,
  4443. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  4444. },
  4445. {
  4446. "key": "category",
  4447. "description": "Category",
  4448. "required": false,
  4449. "internal": false,
  4450. "defaultValue": "OTHER",
  4451. "possibleValues": [
  4452. "VERSION",
  4453. "OTHER"
  4454. ]
  4455. },
  4456. {
  4457. "key": "name",
  4458. "description": "Name",
  4459. "required": true,
  4460. "internal": false,
  4461. "exampleValue": "5.6",
  4462. "maximumLength": 400
  4463. }
  4464. ]
  4465. },
  4466. {
  4467. "key": "delete",
  4468. "description": "Delete a project analysis.<br>Requires one of the following permissions:<ul> <li>'Administer System'</li> <li>'Administer' rights on the project of the specified analysis</li></ul>",
  4469. "since": "6.3",
  4470. "internal": false,
  4471. "post": true,
  4472. "hasResponseExample": false,
  4473. "changelog": [],
  4474. "params": [
  4475. {
  4476. "key": "analysis",
  4477. "description": "Analysis key",
  4478. "required": true,
  4479. "internal": false,
  4480. "exampleValue": "AU-TpxcA-iU5OvuD2FL1"
  4481. }
  4482. ]
  4483. },
  4484. {
  4485. "key": "delete_event",
  4486. "description": "Delete a project analysis event.<br>Only event of category 'VERSION' and 'OTHER' can be deleted.<br>Requires one of the following permissions:<ul> <li>'Administer System'</li> <li>'Administer' rights on the specified project</li></ul>",
  4487. "since": "6.3",
  4488. "internal": false,
  4489. "post": true,
  4490. "hasResponseExample": false,
  4491. "changelog": [],
  4492. "params": [
  4493. {
  4494. "key": "event",
  4495. "description": "Event key",
  4496. "required": true,
  4497. "internal": false,
  4498. "exampleValue": "AU-TpxcA-iU5OvuD2FLz"
  4499. }
  4500. ]
  4501. },
  4502. {
  4503. "key": "search",
  4504. "description": "Search a project analyses and attached events.<br>Requires the following permission: 'Browse' on the specified project",
  4505. "since": "6.3",
  4506. "internal": false,
  4507. "post": false,
  4508. "hasResponseExample": true,
  4509. "changelog": [],
  4510. "params": [
  4511. {
  4512. "key": "branch",
  4513. "description": "Branch key",
  4514. "since": "6.6",
  4515. "required": false,
  4516. "internal": true,
  4517. "exampleValue": "feature/my_branch"
  4518. },
  4519. {
  4520. "key": "category",
  4521. "description": "Event category. Filter analyses that have at least one event of the category specified.",
  4522. "required": false,
  4523. "internal": false,
  4524. "exampleValue": "OTHER",
  4525. "possibleValues": [
  4526. "VERSION",
  4527. "OTHER",
  4528. "QUALITY_PROFILE",
  4529. "QUALITY_GATE"
  4530. ]
  4531. },
  4532. {
  4533. "key": "from",
  4534. "description": "Filter analyses created after the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided",
  4535. "since": "6.5",
  4536. "required": false,
  4537. "internal": false,
  4538. "exampleValue": "2013-05-01"
  4539. },
  4540. {
  4541. "key": "p",
  4542. "description": "1-based page number",
  4543. "required": false,
  4544. "internal": false,
  4545. "defaultValue": "1",
  4546. "exampleValue": "42",
  4547. "deprecatedKey": "pageIndex",
  4548. "deprecatedKeySince": "5.2"
  4549. },
  4550. {
  4551. "key": "project",
  4552. "description": "Project key",
  4553. "required": true,
  4554. "internal": false,
  4555. "exampleValue": "my_project"
  4556. },
  4557. {
  4558. "key": "ps",
  4559. "description": "Page size. Must be greater than 0 and less than 500",
  4560. "required": false,
  4561. "internal": false,
  4562. "defaultValue": "100",
  4563. "exampleValue": "20",
  4564. "deprecatedKey": "pageSize",
  4565. "deprecatedKeySince": "5.2",
  4566. "maximumValue": 500
  4567. },
  4568. {
  4569. "key": "to",
  4570. "description": "Filter analyses created before the given date (inclusive). <br>Either a date (server timezone) or datetime can be provided",
  4571. "since": "6.5",
  4572. "required": false,
  4573. "internal": false,
  4574. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  4575. }
  4576. ]
  4577. },
  4578. {
  4579. "key": "update_event",
  4580. "description": "Update a project analysis event.<br>Only events of category 'VERSION' and 'OTHER' can be updated.<br>Requires one of the following permissions:<ul> <li>'Administer System'</li> <li>'Administer' rights on the specified project</li></ul>",
  4581. "since": "6.3",
  4582. "internal": false,
  4583. "post": true,
  4584. "hasResponseExample": true,
  4585. "changelog": [],
  4586. "params": [
  4587. {
  4588. "key": "event",
  4589. "description": "Event key",
  4590. "required": true,
  4591. "internal": false,
  4592. "exampleValue": "AU-TpxcA-iU5OvuD2FL5"
  4593. },
  4594. {
  4595. "key": "name",
  4596. "description": "New name",
  4597. "required": false,
  4598. "internal": false,
  4599. "exampleValue": "5.6",
  4600. "maximumLength": 400
  4601. }
  4602. ]
  4603. }
  4604. ]
  4605. },
  4606. {
  4607. "path": "api/project_branches",
  4608. "since": "6.6",
  4609. "description": "Manage branch (only available when the Branch plugin is installed)",
  4610. "actions": [
  4611. {
  4612. "key": "delete",
  4613. "description": "Delete a non-main branch of a project.<br/>Requires 'Administer' rights on the specified project.",
  4614. "since": "6.6",
  4615. "internal": false,
  4616. "post": true,
  4617. "hasResponseExample": true,
  4618. "changelog": [],
  4619. "params": [
  4620. {
  4621. "key": "branch",
  4622. "description": "Name of the branch",
  4623. "required": true,
  4624. "internal": false,
  4625. "exampleValue": "branch1"
  4626. },
  4627. {
  4628. "key": "project",
  4629. "description": "Project key",
  4630. "required": true,
  4631. "internal": false,
  4632. "exampleValue": "my_project"
  4633. }
  4634. ]
  4635. },
  4636. {
  4637. "key": "list",
  4638. "description": "List the branches of a project.<br/>Requires 'Administer' rights on the specified project.",
  4639. "since": "6.6",
  4640. "internal": false,
  4641. "post": false,
  4642. "hasResponseExample": true,
  4643. "changelog": [],
  4644. "params": [
  4645. {
  4646. "key": "project",
  4647. "description": "Project key",
  4648. "required": true,
  4649. "internal": false,
  4650. "exampleValue": "my_project"
  4651. }
  4652. ]
  4653. },
  4654. {
  4655. "key": "rename",
  4656. "description": "Rename the main branch of a project.<br/>Requires 'Administer' permission on the specified project.",
  4657. "since": "6.6",
  4658. "internal": false,
  4659. "post": true,
  4660. "hasResponseExample": false,
  4661. "changelog": [],
  4662. "params": [
  4663. {
  4664. "key": "name",
  4665. "description": "New name of the main branch",
  4666. "required": true,
  4667. "internal": false,
  4668. "exampleValue": "branch1",
  4669. "maximumLength": 255
  4670. },
  4671. {
  4672. "key": "project",
  4673. "description": "Project key",
  4674. "required": true,
  4675. "internal": false,
  4676. "exampleValue": "my_project"
  4677. }
  4678. ]
  4679. }
  4680. ]
  4681. },
  4682. {
  4683. "path": "api/project_links",
  4684. "since": "6.1",
  4685. "description": "Manage projects links.",
  4686. "actions": [
  4687. {
  4688. "key": "create",
  4689. "description": "Create a new project link.<br>Requires 'Administer' permission on the specified project, or global 'Administer' permission.",
  4690. "since": "6.1",
  4691. "internal": false,
  4692. "post": true,
  4693. "hasResponseExample": true,
  4694. "changelog": [],
  4695. "params": [
  4696. {
  4697. "key": "name",
  4698. "description": "Link name",
  4699. "required": true,
  4700. "internal": false,
  4701. "exampleValue": "Custom",
  4702. "maximumLength": 128
  4703. },
  4704. {
  4705. "key": "projectId",
  4706. "description": "Project id",
  4707. "required": false,
  4708. "internal": false,
  4709. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  4710. },
  4711. {
  4712. "key": "projectKey",
  4713. "description": "Project key",
  4714. "required": false,
  4715. "internal": false,
  4716. "exampleValue": "my_project"
  4717. },
  4718. {
  4719. "key": "url",
  4720. "description": "Link url",
  4721. "required": true,
  4722. "internal": false,
  4723. "exampleValue": "http://example.com",
  4724. "maximumLength": 2048
  4725. }
  4726. ]
  4727. },
  4728. {
  4729. "key": "delete",
  4730. "description": "Delete existing project link.<br>Requires 'Administer' permission on the specified project, or global 'Administer' permission.",
  4731. "since": "6.1",
  4732. "internal": false,
  4733. "post": true,
  4734. "hasResponseExample": false,
  4735. "changelog": [],
  4736. "params": [
  4737. {
  4738. "key": "id",
  4739. "description": "Link id",
  4740. "required": true,
  4741. "internal": false,
  4742. "exampleValue": "17"
  4743. }
  4744. ]
  4745. },
  4746. {
  4747. "key": "search",
  4748. "description": "List links of a project.<br>The 'projectId' or 'projectKey' must be provided.<br>Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li><li>'Browse' on the specified project</li></ul>",
  4749. "since": "6.1",
  4750. "internal": false,
  4751. "post": false,
  4752. "hasResponseExample": true,
  4753. "changelog": [],
  4754. "params": [
  4755. {
  4756. "key": "projectId",
  4757. "description": "Project Id",
  4758. "required": false,
  4759. "internal": false,
  4760. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  4761. },
  4762. {
  4763. "key": "projectKey",
  4764. "description": "Project Key",
  4765. "required": false,
  4766. "internal": false,
  4767. "exampleValue": "my_project"
  4768. }
  4769. ]
  4770. }
  4771. ]
  4772. },
  4773. {
  4774. "path": "api/project_tags",
  4775. "since": "6.4",
  4776. "description": "Manage project tags",
  4777. "actions": [
  4778. {
  4779. "key": "search",
  4780. "description": "Search tags",
  4781. "since": "6.4",
  4782. "internal": false,
  4783. "post": false,
  4784. "hasResponseExample": true,
  4785. "changelog": [],
  4786. "params": [
  4787. {
  4788. "key": "ps",
  4789. "description": "Page size. Must be greater than 0 and less than 100",
  4790. "required": false,
  4791. "internal": false,
  4792. "defaultValue": "10",
  4793. "exampleValue": "20",
  4794. "deprecatedKey": "pageSize",
  4795. "deprecatedKeySince": "5.2",
  4796. "maximumValue": 100
  4797. },
  4798. {
  4799. "key": "q",
  4800. "description": "Limit search to tags that contain the supplied string.",
  4801. "required": false,
  4802. "internal": false,
  4803. "exampleValue": "off"
  4804. }
  4805. ]
  4806. },
  4807. {
  4808. "key": "set",
  4809. "description": "Set tags on a project.<br>Requires the following permission: 'Administer' rights on the specified project",
  4810. "since": "6.4",
  4811. "internal": false,
  4812. "post": true,
  4813. "hasResponseExample": false,
  4814. "changelog": [],
  4815. "params": [
  4816. {
  4817. "key": "project",
  4818. "description": "Project key",
  4819. "required": true,
  4820. "internal": false,
  4821. "exampleValue": "my_project"
  4822. },
  4823. {
  4824. "key": "tags",
  4825. "description": "Comma-separated list of tags",
  4826. "required": true,
  4827. "internal": false,
  4828. "exampleValue": "finance, offshore"
  4829. }
  4830. ]
  4831. }
  4832. ]
  4833. },
  4834. {
  4835. "path": "api/projects",
  4836. "since": "2.10",
  4837. "description": "Manage project existence.",
  4838. "actions": [
  4839. {
  4840. "key": "bulk_delete",
  4841. "description": "Delete one or several projects.<br />Requires 'Administer System' permission.",
  4842. "since": "5.2",
  4843. "internal": false,
  4844. "post": true,
  4845. "hasResponseExample": false,
  4846. "changelog": [],
  4847. "params": [
  4848. {
  4849. "key": "analyzedBefore",
  4850. "description": "Filter the projects for which last analysis is older than the given date (exclusive).<br> Either a date (server timezone) or datetime can be provided.",
  4851. "since": "6.6",
  4852. "required": false,
  4853. "internal": false,
  4854. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  4855. },
  4856. {
  4857. "key": "onProvisionedOnly",
  4858. "description": "Filter the projects that are provisioned",
  4859. "since": "6.6",
  4860. "required": false,
  4861. "internal": false,
  4862. "defaultValue": "false",
  4863. "possibleValues": [
  4864. "true",
  4865. "false",
  4866. "yes",
  4867. "no"
  4868. ]
  4869. },
  4870. {
  4871. "key": "organization",
  4872. "description": "The key of the organization",
  4873. "since": "6.3",
  4874. "required": false,
  4875. "internal": true
  4876. },
  4877. {
  4878. "key": "projectIds",
  4879. "description": "Comma-separated list of project ids",
  4880. "required": false,
  4881. "internal": false,
  4882. "exampleValue": "AU-Tpxb--iU5OvuD2FLy,AU-TpxcA-iU5OvuD2FLz",
  4883. "deprecatedSince": "6.4",
  4884. "deprecatedKey": "ids",
  4885. "deprecatedKeySince": "6.4"
  4886. },
  4887. {
  4888. "key": "projects",
  4889. "description": "Comma-separated list of project keys",
  4890. "required": false,
  4891. "internal": false,
  4892. "exampleValue": "my_project,another_project",
  4893. "deprecatedKey": "keys",
  4894. "deprecatedKeySince": "6.4"
  4895. },
  4896. {
  4897. "key": "q",
  4898. "description": "Limit to: <ul><li>component names that contain the supplied string</li><li>component keys that contain the supplied string</li></ul>",
  4899. "required": false,
  4900. "internal": false,
  4901. "exampleValue": "sonar"
  4902. },
  4903. {
  4904. "key": "qualifiers",
  4905. "description": "Comma-separated list of component qualifiers. Filter the results with the specified qualifiers",
  4906. "required": false,
  4907. "internal": false,
  4908. "defaultValue": "TRK",
  4909. "possibleValues": [
  4910. "TRK",
  4911. "VW",
  4912. "APP"
  4913. ]
  4914. },
  4915. {
  4916. "key": "visibility",
  4917. "description": "Filter the projects that should be visible to everyone (public), or only specific user/groups (private).<br/>If no visibility is specified, the default project visibility of the organization will be used.",
  4918. "since": "6.4",
  4919. "required": false,
  4920. "internal": true,
  4921. "possibleValues": [
  4922. "private",
  4923. "public"
  4924. ]
  4925. }
  4926. ]
  4927. },
  4928. {
  4929. "key": "bulk_update_key",
  4930. "description": "Bulk update a project or module key and all its sub-components keys. The bulk update allows to replace a part of the current key by another string on the current project and all its sub-modules.<br>It's possible to simulate the bulk update by setting the parameter 'dryRun' at true. No key is updated with a dry run.<br>Ex: to rename a project with key 'my_project' to 'my_new_project' and all its sub-components keys, call the WS with parameters:<ul> <li>project: my_project</li> <li>from: my_</li> <li>to: my_new_</li></ul>Either 'projectId' or 'project' must be provided.<br> Requires one of the following permissions: <ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  4931. "since": "6.1",
  4932. "internal": false,
  4933. "post": true,
  4934. "hasResponseExample": true,
  4935. "changelog": [
  4936. {
  4937. "description": "Moved from api/components/bulk_update_key to api/projects/bulk_update_key",
  4938. "version": "6.4"
  4939. }
  4940. ],
  4941. "params": [
  4942. {
  4943. "key": "dryRun",
  4944. "description": "Simulate bulk update. No component key is updated.",
  4945. "required": false,
  4946. "internal": false,
  4947. "defaultValue": "false",
  4948. "possibleValues": [
  4949. "true",
  4950. "false",
  4951. "yes",
  4952. "no"
  4953. ]
  4954. },
  4955. {
  4956. "key": "from",
  4957. "description": "String to match in components keys",
  4958. "required": true,
  4959. "internal": false,
  4960. "exampleValue": "_old"
  4961. },
  4962. {
  4963. "key": "project",
  4964. "description": "Project or module key",
  4965. "required": false,
  4966. "internal": false,
  4967. "exampleValue": "my_old_project",
  4968. "deprecatedKey": "key",
  4969. "deprecatedKeySince": "6.4"
  4970. },
  4971. {
  4972. "key": "projectId",
  4973. "description": "Project or module ID",
  4974. "required": false,
  4975. "internal": false,
  4976. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  4977. "deprecatedSince": "6.4",
  4978. "deprecatedKey": "id",
  4979. "deprecatedKeySince": "6.4"
  4980. },
  4981. {
  4982. "key": "to",
  4983. "description": "String replacement in components keys",
  4984. "required": true,
  4985. "internal": false,
  4986. "exampleValue": "_new"
  4987. }
  4988. ]
  4989. },
  4990. {
  4991. "key": "create",
  4992. "description": "Create a project.<br/>Requires 'Create Projects' permission",
  4993. "since": "4.0",
  4994. "internal": false,
  4995. "post": true,
  4996. "hasResponseExample": true,
  4997. "changelog": [
  4998. {
  4999. "description": "The response format has been updated and does not contain the database ID anymore",
  5000. "version": "6.3"
  5001. },
  5002. {
  5003. "description": "The 'key' parameter has been renamed 'project'",
  5004. "version": "6.3"
  5005. }
  5006. ],
  5007. "params": [
  5008. {
  5009. "key": "branch",
  5010. "description": "SCM Branch of the project. The key of the project will become key:branch, for instance 'SonarQube:branch-5.0'",
  5011. "required": false,
  5012. "internal": false,
  5013. "exampleValue": "branch-5.0"
  5014. },
  5015. {
  5016. "key": "name",
  5017. "description": "Name of the project",
  5018. "required": true,
  5019. "internal": false,
  5020. "exampleValue": "SonarQube",
  5021. "maximumLength": 2000
  5022. },
  5023. {
  5024. "key": "organization",
  5025. "description": "The key of the organization",
  5026. "since": "6.3",
  5027. "required": false,
  5028. "internal": true
  5029. },
  5030. {
  5031. "key": "project",
  5032. "description": "Key of the project",
  5033. "required": true,
  5034. "internal": false,
  5035. "exampleValue": "my_project",
  5036. "deprecatedKey": "key",
  5037. "deprecatedKeySince": "6.3",
  5038. "maximumLength": 400
  5039. },
  5040. {
  5041. "key": "visibility",
  5042. "description": "Whether the created project should be visible to everyone, or only specific user/groups.<br/>If no visibility is specified, the default project visibility of the organization will be used.",
  5043. "since": "6.4",
  5044. "required": false,
  5045. "internal": true,
  5046. "possibleValues": [
  5047. "private",
  5048. "public"
  5049. ]
  5050. }
  5051. ]
  5052. },
  5053. {
  5054. "key": "delete",
  5055. "description": "Delete a project.<br> Requires 'Administer System' permission or 'Administer' permission on the project.",
  5056. "since": "5.2",
  5057. "internal": false,
  5058. "post": true,
  5059. "hasResponseExample": false,
  5060. "changelog": [],
  5061. "params": [
  5062. {
  5063. "key": "project",
  5064. "description": "Project key",
  5065. "required": false,
  5066. "internal": false,
  5067. "exampleValue": "my_project",
  5068. "deprecatedKey": "key",
  5069. "deprecatedKeySince": "6.4"
  5070. },
  5071. {
  5072. "key": "projectId",
  5073. "description": "Project ID",
  5074. "required": false,
  5075. "internal": false,
  5076. "exampleValue": "ce4c03d6-430f-40a9-b777-ad877c00aa4d",
  5077. "deprecatedSince": "6.4",
  5078. "deprecatedKey": "id",
  5079. "deprecatedKeySince": "6.4"
  5080. }
  5081. ]
  5082. },
  5083. {
  5084. "key": "ghosts",
  5085. "description": "List ghost projects.<br> With the current architecture, it's no more possible to have invisible ghost projects. Therefore, the web service is deprecated.<br> Requires 'Administer System' permission.",
  5086. "since": "5.2",
  5087. "deprecatedSince": "6.6",
  5088. "internal": false,
  5089. "post": false,
  5090. "hasResponseExample": true,
  5091. "changelog": [
  5092. {
  5093. "description": "The 'uuid' field is deprecated in the response",
  5094. "version": "6.4"
  5095. }
  5096. ],
  5097. "params": [
  5098. {
  5099. "key": "f",
  5100. "description": "Comma-separated list of the fields to be returned in response. All the fields are returned by default.",
  5101. "required": false,
  5102. "internal": false,
  5103. "possibleValues": [
  5104. "name",
  5105. "creationDate",
  5106. "visibility",
  5107. "uuid",
  5108. "key"
  5109. ]
  5110. },
  5111. {
  5112. "key": "organization",
  5113. "description": "Organization key",
  5114. "since": "6.3",
  5115. "required": false,
  5116. "internal": true
  5117. },
  5118. {
  5119. "key": "p",
  5120. "description": "1-based page number",
  5121. "required": false,
  5122. "internal": false,
  5123. "defaultValue": "1",
  5124. "exampleValue": "42",
  5125. "deprecatedKey": "pageIndex",
  5126. "deprecatedKeySince": "5.2"
  5127. },
  5128. {
  5129. "key": "ps",
  5130. "description": "Page size. Must be greater than 0 and less than 500",
  5131. "required": false,
  5132. "internal": false,
  5133. "defaultValue": "100",
  5134. "exampleValue": "20",
  5135. "deprecatedKey": "pageSize",
  5136. "deprecatedKeySince": "5.2",
  5137. "maximumValue": 500
  5138. },
  5139. {
  5140. "key": "q",
  5141. "description": "Limit search to names or keys that contain the supplied string.",
  5142. "required": false,
  5143. "internal": false,
  5144. "exampleValue": "sonar"
  5145. }
  5146. ]
  5147. },
  5148. {
  5149. "key": "index",
  5150. "description": "This web service is deprecated, please use api/components/search instead",
  5151. "since": "2.10",
  5152. "deprecatedSince": "6.3",
  5153. "internal": false,
  5154. "post": false,
  5155. "hasResponseExample": true,
  5156. "changelog": [
  5157. {
  5158. "description": "The parameters 'desc', 'views', 'libs' and 'versions' have no effect.",
  5159. "version": "6.3"
  5160. }
  5161. ],
  5162. "params": [
  5163. {
  5164. "key": "desc",
  5165. "description": "Since 6.3, this parameter has no effect",
  5166. "required": false,
  5167. "internal": false,
  5168. "deprecatedSince": "6.3"
  5169. },
  5170. {
  5171. "key": "format",
  5172. "description": "Only json response format is available",
  5173. "required": false,
  5174. "internal": false,
  5175. "possibleValues": [
  5176. "json"
  5177. ]
  5178. },
  5179. {
  5180. "key": "libs",
  5181. "description": "Since 6.3, this parameter has no effect",
  5182. "required": false,
  5183. "internal": false,
  5184. "deprecatedSince": "6.3"
  5185. },
  5186. {
  5187. "key": "project",
  5188. "description": "key or ID of the project",
  5189. "required": false,
  5190. "internal": false,
  5191. "exampleValue": "my_project",
  5192. "deprecatedKey": "key",
  5193. "deprecatedKeySince": "6.4"
  5194. },
  5195. {
  5196. "key": "search",
  5197. "description": "Substring of project name, case insensitive. Ignored if the parameter key is set",
  5198. "required": false,
  5199. "internal": false,
  5200. "exampleValue": "Sonar"
  5201. },
  5202. {
  5203. "key": "subprojects",
  5204. "description": "Load sub-projects. Ignored if the parameter key is set",
  5205. "required": false,
  5206. "internal": false,
  5207. "defaultValue": "false",
  5208. "possibleValues": [
  5209. "true",
  5210. "false",
  5211. "yes",
  5212. "no"
  5213. ]
  5214. },
  5215. {
  5216. "key": "versions",
  5217. "description": "Since 6.3, this parameter has no effect",
  5218. "required": false,
  5219. "internal": false,
  5220. "deprecatedSince": "6.3"
  5221. },
  5222. {
  5223. "key": "views",
  5224. "description": "Since 6.3, this parameter has no effect",
  5225. "required": false,
  5226. "internal": false,
  5227. "deprecatedSince": "6.3"
  5228. }
  5229. ]
  5230. },
  5231. {
  5232. "key": "provisioned",
  5233. "description": "Get the list of provisioned projects.<br> Web service is deprecated. Use api/projects/search instead, with onProvisionedOnly=true.<br> Require 'Create Projects' permission.",
  5234. "since": "5.2",
  5235. "deprecatedSince": "6.6",
  5236. "internal": false,
  5237. "post": false,
  5238. "hasResponseExample": true,
  5239. "changelog": [
  5240. {
  5241. "description": "The 'uuid' field is deprecated in the response",
  5242. "version": "6.4"
  5243. },
  5244. {
  5245. "description": "Paging response fields is now in a Paging object",
  5246. "version": "6.4"
  5247. }
  5248. ],
  5249. "params": [
  5250. {
  5251. "key": "f",
  5252. "description": "Comma-separated list of the fields to be returned in response. All the fields are returned by default.",
  5253. "required": false,
  5254. "internal": false,
  5255. "possibleValues": [
  5256. "name",
  5257. "creationDate",
  5258. "visibility",
  5259. "uuid",
  5260. "key"
  5261. ]
  5262. },
  5263. {
  5264. "key": "organization",
  5265. "description": "The key of the organization",
  5266. "since": "6.3",
  5267. "required": false,
  5268. "internal": true
  5269. },
  5270. {
  5271. "key": "p",
  5272. "description": "1-based page number",
  5273. "required": false,
  5274. "internal": false,
  5275. "defaultValue": "1",
  5276. "exampleValue": "42",
  5277. "deprecatedKey": "pageIndex",
  5278. "deprecatedKeySince": "5.2"
  5279. },
  5280. {
  5281. "key": "ps",
  5282. "description": "Page size. Must be greater than 0 and less than 500",
  5283. "required": false,
  5284. "internal": false,
  5285. "defaultValue": "100",
  5286. "exampleValue": "20",
  5287. "deprecatedKey": "pageSize",
  5288. "deprecatedKeySince": "5.2",
  5289. "maximumValue": 500
  5290. },
  5291. {
  5292. "key": "q",
  5293. "description": "Limit search to names or keys that contain the supplied string.",
  5294. "required": false,
  5295. "internal": false,
  5296. "exampleValue": "sonar"
  5297. }
  5298. ]
  5299. },
  5300. {
  5301. "key": "search",
  5302. "description": "Search for projects or views to administrate them.<br>Requires 'System Administrator' permission",
  5303. "since": "6.3",
  5304. "internal": false,
  5305. "post": false,
  5306. "hasResponseExample": true,
  5307. "changelog": [
  5308. {
  5309. "description": "The 'uuid' field is deprecated in the response",
  5310. "version": "6.4"
  5311. }
  5312. ],
  5313. "params": [
  5314. {
  5315. "key": "analyzedBefore",
  5316. "description": "Filter the projects for which last analysis is older than the given date (exclusive).<br> Either a date (server timezone) or datetime can be provided.",
  5317. "since": "6.6",
  5318. "required": false,
  5319. "internal": false,
  5320. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  5321. },
  5322. {
  5323. "key": "onProvisionedOnly",
  5324. "description": "Filter the projects that are provisioned",
  5325. "since": "6.6",
  5326. "required": false,
  5327. "internal": false,
  5328. "defaultValue": "false",
  5329. "possibleValues": [
  5330. "true",
  5331. "false",
  5332. "yes",
  5333. "no"
  5334. ]
  5335. },
  5336. {
  5337. "key": "organization",
  5338. "description": "The key of the organization",
  5339. "since": "6.3",
  5340. "required": false,
  5341. "internal": true
  5342. },
  5343. {
  5344. "key": "p",
  5345. "description": "1-based page number",
  5346. "required": false,
  5347. "internal": false,
  5348. "defaultValue": "1",
  5349. "exampleValue": "42",
  5350. "deprecatedKey": "pageIndex",
  5351. "deprecatedKeySince": "5.2"
  5352. },
  5353. {
  5354. "key": "projectIds",
  5355. "description": "Comma-separated list of project ids",
  5356. "since": "6.6",
  5357. "required": false,
  5358. "internal": false,
  5359. "exampleValue": "AU-Tpxb--iU5OvuD2FLy,AU-TpxcA-iU5OvuD2FLz",
  5360. "deprecatedSince": "6.6"
  5361. },
  5362. {
  5363. "key": "projects",
  5364. "description": "Comma-separated list of project keys",
  5365. "since": "6.6",
  5366. "required": false,
  5367. "internal": false,
  5368. "exampleValue": "my_project,another_project"
  5369. },
  5370. {
  5371. "key": "ps",
  5372. "description": "Page size. Must be greater than 0 and less than 500",
  5373. "required": false,
  5374. "internal": false,
  5375. "defaultValue": "100",
  5376. "exampleValue": "20",
  5377. "deprecatedKey": "pageSize",
  5378. "deprecatedKeySince": "5.2",
  5379. "maximumValue": 500
  5380. },
  5381. {
  5382. "key": "q",
  5383. "description": "Limit search to: <ul><li>component names that contain the supplied string</li><li>component keys that contain the supplied string</li></ul>",
  5384. "required": false,
  5385. "internal": false,
  5386. "exampleValue": "sonar"
  5387. },
  5388. {
  5389. "key": "qualifiers",
  5390. "description": "Comma-separated list of component qualifiers. Filter the results with the specified qualifiers",
  5391. "required": false,
  5392. "internal": false,
  5393. "defaultValue": "TRK",
  5394. "possibleValues": [
  5395. "TRK",
  5396. "VW",
  5397. "APP"
  5398. ]
  5399. },
  5400. {
  5401. "key": "visibility",
  5402. "description": "Filter the projects that should be visible to everyone (public), or only specific user/groups (private).<br/>If no visibility is specified, the default project visibility of the organization will be used.",
  5403. "since": "6.4",
  5404. "required": false,
  5405. "internal": true,
  5406. "possibleValues": [
  5407. "private",
  5408. "public"
  5409. ]
  5410. }
  5411. ]
  5412. },
  5413. {
  5414. "key": "search_my_projects",
  5415. "description": "Return list of projects for which the current user has 'Administer' permission.",
  5416. "since": "6.0",
  5417. "internal": true,
  5418. "post": false,
  5419. "hasResponseExample": true,
  5420. "changelog": [
  5421. {
  5422. "description": "The 'id' field is deprecated in the response",
  5423. "version": "6.4"
  5424. }
  5425. ],
  5426. "params": [
  5427. {
  5428. "key": "p",
  5429. "description": "1-based page number",
  5430. "required": false,
  5431. "internal": false,
  5432. "defaultValue": "1",
  5433. "exampleValue": "42",
  5434. "deprecatedKey": "pageIndex",
  5435. "deprecatedKeySince": "5.2"
  5436. },
  5437. {
  5438. "key": "ps",
  5439. "description": "Page size. Must be greater than 0 and less than 500",
  5440. "required": false,
  5441. "internal": false,
  5442. "defaultValue": "100",
  5443. "exampleValue": "20",
  5444. "deprecatedKey": "pageSize",
  5445. "deprecatedKeySince": "5.2",
  5446. "maximumValue": 500
  5447. }
  5448. ]
  5449. },
  5450. {
  5451. "key": "update_key",
  5452. "description": "Update a project or module key and all its sub-components keys.<br>Either 'from' or 'projectId' must be provided.<br> Requires one of the following permissions: <ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li></ul>",
  5453. "since": "6.1",
  5454. "internal": false,
  5455. "post": true,
  5456. "hasResponseExample": false,
  5457. "changelog": [
  5458. {
  5459. "description": "Move from api/components/update_key to api/projects/update_key",
  5460. "version": "6.4"
  5461. }
  5462. ],
  5463. "params": [
  5464. {
  5465. "key": "from",
  5466. "description": "Project or module key",
  5467. "required": false,
  5468. "internal": false,
  5469. "exampleValue": "my_old_project",
  5470. "deprecatedKey": "key",
  5471. "deprecatedKeySince": "6.4"
  5472. },
  5473. {
  5474. "key": "projectId",
  5475. "description": "Project or module id",
  5476. "required": false,
  5477. "internal": false,
  5478. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  5479. "deprecatedSince": "6.4",
  5480. "deprecatedKey": "id",
  5481. "deprecatedKeySince": "6.4"
  5482. },
  5483. {
  5484. "key": "to",
  5485. "description": "New component key",
  5486. "required": true,
  5487. "internal": false,
  5488. "exampleValue": "my_new_project",
  5489. "deprecatedKey": "newKey",
  5490. "deprecatedKeySince": "6.4"
  5491. }
  5492. ]
  5493. },
  5494. {
  5495. "key": "update_visibility",
  5496. "description": "Updates visibility of a project.<br>Requires 'Project administer' permission on the specified project",
  5497. "since": "6.4",
  5498. "internal": false,
  5499. "post": true,
  5500. "hasResponseExample": false,
  5501. "changelog": [],
  5502. "params": [
  5503. {
  5504. "key": "project",
  5505. "description": "Project key",
  5506. "required": true,
  5507. "internal": false,
  5508. "exampleValue": "my_project"
  5509. },
  5510. {
  5511. "key": "visibility",
  5512. "description": "New visibility",
  5513. "required": true,
  5514. "internal": false,
  5515. "possibleValues": [
  5516. "private",
  5517. "public"
  5518. ]
  5519. }
  5520. ]
  5521. }
  5522. ]
  5523. },
  5524. {
  5525. "path": "api/properties",
  5526. "since": "2.6",
  5527. "description": "This web service is deprecated, please use api/settings instead.",
  5528. "actions": [
  5529. {
  5530. "key": "index",
  5531. "description": "This web service is deprecated, please use api/settings/values instead.",
  5532. "since": "2.6",
  5533. "deprecatedSince": "6.3",
  5534. "internal": false,
  5535. "post": false,
  5536. "hasResponseExample": true,
  5537. "changelog": [],
  5538. "params": [
  5539. {
  5540. "key": "format",
  5541. "description": "Only json response format is available",
  5542. "required": false,
  5543. "internal": false,
  5544. "possibleValues": [
  5545. "json"
  5546. ]
  5547. },
  5548. {
  5549. "key": "id",
  5550. "description": "Setting key",
  5551. "required": false,
  5552. "internal": false,
  5553. "exampleValue": "sonar.test.inclusions"
  5554. },
  5555. {
  5556. "key": "resource",
  5557. "description": "Component key or database id",
  5558. "required": false,
  5559. "internal": false,
  5560. "exampleValue": "my_project"
  5561. }
  5562. ]
  5563. }
  5564. ]
  5565. },
  5566. {
  5567. "path": "api/qualitygates",
  5568. "since": "4.3",
  5569. "description": "Manage quality gates, including conditions and project association.",
  5570. "actions": [
  5571. {
  5572. "key": "app",
  5573. "description": "Get initialization items for the admin UI. For internal use",
  5574. "since": "4.3",
  5575. "internal": true,
  5576. "post": false,
  5577. "hasResponseExample": true,
  5578. "changelog": []
  5579. },
  5580. {
  5581. "key": "copy",
  5582. "description": "Copy a Quality Gate.<br>Requires the 'Administer Quality Gates' permission.",
  5583. "since": "4.3",
  5584. "internal": false,
  5585. "post": true,
  5586. "hasResponseExample": false,
  5587. "changelog": [],
  5588. "params": [
  5589. {
  5590. "key": "id",
  5591. "description": "The ID of the source quality gate",
  5592. "required": true,
  5593. "internal": false,
  5594. "exampleValue": "1"
  5595. },
  5596. {
  5597. "key": "name",
  5598. "description": "The name of the quality gate to create",
  5599. "required": true,
  5600. "internal": false,
  5601. "exampleValue": "My Quality Gate"
  5602. }
  5603. ]
  5604. },
  5605. {
  5606. "key": "create",
  5607. "description": "Create a Quality Gate.<br>Requires the 'Administer Quality Gates' permission.",
  5608. "since": "4.3",
  5609. "internal": false,
  5610. "post": true,
  5611. "hasResponseExample": false,
  5612. "changelog": [],
  5613. "params": [
  5614. {
  5615. "key": "name",
  5616. "description": "The name of the quality gate to create",
  5617. "required": true,
  5618. "internal": false,
  5619. "exampleValue": "My Quality Gate",
  5620. "maximumLength": 100
  5621. }
  5622. ]
  5623. },
  5624. {
  5625. "key": "create_condition",
  5626. "description": "Add a new condition to a quality gate.<br>Requires the 'Administer Quality Gates' permission.",
  5627. "since": "4.3",
  5628. "internal": false,
  5629. "post": true,
  5630. "hasResponseExample": false,
  5631. "changelog": [],
  5632. "params": [
  5633. {
  5634. "key": "error",
  5635. "description": "Condition error threshold",
  5636. "required": false,
  5637. "internal": false,
  5638. "exampleValue": "10",
  5639. "maximumLength": 64
  5640. },
  5641. {
  5642. "key": "gateId",
  5643. "description": "ID of the quality gate",
  5644. "required": true,
  5645. "internal": false,
  5646. "exampleValue": "1"
  5647. },
  5648. {
  5649. "key": "metric",
  5650. "description": "Condition metric",
  5651. "required": true,
  5652. "internal": false,
  5653. "exampleValue": "blocker_violations"
  5654. },
  5655. {
  5656. "key": "op",
  5657. "description": "Condition operator:<br/><ul><li>EQ = equals</li><li>NE = is not</li><li>LT = is lower than</li><li>GT = is greater than</li></ui>",
  5658. "required": false,
  5659. "internal": false,
  5660. "exampleValue": "EQ",
  5661. "possibleValues": [
  5662. "LT",
  5663. "GT",
  5664. "EQ",
  5665. "NE"
  5666. ]
  5667. },
  5668. {
  5669. "key": "period",
  5670. "description": "Condition period. If not set, the absolute value is considered.",
  5671. "required": false,
  5672. "internal": false,
  5673. "possibleValues": [
  5674. "1"
  5675. ]
  5676. },
  5677. {
  5678. "key": "warning",
  5679. "description": "Condition warning threshold",
  5680. "required": false,
  5681. "internal": false,
  5682. "exampleValue": "5",
  5683. "maximumLength": 64
  5684. }
  5685. ]
  5686. },
  5687. {
  5688. "key": "delete_condition",
  5689. "description": "Delete a condition from a quality gate.<br>Requires the 'Administer Quality Gates' permission.",
  5690. "since": "4.3",
  5691. "internal": false,
  5692. "post": true,
  5693. "hasResponseExample": false,
  5694. "changelog": [],
  5695. "params": [
  5696. {
  5697. "key": "id",
  5698. "description": "Condition ID",
  5699. "required": true,
  5700. "internal": false,
  5701. "exampleValue": "2"
  5702. }
  5703. ]
  5704. },
  5705. {
  5706. "key": "deselect",
  5707. "description": "Remove the association of a project from a quality gate.<br>Requires the 'Administer Quality Gates' permission.",
  5708. "since": "4.3",
  5709. "internal": false,
  5710. "post": true,
  5711. "hasResponseExample": false,
  5712. "changelog": [
  5713. {
  5714. "description": "The parameter 'gateId' was removed",
  5715. "version": "6.6"
  5716. }
  5717. ],
  5718. "params": [
  5719. {
  5720. "key": "projectId",
  5721. "description": "Project id",
  5722. "required": false,
  5723. "internal": false,
  5724. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  5725. "deprecatedSince": "6.1"
  5726. },
  5727. {
  5728. "key": "projectKey",
  5729. "description": "Project key",
  5730. "since": "6.1",
  5731. "required": false,
  5732. "internal": false,
  5733. "exampleValue": "my_project"
  5734. }
  5735. ]
  5736. },
  5737. {
  5738. "key": "destroy",
  5739. "description": "Delete a Quality Gate.<br>Requires the 'Administer Quality Gates' permission.",
  5740. "since": "4.3",
  5741. "internal": false,
  5742. "post": true,
  5743. "hasResponseExample": false,
  5744. "changelog": [],
  5745. "params": [
  5746. {
  5747. "key": "id",
  5748. "description": "ID of the quality gate to delete",
  5749. "required": true,
  5750. "internal": false,
  5751. "exampleValue": "1"
  5752. }
  5753. ]
  5754. },
  5755. {
  5756. "key": "get_by_project",
  5757. "description": "Get the quality gate of a project.<br />Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li><li>'Browse' on the specified project</li></ul>",
  5758. "since": "6.1",
  5759. "internal": false,
  5760. "post": false,
  5761. "hasResponseExample": true,
  5762. "changelog": [
  5763. {
  5764. "description": "The parameter 'projectId' has been removed",
  5765. "version": "6.6"
  5766. },
  5767. {
  5768. "description": "The parameter 'projectKey' has been renamed to 'project'",
  5769. "version": "6.6"
  5770. },
  5771. {
  5772. "description": "This webservice is now part of the public API",
  5773. "version": "6.6"
  5774. }
  5775. ],
  5776. "params": [
  5777. {
  5778. "key": "project",
  5779. "description": "Project key",
  5780. "required": true,
  5781. "internal": false,
  5782. "exampleValue": "my_project"
  5783. }
  5784. ]
  5785. },
  5786. {
  5787. "key": "list",
  5788. "description": "Get a list of quality gates",
  5789. "since": "4.3",
  5790. "internal": false,
  5791. "post": false,
  5792. "hasResponseExample": true,
  5793. "changelog": []
  5794. },
  5795. {
  5796. "key": "project_status",
  5797. "description": "Get the quality gate status of a project or a Compute Engine task.<br />Either 'analysisId', 'projectId' or 'projectKey' must be provided<br />The different statuses returned are: OK, WARN, ERROR, NONE. The NONE status is returned when there is no quality gate associated with the analysis.<br />Returns an HTTP code 404 if the analysis associated with the task is not found or does not exist.<br />Requires one of the following permissions:<ul><li>'Administer System'</li><li>'Administer' rights on the specified project</li><li>'Browse' on the specified project</li></ul>",
  5798. "since": "5.3",
  5799. "internal": false,
  5800. "post": false,
  5801. "hasResponseExample": true,
  5802. "changelog": [
  5803. {
  5804. "description": "The field 'ignoredConditions' is added to the response",
  5805. "version": "6.4"
  5806. }
  5807. ],
  5808. "params": [
  5809. {
  5810. "key": "analysisId",
  5811. "description": "Analysis id",
  5812. "required": false,
  5813. "internal": false,
  5814. "exampleValue": "AU-TpxcA-iU5OvuD2FL1"
  5815. },
  5816. {
  5817. "key": "projectId",
  5818. "description": "Project id",
  5819. "since": "5.4",
  5820. "required": false,
  5821. "internal": false,
  5822. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  5823. },
  5824. {
  5825. "key": "projectKey",
  5826. "description": "Project key",
  5827. "since": "5.4",
  5828. "required": false,
  5829. "internal": false,
  5830. "exampleValue": "my_project"
  5831. }
  5832. ]
  5833. },
  5834. {
  5835. "key": "rename",
  5836. "description": "Rename a Quality Gate.<br>Requires the 'Administer Quality Gates' permission.",
  5837. "since": "4.3",
  5838. "internal": false,
  5839. "post": true,
  5840. "hasResponseExample": false,
  5841. "changelog": [],
  5842. "params": [
  5843. {
  5844. "key": "id",
  5845. "description": "ID of the quality gate to rename",
  5846. "required": true,
  5847. "internal": false,
  5848. "exampleValue": "1"
  5849. },
  5850. {
  5851. "key": "name",
  5852. "description": "New name of the quality gate",
  5853. "required": true,
  5854. "internal": false,
  5855. "exampleValue": "My Quality Gate",
  5856. "maximumLength": 100
  5857. }
  5858. ]
  5859. },
  5860. {
  5861. "key": "search",
  5862. "description": "Search for projects associated (or not) to a quality gate.<br/>Only authorized projects for current user will be returned.",
  5863. "since": "4.3",
  5864. "internal": false,
  5865. "post": false,
  5866. "hasResponseExample": true,
  5867. "changelog": [],
  5868. "params": [
  5869. {
  5870. "key": "gateId",
  5871. "description": "Quality Gate ID",
  5872. "required": true,
  5873. "internal": false,
  5874. "exampleValue": "1"
  5875. },
  5876. {
  5877. "key": "page",
  5878. "description": "Page number",
  5879. "required": false,
  5880. "internal": false,
  5881. "defaultValue": "1",
  5882. "exampleValue": "2"
  5883. },
  5884. {
  5885. "key": "pageSize",
  5886. "description": "Page size",
  5887. "required": false,
  5888. "internal": false,
  5889. "exampleValue": "10"
  5890. },
  5891. {
  5892. "key": "query",
  5893. "description": "To search for projects containing this string. If this parameter is set, \"selected\" is set to \"all\".",
  5894. "required": false,
  5895. "internal": false,
  5896. "exampleValue": "abc"
  5897. },
  5898. {
  5899. "key": "selected",
  5900. "description": "Depending on the value, show only selected items (selected=selected), deselected items (selected=deselected), or all items with their selection status (selected=all).",
  5901. "required": false,
  5902. "internal": false,
  5903. "defaultValue": "selected",
  5904. "possibleValues": [
  5905. "all",
  5906. "deselected",
  5907. "selected"
  5908. ]
  5909. }
  5910. ]
  5911. },
  5912. {
  5913. "key": "select",
  5914. "description": "Associate a project to a quality gate.<br>The 'projectId' or 'projectKey' must be provided.<br>Project id as a numeric value is deprecated since 6.1. Please use the id similar to 'AU-TpxcA-iU5OvuD2FLz'.<br>Requires the 'Administer Quality Gates' permission.",
  5915. "since": "4.3",
  5916. "internal": false,
  5917. "post": true,
  5918. "hasResponseExample": false,
  5919. "changelog": [],
  5920. "params": [
  5921. {
  5922. "key": "gateId",
  5923. "description": "Quality gate id",
  5924. "required": true,
  5925. "internal": false,
  5926. "exampleValue": "1"
  5927. },
  5928. {
  5929. "key": "projectId",
  5930. "description": "Project id. Project id as an numeric value is deprecated since 6.1",
  5931. "required": false,
  5932. "internal": false,
  5933. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  5934. },
  5935. {
  5936. "key": "projectKey",
  5937. "description": "Project key",
  5938. "since": "6.1",
  5939. "required": false,
  5940. "internal": false,
  5941. "exampleValue": "my_project"
  5942. }
  5943. ]
  5944. },
  5945. {
  5946. "key": "set_as_default",
  5947. "description": "Set a quality gate as the default quality gate.<br>Requires the 'Administer Quality Gates' permission.",
  5948. "since": "4.3",
  5949. "internal": false,
  5950. "post": true,
  5951. "hasResponseExample": false,
  5952. "changelog": [],
  5953. "params": [
  5954. {
  5955. "key": "id",
  5956. "description": "ID of the quality gate to set as default",
  5957. "required": true,
  5958. "internal": false,
  5959. "exampleValue": "1"
  5960. }
  5961. ]
  5962. },
  5963. {
  5964. "key": "show",
  5965. "description": "Display the details of a quality gate",
  5966. "since": "4.3",
  5967. "internal": false,
  5968. "post": false,
  5969. "hasResponseExample": true,
  5970. "changelog": [],
  5971. "params": [
  5972. {
  5973. "key": "id",
  5974. "description": "ID of the quality gate. Either id or name must be set",
  5975. "required": false,
  5976. "internal": false,
  5977. "exampleValue": "1"
  5978. },
  5979. {
  5980. "key": "name",
  5981. "description": "Name of the quality gate. Either id or name must be set",
  5982. "required": false,
  5983. "internal": false,
  5984. "exampleValue": "My Quality Gate"
  5985. }
  5986. ]
  5987. },
  5988. {
  5989. "key": "update_condition",
  5990. "description": "Update a condition attached to a quality gate.<br>Requires the 'Administer Quality Gates' permission.",
  5991. "since": "4.3",
  5992. "internal": false,
  5993. "post": true,
  5994. "hasResponseExample": false,
  5995. "changelog": [],
  5996. "params": [
  5997. {
  5998. "key": "error",
  5999. "description": "Condition error threshold",
  6000. "required": false,
  6001. "internal": false,
  6002. "exampleValue": "10",
  6003. "maximumLength": 64
  6004. },
  6005. {
  6006. "key": "id",
  6007. "description": "Condition ID",
  6008. "required": true,
  6009. "internal": false,
  6010. "exampleValue": "10"
  6011. },
  6012. {
  6013. "key": "metric",
  6014. "description": "Condition metric",
  6015. "required": true,
  6016. "internal": false,
  6017. "exampleValue": "blocker_violations"
  6018. },
  6019. {
  6020. "key": "op",
  6021. "description": "Condition operator:<br/><ul><li>EQ = equals</li><li>NE = is not</li><li>LT = is lower than</li><li>GT = is greater than</li></ui>",
  6022. "required": false,
  6023. "internal": false,
  6024. "exampleValue": "EQ",
  6025. "possibleValues": [
  6026. "LT",
  6027. "GT",
  6028. "EQ",
  6029. "NE"
  6030. ]
  6031. },
  6032. {
  6033. "key": "period",
  6034. "description": "Condition period. If not set, the absolute value is considered.",
  6035. "required": false,
  6036. "internal": false,
  6037. "possibleValues": [
  6038. "1"
  6039. ]
  6040. },
  6041. {
  6042. "key": "warning",
  6043. "description": "Condition warning threshold",
  6044. "required": false,
  6045. "internal": false,
  6046. "exampleValue": "5",
  6047. "maximumLength": 64
  6048. }
  6049. ]
  6050. }
  6051. ]
  6052. },
  6053. {
  6054. "path": "api/qualityprofiles",
  6055. "since": "4.4",
  6056. "description": "Manage quality profiles.",
  6057. "actions": [
  6058. {
  6059. "key": "activate_rule",
  6060. "description": "Activate a rule on a Quality Profile.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6061. "since": "4.4",
  6062. "internal": false,
  6063. "post": true,
  6064. "hasResponseExample": false,
  6065. "changelog": [],
  6066. "params": [
  6067. {
  6068. "key": "key",
  6069. "description": "Quality Profile key. Can be obtained through <code>api/qualityprofiles/search</code>",
  6070. "required": true,
  6071. "internal": false,
  6072. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6073. "deprecatedKey": "profile_key",
  6074. "deprecatedKeySince": "6.5"
  6075. },
  6076. {
  6077. "key": "params",
  6078. "description": "Parameters as semi-colon list of <code>key=value</code>. Ignored if parameter reset is true.",
  6079. "required": false,
  6080. "internal": false,
  6081. "exampleValue": "params=key1=v1;key2=v2"
  6082. },
  6083. {
  6084. "key": "reset",
  6085. "description": "Reset severity and parameters of activated rule. Set the values defined on parent profile or from rule default values.",
  6086. "required": false,
  6087. "internal": false,
  6088. "possibleValues": [
  6089. "true",
  6090. "false",
  6091. "yes",
  6092. "no"
  6093. ]
  6094. },
  6095. {
  6096. "key": "rule",
  6097. "description": "Rule key",
  6098. "required": true,
  6099. "internal": false,
  6100. "exampleValue": "squid:AvoidCycles",
  6101. "deprecatedKey": "rule_key",
  6102. "deprecatedKeySince": "6.5"
  6103. },
  6104. {
  6105. "key": "severity",
  6106. "description": "Severity. Ignored if parameter reset is true.",
  6107. "required": false,
  6108. "internal": false,
  6109. "possibleValues": [
  6110. "INFO",
  6111. "MINOR",
  6112. "MAJOR",
  6113. "CRITICAL",
  6114. "BLOCKER"
  6115. ]
  6116. }
  6117. ]
  6118. },
  6119. {
  6120. "key": "activate_rules",
  6121. "description": "Bulk-activate rules on one quality profile.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6122. "since": "4.4",
  6123. "internal": false,
  6124. "post": true,
  6125. "hasResponseExample": false,
  6126. "changelog": [],
  6127. "params": [
  6128. {
  6129. "key": "activation",
  6130. "description": "Filter rules that are activated or deactivated on the selected Quality profile. Ignored if the parameter 'qprofile' is not set.",
  6131. "required": false,
  6132. "internal": false,
  6133. "possibleValues": [
  6134. "true",
  6135. "false",
  6136. "yes",
  6137. "no"
  6138. ]
  6139. },
  6140. {
  6141. "key": "active_severities",
  6142. "description": "Comma-separated list of activation severities, i.e the severity of rules in Quality profiles.",
  6143. "required": false,
  6144. "internal": false,
  6145. "exampleValue": "CRITICAL,BLOCKER",
  6146. "possibleValues": [
  6147. "INFO",
  6148. "MINOR",
  6149. "MAJOR",
  6150. "CRITICAL",
  6151. "BLOCKER"
  6152. ]
  6153. },
  6154. {
  6155. "key": "asc",
  6156. "description": "Ascending sort",
  6157. "required": false,
  6158. "internal": false,
  6159. "defaultValue": "true",
  6160. "possibleValues": [
  6161. "true",
  6162. "false",
  6163. "yes",
  6164. "no"
  6165. ]
  6166. },
  6167. {
  6168. "key": "available_since",
  6169. "description": "Filters rules added since date. Format is yyyy-MM-dd",
  6170. "required": false,
  6171. "internal": false,
  6172. "exampleValue": "2014-06-22"
  6173. },
  6174. {
  6175. "key": "compareToProfile",
  6176. "description": "Quality profile key to filter rules that are activated. Meant to compare easily to profile set in 'qprofile'",
  6177. "since": "6.5",
  6178. "required": false,
  6179. "internal": true,
  6180. "exampleValue": "AU-TpxcA-iU5OvuD2FLz"
  6181. },
  6182. {
  6183. "key": "inheritance",
  6184. "description": "Comma-separated list of values of inheritance for a rule within a quality profile. Used only if the parameter 'activation' is set.",
  6185. "required": false,
  6186. "internal": false,
  6187. "exampleValue": "INHERITED,OVERRIDES",
  6188. "possibleValues": [
  6189. "NONE",
  6190. "INHERITED",
  6191. "OVERRIDES"
  6192. ]
  6193. },
  6194. {
  6195. "key": "is_template",
  6196. "description": "Filter template rules",
  6197. "required": false,
  6198. "internal": false,
  6199. "possibleValues": [
  6200. "true",
  6201. "false",
  6202. "yes",
  6203. "no"
  6204. ]
  6205. },
  6206. {
  6207. "key": "languages",
  6208. "description": "Comma-separated list of languages",
  6209. "required": false,
  6210. "internal": false,
  6211. "exampleValue": "java,js"
  6212. },
  6213. {
  6214. "key": "organization",
  6215. "description": "Organization key",
  6216. "since": "6.4",
  6217. "required": false,
  6218. "internal": true,
  6219. "exampleValue": "my-org"
  6220. },
  6221. {
  6222. "key": "q",
  6223. "description": "UTF-8 search query",
  6224. "required": false,
  6225. "internal": false,
  6226. "exampleValue": "xpath"
  6227. },
  6228. {
  6229. "key": "qprofile",
  6230. "description": "Quality profile key to filter on. Used only if the parameter 'activation' is set.",
  6231. "required": false,
  6232. "internal": false,
  6233. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  6234. },
  6235. {
  6236. "key": "repositories",
  6237. "description": "Comma-separated list of repositories",
  6238. "required": false,
  6239. "internal": false,
  6240. "exampleValue": "checkstyle,findbugs"
  6241. },
  6242. {
  6243. "key": "rule_key",
  6244. "description": "Key of rule to search for",
  6245. "required": false,
  6246. "internal": false,
  6247. "exampleValue": "squid:S001"
  6248. },
  6249. {
  6250. "key": "s",
  6251. "description": "Sort field",
  6252. "required": false,
  6253. "internal": false,
  6254. "exampleValue": "name",
  6255. "possibleValues": [
  6256. "name",
  6257. "updatedAt",
  6258. "createdAt",
  6259. "key"
  6260. ]
  6261. },
  6262. {
  6263. "key": "severities",
  6264. "description": "Comma-separated list of default severities. Not the same than severity of rules in Quality profiles.",
  6265. "required": false,
  6266. "internal": false,
  6267. "exampleValue": "CRITICAL,BLOCKER",
  6268. "possibleValues": [
  6269. "INFO",
  6270. "MINOR",
  6271. "MAJOR",
  6272. "CRITICAL",
  6273. "BLOCKER"
  6274. ]
  6275. },
  6276. {
  6277. "key": "statuses",
  6278. "description": "Comma-separated list of status codes",
  6279. "required": false,
  6280. "internal": false,
  6281. "exampleValue": "READY",
  6282. "possibleValues": [
  6283. "BETA",
  6284. "DEPRECATED",
  6285. "READY",
  6286. "REMOVED"
  6287. ]
  6288. },
  6289. {
  6290. "key": "tags",
  6291. "description": "Comma-separated list of tags. Returned rules match any of the tags (OR operator)",
  6292. "required": false,
  6293. "internal": false,
  6294. "exampleValue": "security,java8"
  6295. },
  6296. {
  6297. "key": "targetKey",
  6298. "description": "Quality Profile key on which the rule activation is done. To retrieve a quality profile key please see <code>api/qualityprofiles/search</code>",
  6299. "required": true,
  6300. "internal": false,
  6301. "exampleValue": "AU-TpxcA-iU5OvuD2FL0",
  6302. "deprecatedKey": "profile_key",
  6303. "deprecatedKeySince": "6.5"
  6304. },
  6305. {
  6306. "key": "targetSeverity",
  6307. "description": "Severity to set on the activated rules",
  6308. "required": false,
  6309. "internal": false,
  6310. "deprecatedKey": "activation_severity",
  6311. "deprecatedKeySince": "6.5",
  6312. "possibleValues": [
  6313. "INFO",
  6314. "MINOR",
  6315. "MAJOR",
  6316. "CRITICAL",
  6317. "BLOCKER"
  6318. ]
  6319. },
  6320. {
  6321. "key": "template_key",
  6322. "description": "Key of the template rule to filter on. Used to search for the custom rules based on this template.",
  6323. "required": false,
  6324. "internal": false,
  6325. "exampleValue": "java:S001"
  6326. },
  6327. {
  6328. "key": "types",
  6329. "description": "Comma-separated list of types. Returned rules match any of the tags (OR operator)",
  6330. "since": "5.5",
  6331. "required": false,
  6332. "internal": false,
  6333. "exampleValue": "BUG",
  6334. "possibleValues": [
  6335. "CODE_SMELL",
  6336. "BUG",
  6337. "VULNERABILITY"
  6338. ]
  6339. }
  6340. ]
  6341. },
  6342. {
  6343. "key": "add_group",
  6344. "description": "Allow a group to edit a Quality Profile.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6345. "since": "6.6",
  6346. "internal": true,
  6347. "post": true,
  6348. "hasResponseExample": false,
  6349. "changelog": [],
  6350. "params": [
  6351. {
  6352. "key": "group",
  6353. "description": "Group name",
  6354. "required": true,
  6355. "internal": false,
  6356. "exampleValue": "sonar-administrators"
  6357. },
  6358. {
  6359. "key": "language",
  6360. "description": "Quality profile language",
  6361. "required": true,
  6362. "internal": false
  6363. },
  6364. {
  6365. "key": "organization",
  6366. "description": "Organization key. If no organization is provided, the default organization is used.",
  6367. "required": false,
  6368. "internal": true,
  6369. "exampleValue": "my-org"
  6370. },
  6371. {
  6372. "key": "qualityProfile",
  6373. "description": "Quality Profile name",
  6374. "required": true,
  6375. "internal": false,
  6376. "exampleValue": "Recommended quality profile"
  6377. }
  6378. ]
  6379. },
  6380. {
  6381. "key": "add_project",
  6382. "description": "Associate a project with a quality profile.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li> <li>Administer right on the specified project</li></ul>",
  6383. "since": "5.2",
  6384. "internal": false,
  6385. "post": true,
  6386. "hasResponseExample": false,
  6387. "changelog": [],
  6388. "params": [
  6389. {
  6390. "key": "key",
  6391. "description": "Quality profile key",
  6392. "required": false,
  6393. "internal": false,
  6394. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6395. "deprecatedSince": "6.6",
  6396. "deprecatedKey": "profileKey",
  6397. "deprecatedKeySince": "6.5"
  6398. },
  6399. {
  6400. "key": "language",
  6401. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6402. "required": false,
  6403. "internal": false
  6404. },
  6405. {
  6406. "key": "organization",
  6407. "description": "Organization key. If no organization is provided, the default organization is used.",
  6408. "since": "6.4",
  6409. "required": false,
  6410. "internal": true,
  6411. "exampleValue": "my-org"
  6412. },
  6413. {
  6414. "key": "project",
  6415. "description": "Project key",
  6416. "required": false,
  6417. "internal": false,
  6418. "exampleValue": "my_project",
  6419. "deprecatedKey": "projectKey",
  6420. "deprecatedKeySince": "6.5"
  6421. },
  6422. {
  6423. "key": "projectUuid",
  6424. "description": "Project ID. Either this parameter or 'project' must be set.",
  6425. "required": false,
  6426. "internal": false,
  6427. "exampleValue": "AU-TpxcA-iU5OvuD2FL5",
  6428. "deprecatedSince": "6.5"
  6429. },
  6430. {
  6431. "key": "qualityProfile",
  6432. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6433. "required": false,
  6434. "internal": false,
  6435. "exampleValue": "Sonar way",
  6436. "deprecatedKey": "profileName",
  6437. "deprecatedKeySince": "6.6"
  6438. }
  6439. ]
  6440. },
  6441. {
  6442. "key": "add_user",
  6443. "description": "Allow a user to edit a Quality Profile.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6444. "since": "6.6",
  6445. "internal": true,
  6446. "post": true,
  6447. "hasResponseExample": false,
  6448. "changelog": [],
  6449. "params": [
  6450. {
  6451. "key": "language",
  6452. "description": "Quality profile language",
  6453. "required": true,
  6454. "internal": false
  6455. },
  6456. {
  6457. "key": "login",
  6458. "description": "User login",
  6459. "required": true,
  6460. "internal": false,
  6461. "exampleValue": "john.doe"
  6462. },
  6463. {
  6464. "key": "organization",
  6465. "description": "Organization key. If no organization is provided, the default organization is used.",
  6466. "required": false,
  6467. "internal": true,
  6468. "exampleValue": "my-org"
  6469. },
  6470. {
  6471. "key": "qualityProfile",
  6472. "description": "Quality Profile name",
  6473. "required": true,
  6474. "internal": false,
  6475. "exampleValue": "Recommended quality profile"
  6476. }
  6477. ]
  6478. },
  6479. {
  6480. "key": "backup",
  6481. "description": "Backup a quality profile in XML form. The exported profile can be restored through api/qualityprofiles/restore.",
  6482. "since": "5.2",
  6483. "internal": false,
  6484. "post": false,
  6485. "hasResponseExample": true,
  6486. "changelog": [],
  6487. "params": [
  6488. {
  6489. "key": "key",
  6490. "description": "Quality profile key",
  6491. "required": false,
  6492. "internal": false,
  6493. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6494. "deprecatedSince": "6.6",
  6495. "deprecatedKey": "profileKey",
  6496. "deprecatedKeySince": "6.5"
  6497. },
  6498. {
  6499. "key": "language",
  6500. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6501. "required": false,
  6502. "internal": false
  6503. },
  6504. {
  6505. "key": "organization",
  6506. "description": "Organization key. If no organization is provided, the default organization is used.",
  6507. "since": "6.4",
  6508. "required": false,
  6509. "internal": true,
  6510. "exampleValue": "my-org"
  6511. },
  6512. {
  6513. "key": "qualityProfile",
  6514. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6515. "required": false,
  6516. "internal": false,
  6517. "exampleValue": "Sonar way",
  6518. "deprecatedKey": "profileName",
  6519. "deprecatedKeySince": "6.6"
  6520. }
  6521. ]
  6522. },
  6523. {
  6524. "key": "change_parent",
  6525. "description": "Change a quality profile's parent.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6526. "since": "5.2",
  6527. "internal": false,
  6528. "post": true,
  6529. "hasResponseExample": false,
  6530. "changelog": [],
  6531. "params": [
  6532. {
  6533. "key": "key",
  6534. "description": "Quality profile key",
  6535. "required": false,
  6536. "internal": false,
  6537. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6538. "deprecatedSince": "6.6",
  6539. "deprecatedKey": "profileKey",
  6540. "deprecatedKeySince": "6.5"
  6541. },
  6542. {
  6543. "key": "language",
  6544. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6545. "required": false,
  6546. "internal": false
  6547. },
  6548. {
  6549. "key": "organization",
  6550. "description": "Organization key. If no organization is provided, the default organization is used.",
  6551. "since": "6.4",
  6552. "required": false,
  6553. "internal": true,
  6554. "exampleValue": "my-org"
  6555. },
  6556. {
  6557. "key": "parentKey",
  6558. "description": "New parent profile key.<br> If no profile is provided, the inheritance link with current parent profile (if any) is broken, which deactivates all rules which come from the parent and are not overridden.",
  6559. "required": false,
  6560. "internal": false,
  6561. "exampleValue": "AU-TpxcA-iU5OvuD2FLz",
  6562. "deprecatedSince": "6.6"
  6563. },
  6564. {
  6565. "key": "parentQualityProfile",
  6566. "description": "Quality profile name. If this parameter is set, 'parentKey' must not be set and 'language' must be set to disambiguate.",
  6567. "required": false,
  6568. "internal": false,
  6569. "exampleValue": "Sonar way"
  6570. },
  6571. {
  6572. "key": "qualityProfile",
  6573. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6574. "required": false,
  6575. "internal": false,
  6576. "exampleValue": "Sonar way",
  6577. "deprecatedKey": "profileName",
  6578. "deprecatedKeySince": "6.6"
  6579. }
  6580. ]
  6581. },
  6582. {
  6583. "key": "changelog",
  6584. "description": "Get the history of changes on a quality profile: rule activation/deactivation, change in parameters/severity. Events are ordered by date in descending order (most recent first).",
  6585. "since": "5.2",
  6586. "internal": false,
  6587. "post": false,
  6588. "hasResponseExample": true,
  6589. "changelog": [],
  6590. "params": [
  6591. {
  6592. "key": "key",
  6593. "description": "Quality profile key",
  6594. "required": false,
  6595. "internal": false,
  6596. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6597. "deprecatedSince": "6.6",
  6598. "deprecatedKey": "profileKey",
  6599. "deprecatedKeySince": "6.5"
  6600. },
  6601. {
  6602. "key": "language",
  6603. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6604. "required": false,
  6605. "internal": false
  6606. },
  6607. {
  6608. "key": "organization",
  6609. "description": "Organization key. If no organization is provided, the default organization is used.",
  6610. "since": "6.4",
  6611. "required": false,
  6612. "internal": true,
  6613. "exampleValue": "my-org"
  6614. },
  6615. {
  6616. "key": "p",
  6617. "description": "1-based page number",
  6618. "required": false,
  6619. "internal": false,
  6620. "defaultValue": "1",
  6621. "exampleValue": "42",
  6622. "deprecatedKey": "pageIndex",
  6623. "deprecatedKeySince": "5.2"
  6624. },
  6625. {
  6626. "key": "ps",
  6627. "description": "Page size. Must be greater than 0 and less than 500",
  6628. "required": false,
  6629. "internal": false,
  6630. "defaultValue": "50",
  6631. "exampleValue": "20",
  6632. "deprecatedKey": "pageSize",
  6633. "deprecatedKeySince": "5.2",
  6634. "maximumValue": 500
  6635. },
  6636. {
  6637. "key": "qualityProfile",
  6638. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  6639. "required": false,
  6640. "internal": false,
  6641. "exampleValue": "Sonar way",
  6642. "deprecatedKey": "profileName",
  6643. "deprecatedKeySince": "6.6"
  6644. },
  6645. {
  6646. "key": "since",
  6647. "description": "Start date for the changelog. <br>Either a date (server timezone) or datetime can be provided.",
  6648. "required": false,
  6649. "internal": false,
  6650. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  6651. },
  6652. {
  6653. "key": "to",
  6654. "description": "End date for the changelog. <br>Either a date (server timezone) or datetime can be provided.",
  6655. "required": false,
  6656. "internal": false,
  6657. "exampleValue": "2017-10-19 or 2017-10-19T13:00:00+0200"
  6658. }
  6659. ]
  6660. },
  6661. {
  6662. "key": "compare",
  6663. "description": "Compare two quality profiles.",
  6664. "since": "5.2",
  6665. "internal": true,
  6666. "post": false,
  6667. "hasResponseExample": true,
  6668. "changelog": [],
  6669. "params": [
  6670. {
  6671. "key": "leftKey",
  6672. "description": "Profile key.",
  6673. "required": true,
  6674. "internal": false,
  6675. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  6676. },
  6677. {
  6678. "key": "rightKey",
  6679. "description": "Another profile key.",
  6680. "required": true,
  6681. "internal": false,
  6682. "exampleValue": "AU-TpxcA-iU5OvuD2FLz"
  6683. }
  6684. ]
  6685. },
  6686. {
  6687. "key": "copy",
  6688. "description": "Copy a quality profile.<br> Requires to be logged in and the 'Administer Quality Profiles' permission.",
  6689. "since": "5.2",
  6690. "internal": false,
  6691. "post": true,
  6692. "hasResponseExample": false,
  6693. "changelog": [],
  6694. "params": [
  6695. {
  6696. "key": "fromKey",
  6697. "description": "Quality profile key",
  6698. "required": true,
  6699. "internal": false,
  6700. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  6701. },
  6702. {
  6703. "key": "toName",
  6704. "description": "Name for the new quality profile.",
  6705. "required": true,
  6706. "internal": false,
  6707. "exampleValue": "My Sonar way"
  6708. }
  6709. ]
  6710. },
  6711. {
  6712. "key": "create",
  6713. "description": "Create a quality profile.<br>Requires to be logged in and the 'Administer Quality Profiles' permission.",
  6714. "since": "5.2",
  6715. "internal": false,
  6716. "post": true,
  6717. "hasResponseExample": true,
  6718. "changelog": [],
  6719. "params": [
  6720. {
  6721. "key": "language",
  6722. "description": "Quality profile language",
  6723. "required": true,
  6724. "internal": false,
  6725. "exampleValue": "js"
  6726. },
  6727. {
  6728. "key": "name",
  6729. "description": "Quality profile name",
  6730. "required": true,
  6731. "internal": false,
  6732. "exampleValue": "My Sonar way",
  6733. "deprecatedKey": "profileName",
  6734. "deprecatedKeySince": "6.6",
  6735. "maximumLength": 100
  6736. },
  6737. {
  6738. "key": "organization",
  6739. "description": "Organization key. If no organization is provided, the default organization is used.",
  6740. "since": "6.4",
  6741. "required": false,
  6742. "internal": true,
  6743. "exampleValue": "my-org"
  6744. }
  6745. ]
  6746. },
  6747. {
  6748. "key": "deactivate_rule",
  6749. "description": "Deactivate a rule on a quality profile.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6750. "since": "4.4",
  6751. "internal": false,
  6752. "post": true,
  6753. "hasResponseExample": false,
  6754. "changelog": [],
  6755. "params": [
  6756. {
  6757. "key": "key",
  6758. "description": "Quality Profile key. Can be obtained through <code>api/qualityprofiles/search</code>",
  6759. "required": true,
  6760. "internal": false,
  6761. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6762. "deprecatedKey": "profile_key",
  6763. "deprecatedKeySince": "6.5"
  6764. },
  6765. {
  6766. "key": "rule",
  6767. "description": "Rule key",
  6768. "required": true,
  6769. "internal": false,
  6770. "exampleValue": "squid:AvoidCycles",
  6771. "deprecatedKey": "rule_key",
  6772. "deprecatedKeySince": "6.5"
  6773. }
  6774. ]
  6775. },
  6776. {
  6777. "key": "deactivate_rules",
  6778. "description": "Bulk deactivate rules on Quality profiles.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6779. "since": "4.4",
  6780. "internal": false,
  6781. "post": true,
  6782. "hasResponseExample": false,
  6783. "changelog": [],
  6784. "params": [
  6785. {
  6786. "key": "activation",
  6787. "description": "Filter rules that are activated or deactivated on the selected Quality profile. Ignored if the parameter 'qprofile' is not set.",
  6788. "required": false,
  6789. "internal": false,
  6790. "possibleValues": [
  6791. "true",
  6792. "false",
  6793. "yes",
  6794. "no"
  6795. ]
  6796. },
  6797. {
  6798. "key": "active_severities",
  6799. "description": "Comma-separated list of activation severities, i.e the severity of rules in Quality profiles.",
  6800. "required": false,
  6801. "internal": false,
  6802. "exampleValue": "CRITICAL,BLOCKER",
  6803. "possibleValues": [
  6804. "INFO",
  6805. "MINOR",
  6806. "MAJOR",
  6807. "CRITICAL",
  6808. "BLOCKER"
  6809. ]
  6810. },
  6811. {
  6812. "key": "asc",
  6813. "description": "Ascending sort",
  6814. "required": false,
  6815. "internal": false,
  6816. "defaultValue": "true",
  6817. "possibleValues": [
  6818. "true",
  6819. "false",
  6820. "yes",
  6821. "no"
  6822. ]
  6823. },
  6824. {
  6825. "key": "available_since",
  6826. "description": "Filters rules added since date. Format is yyyy-MM-dd",
  6827. "required": false,
  6828. "internal": false,
  6829. "exampleValue": "2014-06-22"
  6830. },
  6831. {
  6832. "key": "compareToProfile",
  6833. "description": "Quality profile key to filter rules that are activated. Meant to compare easily to profile set in 'qprofile'",
  6834. "since": "6.5",
  6835. "required": false,
  6836. "internal": true,
  6837. "exampleValue": "AU-TpxcA-iU5OvuD2FLz"
  6838. },
  6839. {
  6840. "key": "inheritance",
  6841. "description": "Comma-separated list of values of inheritance for a rule within a quality profile. Used only if the parameter 'activation' is set.",
  6842. "required": false,
  6843. "internal": false,
  6844. "exampleValue": "INHERITED,OVERRIDES",
  6845. "possibleValues": [
  6846. "NONE",
  6847. "INHERITED",
  6848. "OVERRIDES"
  6849. ]
  6850. },
  6851. {
  6852. "key": "is_template",
  6853. "description": "Filter template rules",
  6854. "required": false,
  6855. "internal": false,
  6856. "possibleValues": [
  6857. "true",
  6858. "false",
  6859. "yes",
  6860. "no"
  6861. ]
  6862. },
  6863. {
  6864. "key": "languages",
  6865. "description": "Comma-separated list of languages",
  6866. "required": false,
  6867. "internal": false,
  6868. "exampleValue": "java,js"
  6869. },
  6870. {
  6871. "key": "organization",
  6872. "description": "Organization key",
  6873. "since": "6.4",
  6874. "required": false,
  6875. "internal": true,
  6876. "exampleValue": "my-org"
  6877. },
  6878. {
  6879. "key": "q",
  6880. "description": "UTF-8 search query",
  6881. "required": false,
  6882. "internal": false,
  6883. "exampleValue": "xpath"
  6884. },
  6885. {
  6886. "key": "qprofile",
  6887. "description": "Quality profile key to filter on. Used only if the parameter 'activation' is set.",
  6888. "required": false,
  6889. "internal": false,
  6890. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  6891. },
  6892. {
  6893. "key": "repositories",
  6894. "description": "Comma-separated list of repositories",
  6895. "required": false,
  6896. "internal": false,
  6897. "exampleValue": "checkstyle,findbugs"
  6898. },
  6899. {
  6900. "key": "rule_key",
  6901. "description": "Key of rule to search for",
  6902. "required": false,
  6903. "internal": false,
  6904. "exampleValue": "squid:S001"
  6905. },
  6906. {
  6907. "key": "s",
  6908. "description": "Sort field",
  6909. "required": false,
  6910. "internal": false,
  6911. "exampleValue": "name",
  6912. "possibleValues": [
  6913. "name",
  6914. "updatedAt",
  6915. "createdAt",
  6916. "key"
  6917. ]
  6918. },
  6919. {
  6920. "key": "severities",
  6921. "description": "Comma-separated list of default severities. Not the same than severity of rules in Quality profiles.",
  6922. "required": false,
  6923. "internal": false,
  6924. "exampleValue": "CRITICAL,BLOCKER",
  6925. "possibleValues": [
  6926. "INFO",
  6927. "MINOR",
  6928. "MAJOR",
  6929. "CRITICAL",
  6930. "BLOCKER"
  6931. ]
  6932. },
  6933. {
  6934. "key": "statuses",
  6935. "description": "Comma-separated list of status codes",
  6936. "required": false,
  6937. "internal": false,
  6938. "exampleValue": "READY",
  6939. "possibleValues": [
  6940. "BETA",
  6941. "DEPRECATED",
  6942. "READY",
  6943. "REMOVED"
  6944. ]
  6945. },
  6946. {
  6947. "key": "tags",
  6948. "description": "Comma-separated list of tags. Returned rules match any of the tags (OR operator)",
  6949. "required": false,
  6950. "internal": false,
  6951. "exampleValue": "security,java8"
  6952. },
  6953. {
  6954. "key": "targetKey",
  6955. "description": "Quality Profile key on which the rule deactivation is done. To retrieve a profile key please see <code>api/qualityprofiles/search</code>",
  6956. "required": true,
  6957. "internal": false,
  6958. "exampleValue": "AU-TpxcA-iU5OvuD2FL1",
  6959. "deprecatedKey": "profile_key",
  6960. "deprecatedKeySince": "6.5"
  6961. },
  6962. {
  6963. "key": "template_key",
  6964. "description": "Key of the template rule to filter on. Used to search for the custom rules based on this template.",
  6965. "required": false,
  6966. "internal": false,
  6967. "exampleValue": "java:S001"
  6968. },
  6969. {
  6970. "key": "types",
  6971. "description": "Comma-separated list of types. Returned rules match any of the tags (OR operator)",
  6972. "since": "5.5",
  6973. "required": false,
  6974. "internal": false,
  6975. "exampleValue": "BUG",
  6976. "possibleValues": [
  6977. "CODE_SMELL",
  6978. "BUG",
  6979. "VULNERABILITY"
  6980. ]
  6981. }
  6982. ]
  6983. },
  6984. {
  6985. "key": "delete",
  6986. "description": "Delete a quality profile and all its descendants. The default quality profile cannot be deleted.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  6987. "since": "5.2",
  6988. "internal": false,
  6989. "post": true,
  6990. "hasResponseExample": false,
  6991. "changelog": [],
  6992. "params": [
  6993. {
  6994. "key": "key",
  6995. "description": "Quality profile key",
  6996. "required": false,
  6997. "internal": false,
  6998. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  6999. "deprecatedSince": "6.6",
  7000. "deprecatedKey": "profileKey",
  7001. "deprecatedKeySince": "6.5"
  7002. },
  7003. {
  7004. "key": "language",
  7005. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7006. "required": false,
  7007. "internal": false
  7008. },
  7009. {
  7010. "key": "organization",
  7011. "description": "Organization key. If no organization is provided, the default organization is used.",
  7012. "since": "6.4",
  7013. "required": false,
  7014. "internal": true,
  7015. "exampleValue": "my-org"
  7016. },
  7017. {
  7018. "key": "qualityProfile",
  7019. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7020. "required": false,
  7021. "internal": false,
  7022. "exampleValue": "Sonar way",
  7023. "deprecatedKey": "profileName",
  7024. "deprecatedKeySince": "6.6"
  7025. }
  7026. ]
  7027. },
  7028. {
  7029. "key": "export",
  7030. "description": "Export a quality profile.",
  7031. "since": "5.2",
  7032. "internal": false,
  7033. "post": false,
  7034. "hasResponseExample": true,
  7035. "changelog": [],
  7036. "params": [
  7037. {
  7038. "key": "key",
  7039. "description": "Quality profile key",
  7040. "since": "6.5",
  7041. "required": false,
  7042. "internal": false,
  7043. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  7044. "deprecatedSince": "6.6"
  7045. },
  7046. {
  7047. "key": "language",
  7048. "description": "Quality profile language. If this parameter is set, 'key' must not be set.",
  7049. "required": false,
  7050. "internal": false,
  7051. "exampleValue": ""
  7052. },
  7053. {
  7054. "key": "organization",
  7055. "description": "Organization key. If no organization is provided, the default organization is used.",
  7056. "since": "6.4",
  7057. "required": false,
  7058. "internal": true,
  7059. "exampleValue": "my-org"
  7060. },
  7061. {
  7062. "key": "qualityProfile",
  7063. "description": "Quality profile name to export. If left empty, the default profile for the language is exported. If this parameter is set, 'key' must not be set.",
  7064. "required": false,
  7065. "internal": false,
  7066. "exampleValue": "My Sonar way",
  7067. "deprecatedKey": "profileName",
  7068. "deprecatedKeySince": "6.6"
  7069. }
  7070. ]
  7071. },
  7072. {
  7073. "key": "exporters",
  7074. "description": "Lists available profile export formats.",
  7075. "since": "5.2",
  7076. "internal": false,
  7077. "post": false,
  7078. "hasResponseExample": true,
  7079. "changelog": []
  7080. },
  7081. {
  7082. "key": "importers",
  7083. "description": "List supported importers.",
  7084. "since": "5.2",
  7085. "internal": false,
  7086. "post": false,
  7087. "hasResponseExample": true,
  7088. "changelog": []
  7089. },
  7090. {
  7091. "key": "inheritance",
  7092. "description": "Show a quality profile's ancestors and children.",
  7093. "since": "5.2",
  7094. "internal": false,
  7095. "post": false,
  7096. "hasResponseExample": true,
  7097. "changelog": [],
  7098. "params": [
  7099. {
  7100. "key": "key",
  7101. "description": "Quality profile key",
  7102. "required": false,
  7103. "internal": false,
  7104. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  7105. "deprecatedSince": "6.6",
  7106. "deprecatedKey": "profileKey",
  7107. "deprecatedKeySince": "6.5"
  7108. },
  7109. {
  7110. "key": "language",
  7111. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7112. "required": false,
  7113. "internal": false
  7114. },
  7115. {
  7116. "key": "organization",
  7117. "description": "Organization key. If no organization is provided, the default organization is used.",
  7118. "since": "6.4",
  7119. "required": false,
  7120. "internal": true,
  7121. "exampleValue": "my-org"
  7122. },
  7123. {
  7124. "key": "qualityProfile",
  7125. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7126. "required": false,
  7127. "internal": false,
  7128. "exampleValue": "Sonar way",
  7129. "deprecatedKey": "profileName",
  7130. "deprecatedKeySince": "6.6"
  7131. }
  7132. ]
  7133. },
  7134. {
  7135. "key": "projects",
  7136. "description": "List projects with their association status regarding a quality profile",
  7137. "since": "5.2",
  7138. "internal": false,
  7139. "post": false,
  7140. "hasResponseExample": true,
  7141. "changelog": [
  7142. {
  7143. "description": "'id' response field is deprecated",
  7144. "version": "6.5"
  7145. },
  7146. {
  7147. "description": "'uuid' response field is deprecated and replaced by 'id'",
  7148. "version": "6.0"
  7149. },
  7150. {
  7151. "description": "'key' response field has been added to return the project key",
  7152. "version": "6.0"
  7153. }
  7154. ],
  7155. "params": [
  7156. {
  7157. "key": "key",
  7158. "description": "Quality profile key",
  7159. "required": true,
  7160. "internal": false,
  7161. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  7162. },
  7163. {
  7164. "key": "p",
  7165. "description": "1-based page number",
  7166. "required": false,
  7167. "internal": false,
  7168. "defaultValue": "1",
  7169. "exampleValue": "42",
  7170. "deprecatedKey": "page",
  7171. "deprecatedKeySince": "6.5"
  7172. },
  7173. {
  7174. "key": "ps",
  7175. "description": "Page size. Must be greater than 0 and less than 500",
  7176. "required": false,
  7177. "internal": false,
  7178. "defaultValue": "100",
  7179. "exampleValue": "20",
  7180. "deprecatedKey": "pageSize",
  7181. "deprecatedKeySince": "5.2",
  7182. "maximumValue": 500
  7183. },
  7184. {
  7185. "key": "q",
  7186. "description": "Limit search to projects that contain the supplied string.",
  7187. "required": false,
  7188. "internal": false,
  7189. "exampleValue": "sonar",
  7190. "deprecatedKey": "query",
  7191. "deprecatedKeySince": "6.5"
  7192. },
  7193. {
  7194. "key": "selected",
  7195. "description": "Depending on the value, show only selected items (selected=selected), deselected items (selected=deselected), or all items with their selection status (selected=all).",
  7196. "required": false,
  7197. "internal": false,
  7198. "defaultValue": "selected",
  7199. "possibleValues": [
  7200. "all",
  7201. "deselected",
  7202. "selected"
  7203. ]
  7204. }
  7205. ]
  7206. },
  7207. {
  7208. "key": "remove_group",
  7209. "description": "Remove the ability from a group to edit a Quality Profile.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  7210. "since": "6.6",
  7211. "internal": true,
  7212. "post": true,
  7213. "hasResponseExample": false,
  7214. "changelog": [],
  7215. "params": [
  7216. {
  7217. "key": "group",
  7218. "description": "Group name",
  7219. "required": true,
  7220. "internal": false,
  7221. "exampleValue": "sonar-administrators"
  7222. },
  7223. {
  7224. "key": "language",
  7225. "description": "Quality profile language",
  7226. "required": true,
  7227. "internal": false
  7228. },
  7229. {
  7230. "key": "organization",
  7231. "description": "Organization key. If no organization is provided, the default organization is used.",
  7232. "required": false,
  7233. "internal": true,
  7234. "exampleValue": "my-org"
  7235. },
  7236. {
  7237. "key": "qualityProfile",
  7238. "description": "Quality Profile name",
  7239. "required": true,
  7240. "internal": false,
  7241. "exampleValue": "Recommended quality profile"
  7242. }
  7243. ]
  7244. },
  7245. {
  7246. "key": "remove_project",
  7247. "description": "Remove a project's association with a quality profile.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li> <li>Administer right on the specified project</li></ul>",
  7248. "since": "5.2",
  7249. "internal": false,
  7250. "post": true,
  7251. "hasResponseExample": false,
  7252. "changelog": [],
  7253. "params": [
  7254. {
  7255. "key": "key",
  7256. "description": "Quality profile key",
  7257. "required": false,
  7258. "internal": false,
  7259. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  7260. "deprecatedSince": "6.6",
  7261. "deprecatedKey": "profileKey",
  7262. "deprecatedKeySince": "6.5"
  7263. },
  7264. {
  7265. "key": "language",
  7266. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7267. "required": false,
  7268. "internal": false
  7269. },
  7270. {
  7271. "key": "organization",
  7272. "description": "Organization key. If no organization is provided, the default organization is used.",
  7273. "since": "6.4",
  7274. "required": false,
  7275. "internal": true,
  7276. "exampleValue": "my-org"
  7277. },
  7278. {
  7279. "key": "project",
  7280. "description": "Project key",
  7281. "required": false,
  7282. "internal": false,
  7283. "exampleValue": "my_project",
  7284. "deprecatedKey": "projectKey",
  7285. "deprecatedKeySince": "6.5"
  7286. },
  7287. {
  7288. "key": "projectUuid",
  7289. "description": "Project ID. Either this parameter, or 'project' must be set.",
  7290. "required": false,
  7291. "internal": false,
  7292. "exampleValue": "AU-TpxcB-iU5OvuD2FL6",
  7293. "deprecatedSince": "6.5"
  7294. },
  7295. {
  7296. "key": "qualityProfile",
  7297. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7298. "required": false,
  7299. "internal": false,
  7300. "exampleValue": "Sonar way",
  7301. "deprecatedKey": "profileName",
  7302. "deprecatedKeySince": "6.6"
  7303. }
  7304. ]
  7305. },
  7306. {
  7307. "key": "remove_user",
  7308. "description": "Remove the ability from a user to edit a Quality Profile.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  7309. "since": "6.6",
  7310. "internal": true,
  7311. "post": true,
  7312. "hasResponseExample": false,
  7313. "changelog": [],
  7314. "params": [
  7315. {
  7316. "key": "language",
  7317. "description": "Quality profile language",
  7318. "required": true,
  7319. "internal": false
  7320. },
  7321. {
  7322. "key": "login",
  7323. "description": "User login",
  7324. "required": true,
  7325. "internal": false,
  7326. "exampleValue": "john.doe"
  7327. },
  7328. {
  7329. "key": "organization",
  7330. "description": "Organization key. If no organization is provided, the default organization is used.",
  7331. "required": false,
  7332. "internal": true,
  7333. "exampleValue": "my-org"
  7334. },
  7335. {
  7336. "key": "qualityProfile",
  7337. "description": "Quality Profile name",
  7338. "required": true,
  7339. "internal": false,
  7340. "exampleValue": "Recommended quality profile"
  7341. }
  7342. ]
  7343. },
  7344. {
  7345. "key": "rename",
  7346. "description": "Rename a quality profile.<br> Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  7347. "since": "5.2",
  7348. "internal": false,
  7349. "post": true,
  7350. "hasResponseExample": false,
  7351. "changelog": [],
  7352. "params": [
  7353. {
  7354. "key": "key",
  7355. "description": "Quality profile key",
  7356. "required": true,
  7357. "internal": false,
  7358. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  7359. },
  7360. {
  7361. "key": "name",
  7362. "description": "New quality profile name",
  7363. "required": true,
  7364. "internal": false,
  7365. "exampleValue": "My Sonar way",
  7366. "maximumLength": 100
  7367. }
  7368. ]
  7369. },
  7370. {
  7371. "key": "restore",
  7372. "description": "Restore a quality profile using an XML file. The restored profile name is taken from the backup file, so if a profile with the same name and language already exists, it will be overwritten.<br> Requires to be logged in and the 'Administer Quality Profiles' permission.",
  7373. "since": "5.2",
  7374. "internal": false,
  7375. "post": true,
  7376. "hasResponseExample": false,
  7377. "changelog": [],
  7378. "params": [
  7379. {
  7380. "key": "backup",
  7381. "description": "A profile backup file in XML format, as generated by api/qualityprofiles/backup or the former api/profiles/backup.",
  7382. "required": true,
  7383. "internal": false
  7384. },
  7385. {
  7386. "key": "organization",
  7387. "description": "Organization key. If no organization is provided, the default organization is used.",
  7388. "since": "6.4",
  7389. "required": false,
  7390. "internal": true,
  7391. "exampleValue": "my-org"
  7392. }
  7393. ]
  7394. },
  7395. {
  7396. "key": "restore_built_in",
  7397. "description": "This web service has no effect since 6.4. It's no more possible to restore built-in quality profiles because they are automatically updated and read only. Returns HTTP code 410.",
  7398. "since": "4.4",
  7399. "deprecatedSince": "6.4",
  7400. "internal": false,
  7401. "post": true,
  7402. "hasResponseExample": false,
  7403. "changelog": []
  7404. },
  7405. {
  7406. "key": "search",
  7407. "description": "Search quality profiles",
  7408. "since": "5.2",
  7409. "internal": false,
  7410. "post": false,
  7411. "hasResponseExample": true,
  7412. "changelog": [
  7413. {
  7414. "description": "The parameters 'defaults', 'project' and 'language' can be combined without any constraint",
  7415. "version": "6.5"
  7416. }
  7417. ],
  7418. "params": [
  7419. {
  7420. "key": "defaults",
  7421. "description": "If set to true, return only the quality profiles marked as default for each language",
  7422. "required": false,
  7423. "internal": false,
  7424. "defaultValue": "false",
  7425. "possibleValues": [
  7426. "true",
  7427. "false",
  7428. "yes",
  7429. "no"
  7430. ]
  7431. },
  7432. {
  7433. "key": "language",
  7434. "description": "Language key. If provided, only profiles for the given language are returned.",
  7435. "required": false,
  7436. "internal": false
  7437. },
  7438. {
  7439. "key": "organization",
  7440. "description": "Organization key. If no organization is provided, the default organization is used.",
  7441. "since": "6.4",
  7442. "required": false,
  7443. "internal": true,
  7444. "exampleValue": "my-org"
  7445. },
  7446. {
  7447. "key": "project",
  7448. "description": "Project key",
  7449. "required": false,
  7450. "internal": false,
  7451. "exampleValue": "my_project",
  7452. "deprecatedKey": "projectKey",
  7453. "deprecatedKeySince": "6.5"
  7454. },
  7455. {
  7456. "key": "qualityProfile",
  7457. "description": "Quality profile name",
  7458. "required": false,
  7459. "internal": false,
  7460. "exampleValue": "SonarQube Way",
  7461. "deprecatedKey": "profileName",
  7462. "deprecatedKeySince": "6.6"
  7463. }
  7464. ]
  7465. },
  7466. {
  7467. "key": "search_groups",
  7468. "description": "List the groups that are allowed to edit a Quality Profile.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  7469. "since": "6.6",
  7470. "internal": true,
  7471. "post": false,
  7472. "hasResponseExample": true,
  7473. "changelog": [],
  7474. "params": [
  7475. {
  7476. "key": "language",
  7477. "description": "Quality profile language",
  7478. "required": true,
  7479. "internal": false
  7480. },
  7481. {
  7482. "key": "organization",
  7483. "description": "Organization key. If no organization is provided, the default organization is used.",
  7484. "required": false,
  7485. "internal": true,
  7486. "exampleValue": "my-org"
  7487. },
  7488. {
  7489. "key": "p",
  7490. "description": "1-based page number",
  7491. "required": false,
  7492. "internal": false,
  7493. "defaultValue": "1",
  7494. "exampleValue": "42",
  7495. "deprecatedKey": "pageIndex",
  7496. "deprecatedKeySince": "5.2"
  7497. },
  7498. {
  7499. "key": "ps",
  7500. "description": "Page size. Must be greater than 0.",
  7501. "required": false,
  7502. "internal": false,
  7503. "defaultValue": "25",
  7504. "exampleValue": "20",
  7505. "deprecatedKey": "pageSize",
  7506. "deprecatedKeySince": "5.2"
  7507. },
  7508. {
  7509. "key": "q",
  7510. "description": "Limit search to group names that contain the supplied string.",
  7511. "required": false,
  7512. "internal": false,
  7513. "exampleValue": "sonar"
  7514. },
  7515. {
  7516. "key": "qualityProfile",
  7517. "description": "Quality Profile name",
  7518. "required": true,
  7519. "internal": false,
  7520. "exampleValue": "Recommended quality profile"
  7521. },
  7522. {
  7523. "key": "selected",
  7524. "description": "Depending on the value, show only selected items (selected=selected), deselected items (selected=deselected), or all items with their selection status (selected=all).",
  7525. "required": false,
  7526. "internal": false,
  7527. "defaultValue": "selected",
  7528. "possibleValues": [
  7529. "all",
  7530. "deselected",
  7531. "selected"
  7532. ]
  7533. }
  7534. ]
  7535. },
  7536. {
  7537. "key": "search_users",
  7538. "description": "List the users that are allowed to edit a Quality Profile.<br>Requires one of the following permissions:<ul> <li>'Administer Quality Profiles'</li> <li>Edit right on the specified quality profile</li></ul>",
  7539. "since": "6.6",
  7540. "internal": true,
  7541. "post": false,
  7542. "hasResponseExample": true,
  7543. "changelog": [],
  7544. "params": [
  7545. {
  7546. "key": "language",
  7547. "description": "Quality profile language",
  7548. "required": true,
  7549. "internal": false
  7550. },
  7551. {
  7552. "key": "organization",
  7553. "description": "Organization key. If no organization is provided, the default organization is used.",
  7554. "required": false,
  7555. "internal": true,
  7556. "exampleValue": "my-org"
  7557. },
  7558. {
  7559. "key": "p",
  7560. "description": "1-based page number",
  7561. "required": false,
  7562. "internal": false,
  7563. "defaultValue": "1",
  7564. "exampleValue": "42",
  7565. "deprecatedKey": "pageIndex",
  7566. "deprecatedKeySince": "5.2"
  7567. },
  7568. {
  7569. "key": "ps",
  7570. "description": "Page size. Must be greater than 0.",
  7571. "required": false,
  7572. "internal": false,
  7573. "defaultValue": "25",
  7574. "exampleValue": "20",
  7575. "deprecatedKey": "pageSize",
  7576. "deprecatedKeySince": "5.2"
  7577. },
  7578. {
  7579. "key": "q",
  7580. "description": "Limit search to names or logins that contain the supplied string.",
  7581. "required": false,
  7582. "internal": false,
  7583. "exampleValue": "freddy"
  7584. },
  7585. {
  7586. "key": "qualityProfile",
  7587. "description": "Quality Profile name",
  7588. "required": true,
  7589. "internal": false,
  7590. "exampleValue": "Recommended quality profile"
  7591. },
  7592. {
  7593. "key": "selected",
  7594. "description": "Depending on the value, show only selected items (selected=selected), deselected items (selected=deselected), or all items with their selection status (selected=all).",
  7595. "required": false,
  7596. "internal": false,
  7597. "defaultValue": "selected",
  7598. "possibleValues": [
  7599. "all",
  7600. "deselected",
  7601. "selected"
  7602. ]
  7603. }
  7604. ]
  7605. },
  7606. {
  7607. "key": "set_default",
  7608. "description": "Select the default profile for a given language.<br> Requires to be logged in and the 'Administer Quality Profiles' permission.",
  7609. "since": "5.2",
  7610. "internal": false,
  7611. "post": true,
  7612. "hasResponseExample": false,
  7613. "changelog": [],
  7614. "params": [
  7615. {
  7616. "key": "key",
  7617. "description": "Quality profile key",
  7618. "required": false,
  7619. "internal": false,
  7620. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  7621. "deprecatedSince": "6.6",
  7622. "deprecatedKey": "profileKey",
  7623. "deprecatedKeySince": "6.5"
  7624. },
  7625. {
  7626. "key": "language",
  7627. "description": "Quality profile language. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7628. "required": false,
  7629. "internal": false
  7630. },
  7631. {
  7632. "key": "organization",
  7633. "description": "Organization key. If no organization is provided, the default organization is used.",
  7634. "since": "6.4",
  7635. "required": false,
  7636. "internal": true,
  7637. "exampleValue": "my-org"
  7638. },
  7639. {
  7640. "key": "qualityProfile",
  7641. "description": "Quality profile name. If this parameter is set, 'key' must not be set and 'language' must be set to disambiguate.",
  7642. "required": false,
  7643. "internal": false,
  7644. "exampleValue": "Sonar way",
  7645. "deprecatedKey": "profileName",
  7646. "deprecatedKeySince": "6.6"
  7647. }
  7648. ]
  7649. },
  7650. {
  7651. "key": "show",
  7652. "description": "Show a quality profile",
  7653. "since": "6.5",
  7654. "internal": true,
  7655. "post": false,
  7656. "hasResponseExample": true,
  7657. "changelog": [],
  7658. "params": [
  7659. {
  7660. "key": "compareToSonarWay",
  7661. "description": "Add the number of missing rules from the related Sonar way profile in the response",
  7662. "required": false,
  7663. "internal": true,
  7664. "defaultValue": "false",
  7665. "possibleValues": [
  7666. "true",
  7667. "false",
  7668. "yes",
  7669. "no"
  7670. ]
  7671. },
  7672. {
  7673. "key": "key",
  7674. "description": "Quality profile key",
  7675. "required": true,
  7676. "internal": false,
  7677. "exampleValue": "AU-Tpxb--iU5OvuD2FLy",
  7678. "deprecatedKey": "profile",
  7679. "deprecatedKeySince": "6.6"
  7680. }
  7681. ]
  7682. }
  7683. ]
  7684. },
  7685. {
  7686. "path": "api/resources",
  7687. "since": "2.10",
  7688. "description": "Removed since 6.3, please use api/components and api/measures instead",
  7689. "actions": [
  7690. {
  7691. "key": "index",
  7692. "description": "The web service is removed and you're invited to use the alternatives: <ul><li>if you need one component without measures: api/components/show</li><li>if you need one component with measures: api/measures/component</li><li>if you need several components without measures: api/components/tree</li><li>if you need several components with measures: api/measures/component_tree</li></ul>",
  7693. "since": "2.10",
  7694. "deprecatedSince": "5.4",
  7695. "internal": false,
  7696. "post": false,
  7697. "hasResponseExample": true,
  7698. "changelog": []
  7699. }
  7700. ]
  7701. },
  7702. {
  7703. "path": "api/roots",
  7704. "since": "6.2",
  7705. "description": "Manage root users",
  7706. "actions": [
  7707. {
  7708. "key": "search",
  7709. "description": "Search for root users.<br/>Requires to be root.",
  7710. "since": "6.2",
  7711. "internal": true,
  7712. "post": false,
  7713. "hasResponseExample": true,
  7714. "changelog": []
  7715. },
  7716. {
  7717. "key": "set_root",
  7718. "description": "Make the specified user root.<br/>Requires to be root.",
  7719. "since": "6.2",
  7720. "internal": true,
  7721. "post": true,
  7722. "hasResponseExample": false,
  7723. "changelog": [],
  7724. "params": [
  7725. {
  7726. "key": "login",
  7727. "description": "A user login",
  7728. "since": "6.2",
  7729. "required": true,
  7730. "internal": false,
  7731. "exampleValue": "admin"
  7732. }
  7733. ]
  7734. },
  7735. {
  7736. "key": "unset_root",
  7737. "description": "Make the specified user not root.<br/>Requires to be root.",
  7738. "since": "6.2",
  7739. "internal": true,
  7740. "post": true,
  7741. "hasResponseExample": false,
  7742. "changelog": [],
  7743. "params": [
  7744. {
  7745. "key": "login",
  7746. "description": "A user login",
  7747. "since": "6.2",
  7748. "required": true,
  7749. "internal": false,
  7750. "exampleValue": "admin"
  7751. }
  7752. ]
  7753. }
  7754. ]
  7755. },
  7756. {
  7757. "path": "api/rules",
  7758. "description": "Get and update some details of automatic rules, and manage custom rules.",
  7759. "actions": [
  7760. {
  7761. "key": "app",
  7762. "description": "Get data required for rendering the page 'Coding Rules'.",
  7763. "since": "4.5",
  7764. "internal": true,
  7765. "post": false,
  7766. "hasResponseExample": true,
  7767. "changelog": [],
  7768. "params": [
  7769. {
  7770. "key": "organization",
  7771. "description": "Organization key",
  7772. "since": "6.4",
  7773. "required": false,
  7774. "internal": true,
  7775. "exampleValue": "my-org"
  7776. }
  7777. ]
  7778. },
  7779. {
  7780. "key": "create",
  7781. "description": "Create a custom rule.<br>Requires the 'Administer Quality Profiles' permission",
  7782. "since": "4.4",
  7783. "internal": false,
  7784. "post": true,
  7785. "hasResponseExample": false,
  7786. "changelog": [
  7787. {
  7788. "description": "Creating manual rule is not more possible",
  7789. "version": "5.5"
  7790. }
  7791. ],
  7792. "params": [
  7793. {
  7794. "key": "custom_key",
  7795. "description": "Key of the custom rule",
  7796. "required": true,
  7797. "internal": false,
  7798. "exampleValue": "Todo_should_not_be_used",
  7799. "maximumLength": 200
  7800. },
  7801. {
  7802. "key": "manual_key",
  7803. "description": "Manual rules are no more supported. This parameter is ignored",
  7804. "required": false,
  7805. "internal": false,
  7806. "exampleValue": "Error_handling",
  7807. "deprecatedSince": "5.5"
  7808. },
  7809. {
  7810. "key": "markdown_description",
  7811. "description": "Rule description",
  7812. "required": true,
  7813. "internal": false,
  7814. "exampleValue": "Description of my custom rule"
  7815. },
  7816. {
  7817. "key": "name",
  7818. "description": "Rule name",
  7819. "required": true,
  7820. "internal": false,
  7821. "exampleValue": "My custom rule",
  7822. "maximumLength": 200
  7823. },
  7824. {
  7825. "key": "params",
  7826. "description": "Parameters as semi-colon list of <key>=<value>, for example 'params=key1=v1;key2=v2' (Only for custom rule)",
  7827. "required": false,
  7828. "internal": false
  7829. },
  7830. {
  7831. "key": "prevent_reactivation",
  7832. "description": "If set to true and if the rule has been deactivated (status 'REMOVED'), a status 409 will be returned",
  7833. "required": false,
  7834. "internal": false,
  7835. "defaultValue": "false",
  7836. "possibleValues": [
  7837. "true",
  7838. "false",
  7839. "yes",
  7840. "no"
  7841. ]
  7842. },
  7843. {
  7844. "key": "severity",
  7845. "description": "Rule severity",
  7846. "required": false,
  7847. "internal": false,
  7848. "possibleValues": [
  7849. "INFO",
  7850. "MINOR",
  7851. "MAJOR",
  7852. "CRITICAL",
  7853. "BLOCKER"
  7854. ]
  7855. },
  7856. {
  7857. "key": "status",
  7858. "description": "Rule status",
  7859. "required": false,
  7860. "internal": false,
  7861. "defaultValue": "READY",
  7862. "possibleValues": [
  7863. "BETA",
  7864. "DEPRECATED",
  7865. "READY",
  7866. "REMOVED"
  7867. ]
  7868. },
  7869. {
  7870. "key": "template_key",
  7871. "description": "Key of the template rule in order to create a custom rule (mandatory for custom rule)",
  7872. "required": false,
  7873. "internal": false,
  7874. "exampleValue": "java:XPath"
  7875. },
  7876. {
  7877. "key": "type",
  7878. "description": "Rule type",
  7879. "since": "6.7",
  7880. "required": false,
  7881. "internal": false,
  7882. "possibleValues": [
  7883. "CODE_SMELL",
  7884. "BUG",
  7885. "VULNERABILITY"
  7886. ]
  7887. }
  7888. ]
  7889. },
  7890. {
  7891. "key": "delete",
  7892. "description": "Delete custom rule.<br/>Requires the 'Administer Quality Profiles' permission",
  7893. "since": "4.4",
  7894. "internal": false,
  7895. "post": true,
  7896. "hasResponseExample": false,
  7897. "changelog": [],
  7898. "params": [
  7899. {
  7900. "key": "key",
  7901. "description": "Rule key",
  7902. "required": true,
  7903. "internal": false,
  7904. "exampleValue": "squid:XPath_1402065390816"
  7905. }
  7906. ]
  7907. },
  7908. {
  7909. "key": "list",
  7910. "description": "List rules, excluding the manual rules and the rules with status REMOVED. JSON format is not supported for response.",
  7911. "since": "5.2",
  7912. "internal": true,
  7913. "post": false,
  7914. "hasResponseExample": true,
  7915. "changelog": []
  7916. },
  7917. {
  7918. "key": "repositories",
  7919. "description": "List available rule repositories",
  7920. "since": "4.5",
  7921. "internal": false,
  7922. "post": false,
  7923. "hasResponseExample": true,
  7924. "changelog": [],
  7925. "params": [
  7926. {
  7927. "key": "language",
  7928. "description": "A language key; if provided, only repositories for the given language will be returned",
  7929. "required": false,
  7930. "internal": false,
  7931. "exampleValue": "java"
  7932. },
  7933. {
  7934. "key": "q",
  7935. "description": "A pattern to match repository keys/names against",
  7936. "required": false,
  7937. "internal": false,
  7938. "exampleValue": "squid"
  7939. }
  7940. ]
  7941. },
  7942. {
  7943. "key": "search",
  7944. "description": "Search for a collection of relevant rules matching a specified query.<br/>Since 5.5, following fields in the response have been deprecated :<ul><li>\"effortToFixDescription\" becomes \"gapDescription\"</li><li>\"debtRemFnCoeff\" becomes \"remFnGapMultiplier\"</li><li>\"defaultDebtRemFnCoeff\" becomes \"defaultRemFnGapMultiplier\"</li><li>\"debtRemFnOffset\" becomes \"remFnBaseEffort\"</li><li>\"defaultDebtRemFnOffset\" becomes \"defaultRemFnBaseEffort\"</li><li>\"debtOverloaded\" becomes \"remFnOverloaded\"</li></ul>",
  7945. "since": "4.4",
  7946. "internal": false,
  7947. "post": false,
  7948. "hasResponseExample": true,
  7949. "changelog": [],
  7950. "params": [
  7951. {
  7952. "key": "activation",
  7953. "description": "Filter rules that are activated or deactivated on the selected Quality profile. Ignored if the parameter 'qprofile' is not set.",
  7954. "required": false,
  7955. "internal": false,
  7956. "possibleValues": [
  7957. "true",
  7958. "false",
  7959. "yes",
  7960. "no"
  7961. ]
  7962. },
  7963. {
  7964. "key": "active_severities",
  7965. "description": "Comma-separated list of activation severities, i.e the severity of rules in Quality profiles.",
  7966. "required": false,
  7967. "internal": false,
  7968. "exampleValue": "CRITICAL,BLOCKER",
  7969. "possibleValues": [
  7970. "INFO",
  7971. "MINOR",
  7972. "MAJOR",
  7973. "CRITICAL",
  7974. "BLOCKER"
  7975. ]
  7976. },
  7977. {
  7978. "key": "asc",
  7979. "description": "Ascending sort",
  7980. "required": false,
  7981. "internal": false,
  7982. "defaultValue": "true",
  7983. "possibleValues": [
  7984. "true",
  7985. "false",
  7986. "yes",
  7987. "no"
  7988. ]
  7989. },
  7990. {
  7991. "key": "available_since",
  7992. "description": "Filters rules added since date. Format is yyyy-MM-dd",
  7993. "required": false,
  7994. "internal": false,
  7995. "exampleValue": "2014-06-22"
  7996. },
  7997. {
  7998. "key": "compareToProfile",
  7999. "description": "Quality profile key to filter rules that are activated. Meant to compare easily to profile set in 'qprofile'",
  8000. "since": "6.5",
  8001. "required": false,
  8002. "internal": true,
  8003. "exampleValue": "AU-TpxcA-iU5OvuD2FLz"
  8004. },
  8005. {
  8006. "key": "f",
  8007. "description": "Comma-separated list of the fields to be returned in response. All the fields are returned by default, except actives.Since 5.5, following fields have been deprecated :<ul><li>\"defaultDebtRemFn\" becomes \"defaultRemFn\"</li><li>\"debtRemFn\" becomes \"remFn\"</li><li>\"effortToFixDescription\" becomes \"gapDescription\"</li><li>\"debtOverloaded\" becomes \"remFnOverloaded\"</li></ul>",
  8008. "required": false,
  8009. "internal": false,
  8010. "exampleValue": "repo,name",
  8011. "possibleValues": [
  8012. "actives",
  8013. "createdAt",
  8014. "debtOverloaded",
  8015. "debtRemFn",
  8016. "defaultDebtRemFn",
  8017. "defaultRemFn",
  8018. "effortToFixDescription",
  8019. "gapDescription",
  8020. "htmlDesc",
  8021. "htmlNote",
  8022. "internalKey",
  8023. "isTemplate",
  8024. "lang",
  8025. "langName",
  8026. "mdDesc",
  8027. "mdNote",
  8028. "name",
  8029. "noteLogin",
  8030. "params",
  8031. "remFn",
  8032. "remFnOverloaded",
  8033. "repo",
  8034. "severity",
  8035. "status",
  8036. "sysTags",
  8037. "tags",
  8038. "templateKey"
  8039. ]
  8040. },
  8041. {
  8042. "key": "facets",
  8043. "description": "Comma-separated list of the facets to be computed. No facet is computed by default.",
  8044. "required": false,
  8045. "internal": false,
  8046. "exampleValue": "languages,repositories",
  8047. "possibleValues": [
  8048. "languages",
  8049. "repositories",
  8050. "tags",
  8051. "severities",
  8052. "active_severities",
  8053. "statuses",
  8054. "types",
  8055. "true"
  8056. ]
  8057. },
  8058. {
  8059. "key": "inheritance",
  8060. "description": "Comma-separated list of values of inheritance for a rule within a quality profile. Used only if the parameter 'activation' is set.",
  8061. "required": false,
  8062. "internal": false,
  8063. "exampleValue": "INHERITED,OVERRIDES",
  8064. "possibleValues": [
  8065. "NONE",
  8066. "INHERITED",
  8067. "OVERRIDES"
  8068. ]
  8069. },
  8070. {
  8071. "key": "is_template",
  8072. "description": "Filter template rules",
  8073. "required": false,
  8074. "internal": false,
  8075. "possibleValues": [
  8076. "true",
  8077. "false",
  8078. "yes",
  8079. "no"
  8080. ]
  8081. },
  8082. {
  8083. "key": "languages",
  8084. "description": "Comma-separated list of languages",
  8085. "required": false,
  8086. "internal": false,
  8087. "exampleValue": "java,js"
  8088. },
  8089. {
  8090. "key": "organization",
  8091. "description": "Organization key",
  8092. "since": "6.4",
  8093. "required": false,
  8094. "internal": true,
  8095. "exampleValue": "my-org"
  8096. },
  8097. {
  8098. "key": "p",
  8099. "description": "1-based page number",
  8100. "required": false,
  8101. "internal": false,
  8102. "defaultValue": "1",
  8103. "exampleValue": "42",
  8104. "deprecatedKey": "pageIndex",
  8105. "deprecatedKeySince": "5.2"
  8106. },
  8107. {
  8108. "key": "ps",
  8109. "description": "Page size. Must be greater than 0 and less than 500",
  8110. "required": false,
  8111. "internal": false,
  8112. "defaultValue": "100",
  8113. "exampleValue": "20",
  8114. "deprecatedKey": "pageSize",
  8115. "deprecatedKeySince": "5.2",
  8116. "maximumValue": 500
  8117. },
  8118. {
  8119. "key": "q",
  8120. "description": "UTF-8 search query",
  8121. "required": false,
  8122. "internal": false,
  8123. "exampleValue": "xpath"
  8124. },
  8125. {
  8126. "key": "qprofile",
  8127. "description": "Quality profile key to filter on. Used only if the parameter 'activation' is set.",
  8128. "required": false,
  8129. "internal": false,
  8130. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  8131. },
  8132. {
  8133. "key": "repositories",
  8134. "description": "Comma-separated list of repositories",
  8135. "required": false,
  8136. "internal": false,
  8137. "exampleValue": "checkstyle,findbugs"
  8138. },
  8139. {
  8140. "key": "rule_key",
  8141. "description": "Key of rule to search for",
  8142. "required": false,
  8143. "internal": false,
  8144. "exampleValue": "squid:S001"
  8145. },
  8146. {
  8147. "key": "s",
  8148. "description": "Sort field",
  8149. "required": false,
  8150. "internal": false,
  8151. "exampleValue": "name",
  8152. "possibleValues": [
  8153. "name",
  8154. "updatedAt",
  8155. "createdAt",
  8156. "key"
  8157. ]
  8158. },
  8159. {
  8160. "key": "severities",
  8161. "description": "Comma-separated list of default severities. Not the same than severity of rules in Quality profiles.",
  8162. "required": false,
  8163. "internal": false,
  8164. "exampleValue": "CRITICAL,BLOCKER",
  8165. "possibleValues": [
  8166. "INFO",
  8167. "MINOR",
  8168. "MAJOR",
  8169. "CRITICAL",
  8170. "BLOCKER"
  8171. ]
  8172. },
  8173. {
  8174. "key": "statuses",
  8175. "description": "Comma-separated list of status codes",
  8176. "required": false,
  8177. "internal": false,
  8178. "exampleValue": "READY",
  8179. "possibleValues": [
  8180. "BETA",
  8181. "DEPRECATED",
  8182. "READY",
  8183. "REMOVED"
  8184. ]
  8185. },
  8186. {
  8187. "key": "tags",
  8188. "description": "Comma-separated list of tags. Returned rules match any of the tags (OR operator)",
  8189. "required": false,
  8190. "internal": false,
  8191. "exampleValue": "security,java8"
  8192. },
  8193. {
  8194. "key": "template_key",
  8195. "description": "Key of the template rule to filter on. Used to search for the custom rules based on this template.",
  8196. "required": false,
  8197. "internal": false,
  8198. "exampleValue": "java:S001"
  8199. },
  8200. {
  8201. "key": "types",
  8202. "description": "Comma-separated list of types. Returned rules match any of the tags (OR operator)",
  8203. "since": "5.5",
  8204. "required": false,
  8205. "internal": false,
  8206. "exampleValue": "BUG",
  8207. "possibleValues": [
  8208. "CODE_SMELL",
  8209. "BUG",
  8210. "VULNERABILITY"
  8211. ]
  8212. }
  8213. ]
  8214. },
  8215. {
  8216. "key": "show",
  8217. "description": "Get detailed information about a rule<br>Since 5.5, following fields in the response have been deprecated :<ul><li>\"effortToFixDescription\" becomes \"gapDescription\"</li><li>\"debtRemFnCoeff\" becomes \"remFnGapMultiplier\"</li><li>\"defaultDebtRemFnCoeff\" becomes \"defaultRemFnGapMultiplier\"</li><li>\"debtRemFnOffset\" becomes \"remFnBaseEffort\"</li><li>\"defaultDebtRemFnOffset\" becomes \"defaultRemFnBaseEffort\"</li><li>\"debtOverloaded\" becomes \"remFnOverloaded\"</li></ul>",
  8218. "since": "4.2",
  8219. "internal": false,
  8220. "post": false,
  8221. "hasResponseExample": true,
  8222. "changelog": [],
  8223. "params": [
  8224. {
  8225. "key": "actives",
  8226. "description": "Show rule's activations for all profiles (\"active rules\")",
  8227. "required": false,
  8228. "internal": false,
  8229. "defaultValue": "false",
  8230. "possibleValues": [
  8231. "true",
  8232. "false",
  8233. "yes",
  8234. "no"
  8235. ]
  8236. },
  8237. {
  8238. "key": "key",
  8239. "description": "Rule key",
  8240. "required": true,
  8241. "internal": false,
  8242. "exampleValue": "javascript:EmptyBlock"
  8243. },
  8244. {
  8245. "key": "organization",
  8246. "description": "Organization key",
  8247. "since": "6.4",
  8248. "required": false,
  8249. "internal": true,
  8250. "exampleValue": "my-org"
  8251. }
  8252. ]
  8253. },
  8254. {
  8255. "key": "tags",
  8256. "description": "List rule tags",
  8257. "since": "4.4",
  8258. "internal": false,
  8259. "post": false,
  8260. "hasResponseExample": true,
  8261. "changelog": [],
  8262. "params": [
  8263. {
  8264. "key": "organization",
  8265. "description": "Organization key",
  8266. "since": "6.4",
  8267. "required": false,
  8268. "internal": true,
  8269. "exampleValue": "my-org"
  8270. },
  8271. {
  8272. "key": "ps",
  8273. "description": "Page size. Must be greater than 0 and less than 100",
  8274. "required": false,
  8275. "internal": false,
  8276. "defaultValue": "10",
  8277. "exampleValue": "20",
  8278. "deprecatedKey": "pageSize",
  8279. "deprecatedKeySince": "5.2",
  8280. "maximumValue": 100
  8281. },
  8282. {
  8283. "key": "q",
  8284. "description": "Limit search to tags that contain the supplied string.",
  8285. "required": false,
  8286. "internal": false,
  8287. "exampleValue": "misra"
  8288. }
  8289. ]
  8290. },
  8291. {
  8292. "key": "update",
  8293. "description": "Update an existing rule.<br>Requires the 'Administer Quality Profiles' permission",
  8294. "since": "4.4",
  8295. "internal": false,
  8296. "post": true,
  8297. "hasResponseExample": false,
  8298. "changelog": [],
  8299. "params": [
  8300. {
  8301. "key": "debt_remediation_fn_offset",
  8302. "required": false,
  8303. "internal": false,
  8304. "deprecatedSince": "5.5"
  8305. },
  8306. {
  8307. "key": "debt_remediation_fn_type",
  8308. "required": false,
  8309. "internal": false,
  8310. "deprecatedSince": "5.5",
  8311. "possibleValues": [
  8312. "LINEAR",
  8313. "LINEAR_OFFSET",
  8314. "CONSTANT_ISSUE"
  8315. ]
  8316. },
  8317. {
  8318. "key": "debt_remediation_fy_coeff",
  8319. "required": false,
  8320. "internal": false,
  8321. "deprecatedSince": "5.5"
  8322. },
  8323. {
  8324. "key": "debt_sub_characteristic",
  8325. "description": "Debt characteristics are no more supported. This parameter is ignored.",
  8326. "required": false,
  8327. "internal": false,
  8328. "deprecatedSince": "5.5"
  8329. },
  8330. {
  8331. "key": "key",
  8332. "description": "Key of the rule to update",
  8333. "required": true,
  8334. "internal": false,
  8335. "exampleValue": "javascript:NullCheck",
  8336. "maximumLength": 200
  8337. },
  8338. {
  8339. "key": "markdown_description",
  8340. "description": "Rule description (mandatory for custom rule and manual rule)",
  8341. "required": false,
  8342. "internal": false,
  8343. "exampleValue": "Description of my custom rule"
  8344. },
  8345. {
  8346. "key": "markdown_note",
  8347. "description": "Optional note in markdown format. Use empty value to remove current note. Note is not changedif the parameter is not set.",
  8348. "required": false,
  8349. "internal": false,
  8350. "exampleValue": "my *note*"
  8351. },
  8352. {
  8353. "key": "name",
  8354. "description": "Rule name (mandatory for custom rule)",
  8355. "required": false,
  8356. "internal": false,
  8357. "exampleValue": "My custom rule",
  8358. "maximumLength": 200
  8359. },
  8360. {
  8361. "key": "organization",
  8362. "description": "Organization key",
  8363. "since": "6.4",
  8364. "required": false,
  8365. "internal": true,
  8366. "exampleValue": "my-org"
  8367. },
  8368. {
  8369. "key": "params",
  8370. "description": "Parameters as semi-colon list of <key>=<value>, for example 'params=key1=v1;key2=v2' (Only when updating a custom rule)",
  8371. "required": false,
  8372. "internal": false
  8373. },
  8374. {
  8375. "key": "remediation_fn_base_effort",
  8376. "description": "Base effort of the remediation function of the rule",
  8377. "since": "5.5",
  8378. "required": false,
  8379. "internal": false,
  8380. "exampleValue": "1d"
  8381. },
  8382. {
  8383. "key": "remediation_fn_type",
  8384. "description": "Type of the remediation function of the rule",
  8385. "since": "5.5",
  8386. "required": false,
  8387. "internal": false,
  8388. "possibleValues": [
  8389. "LINEAR",
  8390. "LINEAR_OFFSET",
  8391. "CONSTANT_ISSUE"
  8392. ]
  8393. },
  8394. {
  8395. "key": "remediation_fy_gap_multiplier",
  8396. "description": "Gap multiplier of the remediation function of the rule",
  8397. "since": "5.5",
  8398. "required": false,
  8399. "internal": false,
  8400. "exampleValue": "3min"
  8401. },
  8402. {
  8403. "key": "severity",
  8404. "description": "Rule severity (Only when updating a custom rule)",
  8405. "required": false,
  8406. "internal": false,
  8407. "possibleValues": [
  8408. "INFO",
  8409. "MINOR",
  8410. "MAJOR",
  8411. "CRITICAL",
  8412. "BLOCKER"
  8413. ]
  8414. },
  8415. {
  8416. "key": "status",
  8417. "description": "Rule status (Only when updating a custom rule)",
  8418. "required": false,
  8419. "internal": false,
  8420. "possibleValues": [
  8421. "BETA",
  8422. "DEPRECATED",
  8423. "READY",
  8424. "REMOVED"
  8425. ]
  8426. },
  8427. {
  8428. "key": "tags",
  8429. "description": "Optional comma-separated list of tags to set. Use blank value to remove current tags. Tags are not changed if the parameter is not set.",
  8430. "required": false,
  8431. "internal": false,
  8432. "exampleValue": "java8,security"
  8433. }
  8434. ]
  8435. }
  8436. ]
  8437. },
  8438. {
  8439. "path": "api/server",
  8440. "actions": [
  8441. {
  8442. "key": "version",
  8443. "description": "Version of SonarQube in plain text",
  8444. "since": "2.10",
  8445. "internal": false,
  8446. "post": false,
  8447. "hasResponseExample": true,
  8448. "changelog": []
  8449. }
  8450. ]
  8451. },
  8452. {
  8453. "path": "api/settings",
  8454. "since": "6.1",
  8455. "description": "Manage settings.",
  8456. "actions": [
  8457. {
  8458. "key": "check_secret_key",
  8459. "description": "Check if a secret key is available.<br>Requires the 'Administer System' permission.",
  8460. "since": "6.1",
  8461. "internal": true,
  8462. "post": false,
  8463. "hasResponseExample": true,
  8464. "changelog": []
  8465. },
  8466. {
  8467. "key": "encrypt",
  8468. "description": "Encrypt a setting value.<br>Requires 'Administer System' permission.",
  8469. "since": "6.1",
  8470. "internal": true,
  8471. "post": false,
  8472. "hasResponseExample": true,
  8473. "changelog": [],
  8474. "params": [
  8475. {
  8476. "key": "value",
  8477. "description": "Setting value to encrypt",
  8478. "required": true,
  8479. "internal": false,
  8480. "exampleValue": "my value"
  8481. }
  8482. ]
  8483. },
  8484. {
  8485. "key": "generate_secret_key",
  8486. "description": "Generate a secret key.<br>Requires the 'Administer System' permission",
  8487. "since": "6.1",
  8488. "internal": true,
  8489. "post": false,
  8490. "hasResponseExample": true,
  8491. "changelog": []
  8492. },
  8493. {
  8494. "key": "list_definitions",
  8495. "description": "List settings definitions.<br>Requires 'Browse' permission when a component is specified<br/>",
  8496. "since": "6.3",
  8497. "internal": false,
  8498. "post": false,
  8499. "hasResponseExample": true,
  8500. "changelog": [],
  8501. "params": [
  8502. {
  8503. "key": "branch",
  8504. "description": "Branch key. Only available on following settings : sonar.leak.period",
  8505. "since": "6.6",
  8506. "required": false,
  8507. "internal": true,
  8508. "exampleValue": "feature/my_branch"
  8509. },
  8510. {
  8511. "key": "component",
  8512. "description": "Component key",
  8513. "required": false,
  8514. "internal": false,
  8515. "exampleValue": "my_project"
  8516. }
  8517. ]
  8518. },
  8519. {
  8520. "key": "reset",
  8521. "description": "Remove a setting value.<br>Requires one of the following permissions: <ul><li>'Administer System'</li><li>'Administer' rights on the specified component</li></ul>",
  8522. "since": "6.1",
  8523. "internal": false,
  8524. "post": true,
  8525. "hasResponseExample": false,
  8526. "changelog": [],
  8527. "params": [
  8528. {
  8529. "key": "branch",
  8530. "description": "Branch key",
  8531. "since": "6.6",
  8532. "required": false,
  8533. "internal": true,
  8534. "exampleValue": "feature/my_branch"
  8535. },
  8536. {
  8537. "key": "component",
  8538. "description": "Component key",
  8539. "required": false,
  8540. "internal": false,
  8541. "exampleValue": "my_project",
  8542. "deprecatedKey": "componentKey",
  8543. "deprecatedKeySince": "6.3"
  8544. },
  8545. {
  8546. "key": "keys",
  8547. "description": "Setting keys",
  8548. "required": true,
  8549. "internal": false,
  8550. "exampleValue": "sonar.links.scm,sonar.debt.hoursInDay"
  8551. }
  8552. ]
  8553. },
  8554. {
  8555. "key": "set",
  8556. "description": "Update a setting value.<br>Either 'value' or 'values' must be provided.<br> Requires one of the following permissions: <ul><li>'Administer System'</li><li>'Administer' rights on the specified component</li></ul>",
  8557. "since": "6.1",
  8558. "internal": false,
  8559. "post": true,
  8560. "hasResponseExample": false,
  8561. "changelog": [],
  8562. "params": [
  8563. {
  8564. "key": "branch",
  8565. "description": "Branch key. Only available on following settings : sonar.leak.period",
  8566. "since": "6.6",
  8567. "required": false,
  8568. "internal": true,
  8569. "exampleValue": "feature/my_branch"
  8570. },
  8571. {
  8572. "key": "component",
  8573. "description": "Component key",
  8574. "required": false,
  8575. "internal": false,
  8576. "exampleValue": "my_project",
  8577. "deprecatedKey": "componentKey",
  8578. "deprecatedKeySince": "6.3"
  8579. },
  8580. {
  8581. "key": "fieldValues",
  8582. "description": "Setting field values. To set several values, the parameter must be called once for each value.",
  8583. "required": false,
  8584. "internal": false,
  8585. "exampleValue": "fieldValues={\"firstField\":\"first value\", \"secondField\":\"second value\", \"thirdField\":\"third value\"}"
  8586. },
  8587. {
  8588. "key": "key",
  8589. "description": "Setting key",
  8590. "required": true,
  8591. "internal": false,
  8592. "exampleValue": "sonar.links.scm"
  8593. },
  8594. {
  8595. "key": "value",
  8596. "description": "Setting value. To reset a value, please use the reset web service.",
  8597. "required": false,
  8598. "internal": false,
  8599. "exampleValue": "git@github.com:SonarSource/sonarqube.git",
  8600. "maximumLength": 4000
  8601. },
  8602. {
  8603. "key": "values",
  8604. "description": "Setting multi value. To set several values, the parameter must be called once for each value.",
  8605. "required": false,
  8606. "internal": false,
  8607. "exampleValue": "values=firstValue&values=secondValue&values=thirdValue"
  8608. }
  8609. ]
  8610. },
  8611. {
  8612. "key": "values",
  8613. "description": "List settings values.<br>If no value has been set for a setting, then the default value is returned.<br>Requires 'Browse' permission when a component is specified<br/>",
  8614. "since": "6.3",
  8615. "internal": false,
  8616. "post": false,
  8617. "hasResponseExample": true,
  8618. "changelog": [],
  8619. "params": [
  8620. {
  8621. "key": "branch",
  8622. "description": "Branch key",
  8623. "since": "6.6",
  8624. "required": false,
  8625. "internal": true,
  8626. "exampleValue": "feature/my_branch"
  8627. },
  8628. {
  8629. "key": "component",
  8630. "description": "Component key",
  8631. "required": false,
  8632. "internal": false,
  8633. "exampleValue": "my_project"
  8634. },
  8635. {
  8636. "key": "keys",
  8637. "description": "List of setting keys",
  8638. "required": false,
  8639. "internal": false,
  8640. "exampleValue": "sonar.test.inclusions,sonar.dbcleaner.cleanDirectory"
  8641. }
  8642. ]
  8643. }
  8644. ]
  8645. },
  8646. {
  8647. "path": "api/sources",
  8648. "since": "4.2",
  8649. "description": "Get details on source files. See also api/tests.",
  8650. "actions": [
  8651. {
  8652. "key": "hash",
  8653. "description": "Show line line hashes for a given file. Require See Source Code permission on file's project<br/>",
  8654. "since": "5.0",
  8655. "internal": true,
  8656. "post": false,
  8657. "hasResponseExample": true,
  8658. "changelog": [],
  8659. "params": [
  8660. {
  8661. "key": "key",
  8662. "description": "File key",
  8663. "required": true,
  8664. "internal": false,
  8665. "exampleValue": "my_project:/src/foo/Bar.php"
  8666. }
  8667. ]
  8668. },
  8669. {
  8670. "key": "index",
  8671. "description": "Get source code as line number / text pairs. Require See Source Code permission on file",
  8672. "since": "5.0",
  8673. "internal": true,
  8674. "post": false,
  8675. "hasResponseExample": true,
  8676. "changelog": [],
  8677. "params": [
  8678. {
  8679. "key": "from",
  8680. "description": "First line",
  8681. "required": false,
  8682. "internal": false,
  8683. "defaultValue": "1"
  8684. },
  8685. {
  8686. "key": "resource",
  8687. "description": "File key",
  8688. "required": true,
  8689. "internal": false,
  8690. "exampleValue": "my_project:/src/foo/Bar.php"
  8691. },
  8692. {
  8693. "key": "to",
  8694. "description": "Last line (excluded). If not specified, all lines are returned until end of file",
  8695. "required": false,
  8696. "internal": false
  8697. }
  8698. ]
  8699. },
  8700. {
  8701. "key": "lines",
  8702. "description": "Show source code with line oriented info. Require See Source Code permission on file's project<br/>Each element of the result array is an object which contains:<ol><li>Line number</li><li>Content of the line</li><li>Author of the line (from SCM information)</li><li>Revision of the line (from SCM information)</li><li>Last commit date of the line (from SCM information)</li><li>Line hits from coverage</li><li>Number of conditions to cover in tests</li><li>Number of conditions covered by tests</li></ol>",
  8703. "since": "5.0",
  8704. "internal": true,
  8705. "post": false,
  8706. "hasResponseExample": true,
  8707. "changelog": [
  8708. {
  8709. "description": "fields \"branch\" added",
  8710. "version": "6.6"
  8711. },
  8712. {
  8713. "description": "fields \"utLineHits\", \"utConditions\" and \"utCoveredConditions\" has been renamed \"lineHits\", \"conditions\" and \"coveredConditions\"",
  8714. "version": "6.2"
  8715. },
  8716. {
  8717. "description": "fields \"itLineHits\", \"itConditions\" and \"itCoveredConditions\" are no more returned",
  8718. "version": "6.2"
  8719. }
  8720. ],
  8721. "params": [
  8722. {
  8723. "key": "branch",
  8724. "description": "Branch key",
  8725. "required": false,
  8726. "internal": true,
  8727. "exampleValue": "feature/my_branch"
  8728. },
  8729. {
  8730. "key": "from",
  8731. "description": "First line to return. Starts from 1",
  8732. "required": false,
  8733. "internal": false,
  8734. "defaultValue": "1",
  8735. "exampleValue": "10"
  8736. },
  8737. {
  8738. "key": "key",
  8739. "description": "File key. Mandatory if param 'uuid' is not set. Available since 5.2",
  8740. "required": false,
  8741. "internal": false,
  8742. "exampleValue": "my_project:/src/foo/Bar.php"
  8743. },
  8744. {
  8745. "key": "to",
  8746. "description": "Optional last line to return (inclusive). It must be greater than or equal to parameter 'from'. If unset, then all the lines greater than or equal to 'from' are returned.",
  8747. "required": false,
  8748. "internal": false,
  8749. "exampleValue": "20"
  8750. },
  8751. {
  8752. "key": "uuid",
  8753. "description": "File uuid. Mandatory if param 'key' is not set",
  8754. "required": false,
  8755. "internal": false,
  8756. "exampleValue": "f333aab4-7e3a-4d70-87e1-f4c491f05e5c"
  8757. }
  8758. ]
  8759. },
  8760. {
  8761. "key": "raw",
  8762. "description": "Get source code as raw text. Require 'See Source Code' permission on file",
  8763. "since": "5.0",
  8764. "internal": false,
  8765. "post": false,
  8766. "hasResponseExample": true,
  8767. "changelog": [],
  8768. "params": [
  8769. {
  8770. "key": "branch",
  8771. "description": "Branch key",
  8772. "required": false,
  8773. "internal": true,
  8774. "exampleValue": "feature/my_branch"
  8775. },
  8776. {
  8777. "key": "key",
  8778. "description": "File key",
  8779. "required": true,
  8780. "internal": false,
  8781. "exampleValue": "my_project:src/foo/Bar.php"
  8782. }
  8783. ]
  8784. },
  8785. {
  8786. "key": "scm",
  8787. "description": "Get SCM information of source files. Require See Source Code permission on file's project<br/>Each element of the result array is composed of:<ol><li>Line number</li><li>Author of the commit</li><li>Datetime of the commit (before 5.2 it was only the Date)</li><li>Revision of the commit (added in 5.2)</li></ol>",
  8788. "since": "4.4",
  8789. "internal": false,
  8790. "post": false,
  8791. "hasResponseExample": true,
  8792. "changelog": [],
  8793. "params": [
  8794. {
  8795. "key": "commits_by_line",
  8796. "description": "Group lines by SCM commit if value is false, else display commits for each line, even if two consecutive lines relate to the same commit.",
  8797. "required": false,
  8798. "internal": false,
  8799. "defaultValue": "false",
  8800. "possibleValues": [
  8801. "true",
  8802. "false",
  8803. "yes",
  8804. "no"
  8805. ]
  8806. },
  8807. {
  8808. "key": "from",
  8809. "description": "First line to return. Starts at 1",
  8810. "required": false,
  8811. "internal": false,
  8812. "defaultValue": "1",
  8813. "exampleValue": "10"
  8814. },
  8815. {
  8816. "key": "key",
  8817. "description": "File key",
  8818. "required": true,
  8819. "internal": false,
  8820. "exampleValue": "my_project:/src/foo/Bar.php"
  8821. },
  8822. {
  8823. "key": "to",
  8824. "description": "Last line to return (inclusive)",
  8825. "required": false,
  8826. "internal": false,
  8827. "exampleValue": "20"
  8828. }
  8829. ]
  8830. },
  8831. {
  8832. "key": "show",
  8833. "description": "Get source code. Require See Source Code permission on file's project<br/>Each element of the result array is composed of:<ol><li>Line number</li><li>Content of the line</li></ol>",
  8834. "since": "4.4",
  8835. "internal": false,
  8836. "post": false,
  8837. "hasResponseExample": true,
  8838. "changelog": [],
  8839. "params": [
  8840. {
  8841. "key": "from",
  8842. "description": "First line to return. Starts at 1",
  8843. "required": false,
  8844. "internal": false,
  8845. "defaultValue": "1",
  8846. "exampleValue": "10"
  8847. },
  8848. {
  8849. "key": "key",
  8850. "description": "File key",
  8851. "required": true,
  8852. "internal": false,
  8853. "exampleValue": "my_project:/src/foo/Bar.php"
  8854. },
  8855. {
  8856. "key": "to",
  8857. "description": "Last line to return (inclusive)",
  8858. "required": false,
  8859. "internal": false,
  8860. "exampleValue": "20"
  8861. }
  8862. ]
  8863. }
  8864. ]
  8865. },
  8866. {
  8867. "path": "api/system",
  8868. "description": "Get system details, and perform some management actions, such as restarting, and initiating a database migration (as part of a system upgrade).",
  8869. "actions": [
  8870. {
  8871. "key": "change_log_level",
  8872. "description": "Temporarily changes level of logs. New level is not persistent and is lost when restarting server. Requires system administration permission.",
  8873. "since": "5.2",
  8874. "internal": false,
  8875. "post": true,
  8876. "hasResponseExample": false,
  8877. "changelog": [],
  8878. "params": [
  8879. {
  8880. "key": "level",
  8881. "description": "The new level. Be cautious: DEBUG, and even more TRACE, may have performance impacts.",
  8882. "required": true,
  8883. "internal": false,
  8884. "possibleValues": [
  8885. "TRACE",
  8886. "DEBUG",
  8887. "INFO"
  8888. ]
  8889. }
  8890. ]
  8891. },
  8892. {
  8893. "key": "db_migration_status",
  8894. "description": "Display the database migration status of SonarQube.<br/>State values are:<ul><li>NO_MIGRATION: DB is up to date with current version of SonarQube.</li><li>NOT_SUPPORTED: Migration is not supported on embedded databases.</li><li>MIGRATION_RUNNING: DB migration is under go.</li><li>MIGRATION_SUCCEEDED: DB migration has run and has been successful.</li><li>MIGRATION_FAILED: DB migration has run and failed. SonarQube must be restarted in order to retry a DB migration (optionally after DB has been restored from backup).</li><li>MIGRATION_REQUIRED: DB migration is required.</li></ul>",
  8895. "since": "5.2",
  8896. "internal": false,
  8897. "post": false,
  8898. "hasResponseExample": true,
  8899. "changelog": []
  8900. },
  8901. {
  8902. "key": "health",
  8903. "description": "Provide health status of SonarQube.<p>Require 'Administer System' permission or authentication with passcode</p><p> <ul> <li>GREEN: SonarQube is fully operational</li> <li>YELLOW: SonarQube is usable, but it needs attention in order to be fully operational</li> <li>RED: SonarQube is not operational</li> </ul></p>",
  8904. "since": "6.6",
  8905. "internal": false,
  8906. "post": false,
  8907. "hasResponseExample": true,
  8908. "changelog": []
  8909. },
  8910. {
  8911. "key": "info",
  8912. "description": "Get detailed information about system configuration.<br/>Requires 'Administer' permissions.<br/>Since 5.5, this web service becomes internal in order to more easily update result.",
  8913. "since": "5.1",
  8914. "internal": true,
  8915. "post": false,
  8916. "hasResponseExample": true,
  8917. "changelog": []
  8918. },
  8919. {
  8920. "key": "logs",
  8921. "description": "Get system logs in plain-text format. Requires system administration permission.",
  8922. "since": "5.2",
  8923. "internal": false,
  8924. "post": false,
  8925. "hasResponseExample": true,
  8926. "changelog": [],
  8927. "params": [
  8928. {
  8929. "key": "process",
  8930. "description": "Process to get logs from",
  8931. "since": "6.2",
  8932. "required": false,
  8933. "internal": false,
  8934. "defaultValue": "app",
  8935. "possibleValues": [
  8936. "app",
  8937. "ce",
  8938. "es",
  8939. "web"
  8940. ]
  8941. }
  8942. ]
  8943. },
  8944. {
  8945. "key": "migrate_db",
  8946. "description": "Migrate the database to match the current version of SonarQube.<br/>Sending a POST request to this URL starts the DB migration. It is strongly advised to <strong>make a database backup</strong> before invoking this WS.<br/>State values are:<ul><li>NO_MIGRATION: DB is up to date with current version of SonarQube.</li><li>NOT_SUPPORTED: Migration is not supported on embedded databases.</li><li>MIGRATION_RUNNING: DB migration is under go.</li><li>MIGRATION_SUCCEEDED: DB migration has run and has been successful.</li><li>MIGRATION_FAILED: DB migration has run and failed. SonarQube must be restarted in order to retry a DB migration (optionally after DB has been restored from backup).</li><li>MIGRATION_REQUIRED: DB migration is required.</li></ul>",
  8947. "since": "5.2",
  8948. "internal": false,
  8949. "post": true,
  8950. "hasResponseExample": true,
  8951. "changelog": []
  8952. },
  8953. {
  8954. "key": "ping",
  8955. "description": "Answers \"pong\" as plain-text",
  8956. "since": "6.3",
  8957. "internal": false,
  8958. "post": false,
  8959. "hasResponseExample": true,
  8960. "changelog": []
  8961. },
  8962. {
  8963. "key": "restart",
  8964. "description": "Restart server. Require 'Administer System' permission. Perform a full restart of the Web, Search and Compute Engine Servers processes.",
  8965. "since": "4.3",
  8966. "internal": false,
  8967. "post": true,
  8968. "hasResponseExample": false,
  8969. "changelog": []
  8970. },
  8971. {
  8972. "key": "status",
  8973. "description": "Get state information about SonarQube.<p>status: the running status <ul> <li>STARTING: SonarQube Web Server is up and serving some Web Services (eg. api/system/status) but initialization is still ongoing</li> <li>UP: SonarQube instance is up and running</li> <li>DOWN: SonarQube instance is up but not running because migration has failed (refer to WS /api/system/migrate_db for details) or some other reason (check logs).</li> <li>RESTARTING: SonarQube instance is still up but a restart has been requested (refer to WS /api/system/restart for details).</li> <li>DB_MIGRATION_NEEDED: database migration is required. DB migration can be started using WS /api/system/migrate_db.</li> <li>DB_MIGRATION_RUNNING: DB migration is running (refer to WS /api/system/migrate_db for details)</li> </ul></p>",
  8974. "since": "5.2",
  8975. "internal": false,
  8976. "post": false,
  8977. "hasResponseExample": true,
  8978. "changelog": []
  8979. },
  8980. {
  8981. "key": "upgrades",
  8982. "description": "Lists available upgrades for the SonarQube instance (if any) and for each one, lists incompatible plugins and plugins requiring upgrade.<br/>Plugin information is retrieved from Update Center. Date and time at which Update Center was last refreshed is provided in the response.",
  8983. "since": "5.2",
  8984. "internal": false,
  8985. "post": false,
  8986. "hasResponseExample": true,
  8987. "changelog": []
  8988. }
  8989. ]
  8990. },
  8991. {
  8992. "path": "api/tests",
  8993. "since": "4.4",
  8994. "description": "Get details on test files. See also api/sources. Deprecated since 5.6.",
  8995. "actions": [
  8996. {
  8997. "key": "covered_files",
  8998. "description": "Get the list of source files covered by a test. Require Browse permission on test file's project",
  8999. "since": "4.4",
  9000. "deprecatedSince": "5.6",
  9001. "internal": false,
  9002. "post": false,
  9003. "hasResponseExample": true,
  9004. "changelog": [
  9005. {
  9006. "description": "\"branch\" field is now returned",
  9007. "version": "6.6"
  9008. }
  9009. ],
  9010. "params": [
  9011. {
  9012. "key": "p",
  9013. "description": "1-based page number",
  9014. "required": false,
  9015. "internal": false,
  9016. "defaultValue": "1",
  9017. "exampleValue": "42",
  9018. "deprecatedKey": "pageIndex",
  9019. "deprecatedKeySince": "5.2"
  9020. },
  9021. {
  9022. "key": "ps",
  9023. "description": "Page size. Must be greater than 0.",
  9024. "required": false,
  9025. "internal": false,
  9026. "defaultValue": "100",
  9027. "exampleValue": "20",
  9028. "deprecatedKey": "pageSize",
  9029. "deprecatedKeySince": "5.2"
  9030. },
  9031. {
  9032. "key": "testId",
  9033. "description": "Test ID",
  9034. "required": true,
  9035. "internal": false,
  9036. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  9037. }
  9038. ]
  9039. },
  9040. {
  9041. "key": "list",
  9042. "description": "Get the list of tests either in a test file or that test a given line of source code.<br /> Requires 'Browse' permission on the file's project.<br /> One (and only one) of the following combination of parameters must be provided: <ul><li>testId - get a specific test</li><li>testFileId - get the tests in a test file</li><li>testFileKey - get the tests in a test file</li><li>sourceFileId and sourceFileLineNumber - get the tests that cover a specific line of code</li><li>sourceFileKey and sourceFileLineNumber - get the tests that cover a specific line of code</li></ul>",
  9043. "since": "5.2",
  9044. "deprecatedSince": "5.6",
  9045. "internal": false,
  9046. "post": false,
  9047. "hasResponseExample": true,
  9048. "changelog": [
  9049. {
  9050. "description": "\"fileBranch\" field is now returned",
  9051. "version": "6.6"
  9052. }
  9053. ],
  9054. "params": [
  9055. {
  9056. "key": "branch",
  9057. "description": "Branch key",
  9058. "since": "6.6",
  9059. "required": false,
  9060. "internal": true,
  9061. "exampleValue": "feature/my_branch"
  9062. },
  9063. {
  9064. "key": "p",
  9065. "description": "1-based page number",
  9066. "required": false,
  9067. "internal": false,
  9068. "defaultValue": "1",
  9069. "exampleValue": "42",
  9070. "deprecatedKey": "pageIndex",
  9071. "deprecatedKeySince": "5.2"
  9072. },
  9073. {
  9074. "key": "ps",
  9075. "description": "Page size. Must be greater than 0 and less than 500",
  9076. "required": false,
  9077. "internal": false,
  9078. "defaultValue": "100",
  9079. "exampleValue": "20",
  9080. "deprecatedKey": "pageSize",
  9081. "deprecatedKeySince": "5.2",
  9082. "maximumValue": 500
  9083. },
  9084. {
  9085. "key": "sourceFileId",
  9086. "description": "ID of source file. Must be provided with the source file line number.",
  9087. "required": false,
  9088. "internal": false,
  9089. "exampleValue": "AU-TpxcA-iU5OvuD2FL0"
  9090. },
  9091. {
  9092. "key": "sourceFileKey",
  9093. "description": "Key of source file. Must be provided with the source file line number.",
  9094. "since": "5.4",
  9095. "required": false,
  9096. "internal": false,
  9097. "exampleValue": "my_project:/src/foo/Bar.php"
  9098. },
  9099. {
  9100. "key": "sourceFileLineNumber",
  9101. "description": "Source file line number. Must be provided with the source file ID or key.",
  9102. "required": false,
  9103. "internal": false,
  9104. "exampleValue": "10"
  9105. },
  9106. {
  9107. "key": "testFileId",
  9108. "description": "ID of test file",
  9109. "required": false,
  9110. "internal": false,
  9111. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  9112. },
  9113. {
  9114. "key": "testFileKey",
  9115. "description": "Key of test file",
  9116. "required": false,
  9117. "internal": false,
  9118. "exampleValue": "MY_PROJECT:src/test/java/foo/BarTest.java"
  9119. },
  9120. {
  9121. "key": "testId",
  9122. "description": "ID of test",
  9123. "required": false,
  9124. "internal": false,
  9125. "exampleValue": "AU-TpxcA-iU5OvuD2FLz"
  9126. }
  9127. ]
  9128. }
  9129. ]
  9130. },
  9131. {
  9132. "path": "api/timemachine",
  9133. "since": "2.10",
  9134. "description": "Removed since 6.3, please use api/measures/search_history instead",
  9135. "actions": [
  9136. {
  9137. "key": "index",
  9138. "description": "The web service is removed and you're invited to use api/measures/search_history instead",
  9139. "since": "2.10",
  9140. "deprecatedSince": "6.3",
  9141. "internal": false,
  9142. "post": false,
  9143. "hasResponseExample": true,
  9144. "changelog": []
  9145. }
  9146. ]
  9147. },
  9148. {
  9149. "path": "api/updatecenter",
  9150. "since": "2.10",
  9151. "description": "Get list of installed plugins",
  9152. "actions": [
  9153. {
  9154. "key": "installed_plugins",
  9155. "description": "Get the list of all the plugins installed on the SonarQube instance",
  9156. "since": "2.10",
  9157. "deprecatedSince": "6.3",
  9158. "internal": true,
  9159. "post": false,
  9160. "hasResponseExample": true,
  9161. "changelog": [],
  9162. "params": [
  9163. {
  9164. "key": "format",
  9165. "description": "Only json response format is available",
  9166. "required": false,
  9167. "internal": false,
  9168. "possibleValues": [
  9169. "json"
  9170. ]
  9171. }
  9172. ]
  9173. },
  9174. {
  9175. "key": "upload",
  9176. "description": "Upload a plugin.<br /> Requires 'Administer System' permission.",
  9177. "since": "6.0",
  9178. "internal": true,
  9179. "post": true,
  9180. "hasResponseExample": false,
  9181. "changelog": [],
  9182. "params": [
  9183. {
  9184. "key": "file",
  9185. "description": "The jar file of the plugin to install",
  9186. "required": true,
  9187. "internal": false
  9188. }
  9189. ]
  9190. }
  9191. ]
  9192. },
  9193. {
  9194. "path": "api/user_groups",
  9195. "since": "5.2",
  9196. "description": "Manage user groups.",
  9197. "actions": [
  9198. {
  9199. "key": "add_user",
  9200. "description": "Add a user to a group.<br />'id' or 'name' must be provided.<br />Requires the following permission: 'Administer System'.",
  9201. "since": "5.2",
  9202. "internal": false,
  9203. "post": true,
  9204. "hasResponseExample": false,
  9205. "changelog": [
  9206. {
  9207. "description": "It's no longer possible to add a user to the default group",
  9208. "version": "6.4"
  9209. }
  9210. ],
  9211. "params": [
  9212. {
  9213. "key": "id",
  9214. "description": "Group id",
  9215. "required": false,
  9216. "internal": false,
  9217. "exampleValue": "42"
  9218. },
  9219. {
  9220. "key": "login",
  9221. "description": "User login",
  9222. "required": false,
  9223. "internal": false,
  9224. "exampleValue": "g.hopper"
  9225. },
  9226. {
  9227. "key": "name",
  9228. "description": "Group name",
  9229. "required": false,
  9230. "internal": false,
  9231. "exampleValue": "sonar-administrators"
  9232. },
  9233. {
  9234. "key": "organization",
  9235. "description": "Key of organization",
  9236. "since": "6.2",
  9237. "required": false,
  9238. "internal": true,
  9239. "exampleValue": "my-org"
  9240. }
  9241. ]
  9242. },
  9243. {
  9244. "key": "create",
  9245. "description": "Create a group.<br>Requires the following permission: 'Administer System'.",
  9246. "since": "5.2",
  9247. "internal": false,
  9248. "post": true,
  9249. "hasResponseExample": true,
  9250. "changelog": [],
  9251. "params": [
  9252. {
  9253. "key": "description",
  9254. "description": "Description for the new group. A group description cannot be larger than 200 characters.",
  9255. "required": false,
  9256. "internal": false,
  9257. "exampleValue": "Default group for new users",
  9258. "maximumLength": 200
  9259. },
  9260. {
  9261. "key": "name",
  9262. "description": "Name for the new group. A group name cannot be larger than 255 characters and must be unique. The value 'anyone' (whatever the case) is reserved and cannot be used.",
  9263. "required": true,
  9264. "internal": false,
  9265. "exampleValue": "sonar-users",
  9266. "maximumLength": 255
  9267. },
  9268. {
  9269. "key": "organization",
  9270. "description": "Key of organization. If unset then default organization is used.",
  9271. "since": "6.2",
  9272. "required": false,
  9273. "internal": true,
  9274. "exampleValue": "my-org"
  9275. }
  9276. ]
  9277. },
  9278. {
  9279. "key": "delete",
  9280. "description": "Delete a group. The default groups cannot be deleted.<br/>'id' or 'name' must be provided.<br />Requires the following permission: 'Administer System'.",
  9281. "since": "5.2",
  9282. "internal": false,
  9283. "post": true,
  9284. "hasResponseExample": false,
  9285. "changelog": [],
  9286. "params": [
  9287. {
  9288. "key": "id",
  9289. "description": "Group id",
  9290. "required": false,
  9291. "internal": false,
  9292. "exampleValue": "42"
  9293. },
  9294. {
  9295. "key": "name",
  9296. "description": "Group name",
  9297. "required": false,
  9298. "internal": false,
  9299. "exampleValue": "sonar-administrators"
  9300. },
  9301. {
  9302. "key": "organization",
  9303. "description": "Key of organization",
  9304. "since": "6.2",
  9305. "required": false,
  9306. "internal": true,
  9307. "exampleValue": "my-org"
  9308. }
  9309. ]
  9310. },
  9311. {
  9312. "key": "remove_user",
  9313. "description": "Remove a user from a group.<br />'id' or 'name' must be provided.<br>Requires the following permission: 'Administer System'.",
  9314. "since": "5.2",
  9315. "internal": false,
  9316. "post": true,
  9317. "hasResponseExample": false,
  9318. "changelog": [],
  9319. "params": [
  9320. {
  9321. "key": "id",
  9322. "description": "Group id",
  9323. "required": false,
  9324. "internal": false,
  9325. "exampleValue": "42"
  9326. },
  9327. {
  9328. "key": "login",
  9329. "description": "User login",
  9330. "required": false,
  9331. "internal": false,
  9332. "exampleValue": "g.hopper"
  9333. },
  9334. {
  9335. "key": "name",
  9336. "description": "Group name",
  9337. "required": false,
  9338. "internal": false,
  9339. "exampleValue": "sonar-administrators"
  9340. },
  9341. {
  9342. "key": "organization",
  9343. "description": "Key of organization",
  9344. "since": "6.2",
  9345. "required": false,
  9346. "internal": true,
  9347. "exampleValue": "my-org"
  9348. }
  9349. ]
  9350. },
  9351. {
  9352. "key": "search",
  9353. "description": "Search for user groups.<br>Requires the following permission: 'Administer System'.",
  9354. "since": "5.2",
  9355. "internal": false,
  9356. "post": false,
  9357. "hasResponseExample": true,
  9358. "changelog": [
  9359. {
  9360. "description": "Paging response fields moved to a Paging object",
  9361. "version": "6.4"
  9362. },
  9363. {
  9364. "description": "'default' response field has been added",
  9365. "version": "6.4"
  9366. }
  9367. ],
  9368. "params": [
  9369. {
  9370. "key": "f",
  9371. "description": "Comma-separated list of the fields to be returned in response. All the fields are returned by default.",
  9372. "required": false,
  9373. "internal": false,
  9374. "possibleValues": [
  9375. "name",
  9376. "description",
  9377. "membersCount"
  9378. ]
  9379. },
  9380. {
  9381. "key": "organization",
  9382. "description": "Key of organization. If not set then groups are searched in default organization.",
  9383. "since": "6.2",
  9384. "required": false,
  9385. "internal": true,
  9386. "exampleValue": "my-org"
  9387. },
  9388. {
  9389. "key": "p",
  9390. "description": "1-based page number",
  9391. "required": false,
  9392. "internal": false,
  9393. "defaultValue": "1",
  9394. "exampleValue": "42",
  9395. "deprecatedKey": "pageIndex",
  9396. "deprecatedKeySince": "5.2"
  9397. },
  9398. {
  9399. "key": "ps",
  9400. "description": "Page size. Must be greater than 0 and less than 500",
  9401. "required": false,
  9402. "internal": false,
  9403. "defaultValue": "100",
  9404. "exampleValue": "20",
  9405. "deprecatedKey": "pageSize",
  9406. "deprecatedKeySince": "5.2",
  9407. "maximumValue": 500
  9408. },
  9409. {
  9410. "key": "q",
  9411. "description": "Limit search to names that contain the supplied string.",
  9412. "required": false,
  9413. "internal": false,
  9414. "exampleValue": "sonar-users"
  9415. }
  9416. ]
  9417. },
  9418. {
  9419. "key": "update",
  9420. "description": "Update a group.<br>Requires the following permission: 'Administer System'.",
  9421. "since": "5.2",
  9422. "internal": false,
  9423. "post": true,
  9424. "hasResponseExample": false,
  9425. "changelog": [
  9426. {
  9427. "description": "The default group is no longer editable",
  9428. "version": "6.4"
  9429. }
  9430. ],
  9431. "params": [
  9432. {
  9433. "key": "description",
  9434. "description": "New optional description for the group. A group description cannot be larger than 200 characters. If value is not defined, then description is not changed.",
  9435. "required": false,
  9436. "internal": false,
  9437. "exampleValue": "Default group for new users",
  9438. "maximumLength": 200
  9439. },
  9440. {
  9441. "key": "id",
  9442. "description": "Identifier of the group.",
  9443. "required": true,
  9444. "internal": false,
  9445. "exampleValue": "42"
  9446. },
  9447. {
  9448. "key": "name",
  9449. "description": "New optional name for the group. A group name cannot be larger than 255 characters and must be unique. Value 'anyone' (whatever the case) is reserved and cannot be used. If value is empty or not defined, then name is not changed.",
  9450. "required": false,
  9451. "internal": false,
  9452. "exampleValue": "my-group",
  9453. "maximumLength": 255
  9454. }
  9455. ]
  9456. },
  9457. {
  9458. "key": "users",
  9459. "description": "Search for users with membership information with respect to a group.<br>Requires the following permission: 'Administer System'.",
  9460. "since": "5.2",
  9461. "internal": false,
  9462. "post": false,
  9463. "hasResponseExample": true,
  9464. "changelog": [],
  9465. "params": [
  9466. {
  9467. "key": "id",
  9468. "description": "Group id",
  9469. "required": false,
  9470. "internal": false,
  9471. "exampleValue": "42"
  9472. },
  9473. {
  9474. "key": "name",
  9475. "description": "Group name",
  9476. "required": false,
  9477. "internal": false,
  9478. "exampleValue": "sonar-administrators"
  9479. },
  9480. {
  9481. "key": "organization",
  9482. "description": "Key of organization",
  9483. "since": "6.2",
  9484. "required": false,
  9485. "internal": true,
  9486. "exampleValue": "my-org"
  9487. },
  9488. {
  9489. "key": "p",
  9490. "description": "1-based page number",
  9491. "required": false,
  9492. "internal": false,
  9493. "defaultValue": "1",
  9494. "exampleValue": "42",
  9495. "deprecatedKey": "pageIndex",
  9496. "deprecatedKeySince": "5.2"
  9497. },
  9498. {
  9499. "key": "ps",
  9500. "description": "Page size. Must be greater than 0.",
  9501. "required": false,
  9502. "internal": false,
  9503. "defaultValue": "25",
  9504. "exampleValue": "20",
  9505. "deprecatedKey": "pageSize",
  9506. "deprecatedKeySince": "5.2"
  9507. },
  9508. {
  9509. "key": "q",
  9510. "description": "Limit search to names or logins that contain the supplied string.",
  9511. "required": false,
  9512. "internal": false,
  9513. "exampleValue": "freddy"
  9514. },
  9515. {
  9516. "key": "selected",
  9517. "description": "Depending on the value, show only selected items (selected=selected), deselected items (selected=deselected), or all items with their selection status (selected=all).",
  9518. "required": false,
  9519. "internal": false,
  9520. "defaultValue": "selected",
  9521. "possibleValues": [
  9522. "all",
  9523. "deselected",
  9524. "selected"
  9525. ]
  9526. }
  9527. ]
  9528. }
  9529. ]
  9530. },
  9531. {
  9532. "path": "api/user_properties",
  9533. "since": "2.6",
  9534. "description": "Removed since 6.3, please use api/favorites and api/notifications instead",
  9535. "actions": [
  9536. {
  9537. "key": "index",
  9538. "description": "This web service is removed",
  9539. "since": "2.6",
  9540. "deprecatedSince": "6.3",
  9541. "internal": false,
  9542. "post": false,
  9543. "hasResponseExample": true,
  9544. "changelog": []
  9545. }
  9546. ]
  9547. },
  9548. {
  9549. "path": "api/user_tokens",
  9550. "since": "5.3",
  9551. "description": "List, create, and delete a user's access tokens.",
  9552. "actions": [
  9553. {
  9554. "key": "generate",
  9555. "description": "Generate a user access token. <br />Please keep your tokens secret. They enable to authenticate and analyze projects.<br />If the login is set, it requires administration permissions. Otherwise, a token is generated for the authenticated user.",
  9556. "since": "5.3",
  9557. "internal": false,
  9558. "post": true,
  9559. "hasResponseExample": true,
  9560. "changelog": [],
  9561. "params": [
  9562. {
  9563. "key": "login",
  9564. "description": "User login. If not set, the token is generated for the authenticated user.",
  9565. "required": false,
  9566. "internal": false,
  9567. "exampleValue": "g.hopper"
  9568. },
  9569. {
  9570. "key": "name",
  9571. "description": "Token name",
  9572. "required": true,
  9573. "internal": false,
  9574. "exampleValue": "Project scan on Travis",
  9575. "maximumLength": 100
  9576. }
  9577. ]
  9578. },
  9579. {
  9580. "key": "revoke",
  9581. "description": "Revoke a user access token. <br/>If the login is set, it requires administration permissions. Otherwise, a token is generated for the authenticated user.",
  9582. "since": "5.3",
  9583. "internal": false,
  9584. "post": true,
  9585. "hasResponseExample": false,
  9586. "changelog": [],
  9587. "params": [
  9588. {
  9589. "key": "login",
  9590. "description": "User login",
  9591. "required": false,
  9592. "internal": false,
  9593. "exampleValue": "g.hopper"
  9594. },
  9595. {
  9596. "key": "name",
  9597. "description": "Token name",
  9598. "required": true,
  9599. "internal": false,
  9600. "exampleValue": "Project scan on Travis"
  9601. }
  9602. ]
  9603. },
  9604. {
  9605. "key": "search",
  9606. "description": "List the access tokens of a user.<br>The login must exist and active.<br>If the login is set, it requires administration permissions. Otherwise, a token is generated for the authenticated user.",
  9607. "since": "5.3",
  9608. "internal": false,
  9609. "post": false,
  9610. "hasResponseExample": true,
  9611. "changelog": [],
  9612. "params": [
  9613. {
  9614. "key": "login",
  9615. "description": "User login",
  9616. "required": false,
  9617. "internal": false,
  9618. "exampleValue": "g.hopper"
  9619. }
  9620. ]
  9621. }
  9622. ]
  9623. },
  9624. {
  9625. "path": "api/users",
  9626. "since": "3.6",
  9627. "description": "Manage users.",
  9628. "actions": [
  9629. {
  9630. "key": "change_password",
  9631. "description": "Update a user's password. Authenticated users can change their own password, provided that the account is not linked to an external authentication system. Administer System permission is required to change another user's password.",
  9632. "since": "5.2",
  9633. "internal": false,
  9634. "post": true,
  9635. "hasResponseExample": false,
  9636. "changelog": [],
  9637. "params": [
  9638. {
  9639. "key": "login",
  9640. "description": "User login",
  9641. "required": true,
  9642. "internal": false,
  9643. "exampleValue": "myuser"
  9644. },
  9645. {
  9646. "key": "password",
  9647. "description": "New password",
  9648. "required": true,
  9649. "internal": false,
  9650. "exampleValue": "mypassword"
  9651. },
  9652. {
  9653. "key": "previousPassword",
  9654. "description": "Previous password. Required when changing one's own password.",
  9655. "required": false,
  9656. "internal": false,
  9657. "exampleValue": "oldpassword"
  9658. }
  9659. ]
  9660. },
  9661. {
  9662. "key": "create",
  9663. "description": "Create a user.<br/>If a deactivated user account exists with the given login, it will be reactivated.<br/>Requires Administer System permission",
  9664. "since": "3.7",
  9665. "internal": false,
  9666. "post": true,
  9667. "hasResponseExample": false,
  9668. "changelog": [
  9669. {
  9670. "description": "The password is only mandatory when creating local users, and should not be set on non local users",
  9671. "version": "6.3"
  9672. },
  9673. {
  9674. "description": "The 'infos' message is no more returned when a user is reactivated",
  9675. "version": "6.3"
  9676. }
  9677. ],
  9678. "params": [
  9679. {
  9680. "key": "email",
  9681. "description": "User email",
  9682. "required": false,
  9683. "internal": false,
  9684. "exampleValue": "myname@email.com",
  9685. "maximumLength": 100
  9686. },
  9687. {
  9688. "key": "local",
  9689. "description": "Specify if the user should be authenticated from SonarQube server or from an external authentication system. Password should not be set when local is set to false.",
  9690. "since": "6.3",
  9691. "required": false,
  9692. "internal": false,
  9693. "defaultValue": "true",
  9694. "possibleValues": [
  9695. "true",
  9696. "false",
  9697. "yes",
  9698. "no"
  9699. ]
  9700. },
  9701. {
  9702. "key": "login",
  9703. "description": "User login",
  9704. "required": true,
  9705. "internal": false,
  9706. "exampleValue": "myuser",
  9707. "maximumLength": 255
  9708. },
  9709. {
  9710. "key": "name",
  9711. "description": "User name",
  9712. "required": true,
  9713. "internal": false,
  9714. "exampleValue": "My Name",
  9715. "maximumLength": 200
  9716. },
  9717. {
  9718. "key": "password",
  9719. "description": "User password. Only mandatory when creating local user, otherwise it should not be set",
  9720. "required": false,
  9721. "internal": false,
  9722. "exampleValue": "mypassword"
  9723. },
  9724. {
  9725. "key": "scmAccount",
  9726. "description": "SCM accounts. To set several values, the parameter must be called once for each value.",
  9727. "required": false,
  9728. "internal": false,
  9729. "exampleValue": "scmAccount=firstValue&scmAccount=secondValue&scmAccount=thirdValue"
  9730. },
  9731. {
  9732. "key": "scmAccounts",
  9733. "description": "This parameter is deprecated, please use 'scmAccount' instead",
  9734. "required": false,
  9735. "internal": false,
  9736. "exampleValue": "myscmaccount1,myscmaccount2",
  9737. "deprecatedSince": "6.1",
  9738. "deprecatedKey": "scm_accounts",
  9739. "deprecatedKeySince": "6.0"
  9740. }
  9741. ]
  9742. },
  9743. {
  9744. "key": "current",
  9745. "description": "Get the details of the current authenticated user.",
  9746. "since": "5.2",
  9747. "internal": true,
  9748. "post": false,
  9749. "hasResponseExample": true,
  9750. "changelog": [
  9751. {
  9752. "description": "showOnboardingTutorial is now returned in the response",
  9753. "version": "6.5"
  9754. }
  9755. ]
  9756. },
  9757. {
  9758. "key": "deactivate",
  9759. "description": "Deactivate a user. Requires Administer System permission",
  9760. "since": "3.7",
  9761. "internal": false,
  9762. "post": true,
  9763. "hasResponseExample": true,
  9764. "changelog": [],
  9765. "params": [
  9766. {
  9767. "key": "login",
  9768. "description": "User login",
  9769. "required": true,
  9770. "internal": false,
  9771. "exampleValue": "myuser"
  9772. }
  9773. ]
  9774. },
  9775. {
  9776. "key": "groups",
  9777. "description": "Lists the groups a user belongs to. <br/>Requires Administer System permission.",
  9778. "since": "5.2",
  9779. "internal": false,
  9780. "post": false,
  9781. "hasResponseExample": true,
  9782. "changelog": [
  9783. {
  9784. "description": "Paging response fields moved to a Paging object",
  9785. "version": "6.4"
  9786. },
  9787. {
  9788. "description": "'default' response field has been added",
  9789. "version": "6.4"
  9790. }
  9791. ],
  9792. "params": [
  9793. {
  9794. "key": "login",
  9795. "description": "A user login",
  9796. "required": true,
  9797. "internal": false,
  9798. "exampleValue": "admin"
  9799. },
  9800. {
  9801. "key": "organization",
  9802. "description": "Organization key",
  9803. "since": "6.4",
  9804. "required": false,
  9805. "internal": true,
  9806. "exampleValue": "my-org"
  9807. },
  9808. {
  9809. "key": "p",
  9810. "description": "1-based page number",
  9811. "required": false,
  9812. "internal": false,
  9813. "defaultValue": "1",
  9814. "exampleValue": "42",
  9815. "deprecatedKey": "pageIndex",
  9816. "deprecatedKeySince": "5.2"
  9817. },
  9818. {
  9819. "key": "ps",
  9820. "description": "Page size. Must be greater than 0.",
  9821. "required": false,
  9822. "internal": false,
  9823. "defaultValue": "25",
  9824. "exampleValue": "20",
  9825. "deprecatedKey": "pageSize",
  9826. "deprecatedKeySince": "5.2"
  9827. },
  9828. {
  9829. "key": "q",
  9830. "description": "Limit search to group names that contain the supplied string.",
  9831. "required": false,
  9832. "internal": false,
  9833. "exampleValue": "users"
  9834. },
  9835. {
  9836. "key": "selected",
  9837. "description": "Depending on the value, show only selected items (selected=selected), deselected items (selected=deselected), or all items with their selection status (selected=all).",
  9838. "required": false,
  9839. "internal": false,
  9840. "defaultValue": "selected",
  9841. "possibleValues": [
  9842. "all",
  9843. "deselected",
  9844. "selected"
  9845. ]
  9846. }
  9847. ]
  9848. },
  9849. {
  9850. "key": "identity_providers",
  9851. "description": "List the external identity providers",
  9852. "since": "5.5",
  9853. "internal": true,
  9854. "post": false,
  9855. "hasResponseExample": true,
  9856. "changelog": []
  9857. },
  9858. {
  9859. "key": "search",
  9860. "description": "Get a list of active users. <br/>Administer System permission is required to show the 'groups' field.<br/>When accessed anonymously, only logins and names are returned.",
  9861. "since": "3.6",
  9862. "internal": false,
  9863. "post": false,
  9864. "hasResponseExample": true,
  9865. "changelog": [
  9866. {
  9867. "description": "Paging response fields moved to a Paging object",
  9868. "version": "6.4"
  9869. },
  9870. {
  9871. "description": "Avatar has been added to the response",
  9872. "version": "6.4"
  9873. },
  9874. {
  9875. "description": "Email is only returned when user has Administer System permission",
  9876. "version": "6.4"
  9877. }
  9878. ],
  9879. "params": [
  9880. {
  9881. "key": "f",
  9882. "description": "Comma-separated list of the fields to be returned in response. All the fields are returned by default.",
  9883. "required": false,
  9884. "internal": false,
  9885. "deprecatedSince": "5.4",
  9886. "possibleValues": [
  9887. "name",
  9888. "email",
  9889. "avatart",
  9890. "scmAccounts",
  9891. "groups",
  9892. "active",
  9893. "local",
  9894. "externalIdentity",
  9895. "externalProvider"
  9896. ]
  9897. },
  9898. {
  9899. "key": "p",
  9900. "description": "1-based page number",
  9901. "required": false,
  9902. "internal": false,
  9903. "defaultValue": "1",
  9904. "exampleValue": "42",
  9905. "deprecatedKey": "pageIndex",
  9906. "deprecatedKeySince": "5.2"
  9907. },
  9908. {
  9909. "key": "ps",
  9910. "description": "Page size. Must be greater than 0 and less than 500",
  9911. "required": false,
  9912. "internal": false,
  9913. "defaultValue": "50",
  9914. "exampleValue": "20",
  9915. "deprecatedKey": "pageSize",
  9916. "deprecatedKeySince": "5.2",
  9917. "maximumValue": 500
  9918. },
  9919. {
  9920. "key": "q",
  9921. "description": "Filter on login or name.",
  9922. "required": false,
  9923. "internal": false
  9924. }
  9925. ]
  9926. },
  9927. {
  9928. "key": "skip_onboarding_tutorial",
  9929. "description": "Stores that the user has skipped the onboarding tutorial and does not want to see it after future logins.<br/>Requires authentication.",
  9930. "since": "6.5",
  9931. "internal": true,
  9932. "post": true,
  9933. "hasResponseExample": false,
  9934. "changelog": []
  9935. },
  9936. {
  9937. "key": "update",
  9938. "description": "Update a user. If a deactivated user account exists with the given login, it will be reactivated. Requires Administer System permission",
  9939. "since": "3.7",
  9940. "internal": false,
  9941. "post": true,
  9942. "hasResponseExample": true,
  9943. "changelog": [
  9944. {
  9945. "description": "User's password can only be changed using the 'change_password' action.",
  9946. "version": "5.2"
  9947. }
  9948. ],
  9949. "params": [
  9950. {
  9951. "key": "email",
  9952. "description": "User email",
  9953. "required": false,
  9954. "internal": false,
  9955. "exampleValue": "myname@email.com",
  9956. "maximumLength": 100
  9957. },
  9958. {
  9959. "key": "login",
  9960. "description": "User login",
  9961. "required": true,
  9962. "internal": false,
  9963. "exampleValue": "myuser",
  9964. "maximumLength": 255
  9965. },
  9966. {
  9967. "key": "name",
  9968. "description": "User name",
  9969. "required": false,
  9970. "internal": false,
  9971. "exampleValue": "My Name",
  9972. "maximumLength": 200
  9973. },
  9974. {
  9975. "key": "scmAccount",
  9976. "description": "SCM accounts. To set several values, the parameter must be called once for each value.",
  9977. "required": false,
  9978. "internal": false,
  9979. "exampleValue": "scmAccount=firstValue&scmAccount=secondValue&scmAccount=thirdValue"
  9980. },
  9981. {
  9982. "key": "scmAccounts",
  9983. "description": "This parameter is deprecated, please use 'scmAccount' instead",
  9984. "required": false,
  9985. "internal": false,
  9986. "exampleValue": "myscmaccount1,myscmaccount2",
  9987. "deprecatedSince": "6.1",
  9988. "deprecatedKey": "scm_accounts",
  9989. "deprecatedKeySince": "6.0"
  9990. }
  9991. ]
  9992. }
  9993. ]
  9994. },
  9995. {
  9996. "path": "api/webhooks",
  9997. "since": "6.2",
  9998. "description": "Webhooks allow to notify external services when a project analysis is done",
  9999. "actions": [
  10000. {
  10001. "key": "deliveries",
  10002. "description": "Get the recent deliveries for a specified project or Compute Engine task.<br/>Require 'Administer' permission on the related project.<br/>Note that additional information are returned by api/webhooks/delivery.",
  10003. "since": "6.2",
  10004. "internal": false,
  10005. "post": false,
  10006. "hasResponseExample": true,
  10007. "changelog": [],
  10008. "params": [
  10009. {
  10010. "key": "ceTaskId",
  10011. "description": "Id of the Compute Engine task",
  10012. "required": false,
  10013. "internal": false,
  10014. "exampleValue": "AU-Tpxb--iU5OvuD2FLy"
  10015. },
  10016. {
  10017. "key": "componentKey",
  10018. "description": "Key of the project",
  10019. "required": false,
  10020. "internal": false,
  10021. "exampleValue": "my-project"
  10022. }
  10023. ]
  10024. },
  10025. {
  10026. "key": "delivery",
  10027. "description": "Get a webhook delivery by its id.<br/>Require 'Administer System' permission.<br/>Note that additional information are returned by api/webhooks/delivery.",
  10028. "since": "6.2",
  10029. "internal": false,
  10030. "post": false,
  10031. "hasResponseExample": true,
  10032. "changelog": [],
  10033. "params": [
  10034. {
  10035. "key": "deliveryId",
  10036. "description": "Id of delivery",
  10037. "required": true,
  10038. "internal": false,
  10039. "exampleValue": "AU-TpxcA-iU5OvuD2FL3"
  10040. }
  10041. ]
  10042. }
  10043. ]
  10044. },
  10045. {
  10046. "path": "api/webservices",
  10047. "since": "4.2",
  10048. "description": "Get information on the web api supported on this instance.",
  10049. "actions": [
  10050. {
  10051. "key": "list",
  10052. "description": "List web services",
  10053. "since": "4.2",
  10054. "internal": false,
  10055. "post": false,
  10056. "hasResponseExample": true,
  10057. "changelog": [],
  10058. "params": [
  10059. {
  10060. "key": "include_internals",
  10061. "description": "Include web services that are implemented for internal use only. Their forward-compatibility is not assured",
  10062. "required": false,
  10063. "internal": false,
  10064. "defaultValue": "false",
  10065. "possibleValues": [
  10066. "true",
  10067. "false",
  10068. "yes",
  10069. "no"
  10070. ]
  10071. }
  10072. ]
  10073. },
  10074. {
  10075. "key": "response_example",
  10076. "description": "Display web service response example",
  10077. "since": "4.4",
  10078. "internal": false,
  10079. "post": false,
  10080. "hasResponseExample": true,
  10081. "changelog": [],
  10082. "params": [
  10083. {
  10084. "key": "action",
  10085. "description": "Action of the web service",
  10086. "required": true,
  10087. "internal": false,
  10088. "exampleValue": "search"
  10089. },
  10090. {
  10091. "key": "controller",
  10092. "description": "Controller of the web service",
  10093. "required": true,
  10094. "internal": false,
  10095. "exampleValue": "api/issues"
  10096. }
  10097. ]
  10098. }
  10099. ]
  10100. },
  10101. {
  10102. "path": "batch",
  10103. "since": "4.4",
  10104. "description": "Get JAR files and referentials for batch",
  10105. "actions": [
  10106. {
  10107. "key": "file",
  10108. "description": "Download a JAR file listed in the index (see batch/index)",
  10109. "since": "4.4",
  10110. "internal": true,
  10111. "post": false,
  10112. "hasResponseExample": true,
  10113. "changelog": [],
  10114. "params": [
  10115. {
  10116. "key": "name",
  10117. "description": "File name",
  10118. "required": false,
  10119. "internal": false,
  10120. "exampleValue": "batch-library-2.3.jar"
  10121. }
  10122. ]
  10123. },
  10124. {
  10125. "key": "index",
  10126. "description": "List the JAR files to be downloaded by scanners",
  10127. "since": "4.4",
  10128. "internal": true,
  10129. "post": false,
  10130. "hasResponseExample": true,
  10131. "changelog": []
  10132. },
  10133. {
  10134. "key": "issues",
  10135. "description": "Return open issues",
  10136. "since": "5.1",
  10137. "internal": true,
  10138. "post": false,
  10139. "hasResponseExample": true,
  10140. "changelog": [],
  10141. "params": [
  10142. {
  10143. "key": "branch",
  10144. "description": "Branch key",
  10145. "since": "6.6",
  10146. "required": false,
  10147. "internal": false,
  10148. "exampleValue": "feature/my_branch"
  10149. },
  10150. {
  10151. "key": "key",
  10152. "description": "Project, module or file key",
  10153. "required": true,
  10154. "internal": false,
  10155. "exampleValue": "my_project"
  10156. }
  10157. ]
  10158. },
  10159. {
  10160. "key": "project",
  10161. "description": "Return project repository",
  10162. "since": "4.5",
  10163. "internal": true,
  10164. "post": false,
  10165. "hasResponseExample": true,
  10166. "changelog": [],
  10167. "params": [
  10168. {
  10169. "key": "branch",
  10170. "description": "Branch key",
  10171. "since": "6.6",
  10172. "required": false,
  10173. "internal": false,
  10174. "exampleValue": "feature/my_branch"
  10175. },
  10176. {
  10177. "key": "issues_mode",
  10178. "description": "Issues mode or not",
  10179. "required": false,
  10180. "internal": false,
  10181. "defaultValue": "false",
  10182. "possibleValues": [
  10183. "true",
  10184. "false",
  10185. "yes",
  10186. "no"
  10187. ]
  10188. },
  10189. {
  10190. "key": "key",
  10191. "description": "Project or module key",
  10192. "required": true,
  10193. "internal": false,
  10194. "exampleValue": "my_project"
  10195. },
  10196. {
  10197. "key": "profile",
  10198. "description": "Profile name",
  10199. "required": false,
  10200. "internal": false,
  10201. "exampleValue": "SonarQube Way"
  10202. }
  10203. ]
  10204. }
  10205. ]
  10206. }
  10207. ]
  10208. }